SearchBox controllo (anteprima)
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
Un controllo utilizzato per creare un'esperienza di ricerca.
Descrizione
Una casella di ricerca (SearchBox) fornisce un campo di input per la ricerca all'interno di un sito o di un'app per trovare elementi specifici.
Questo componente di codice fornisce un wrapper attorno al comando SearchBox dell'interfaccia utente Fluent per l'utilizzo in app canvas e pagine personalizzate.
Importante
- Questa è una funzionalità di anteprima.
- Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.
Proprietà chiave
| Proprietà | Descrizione |
|---|---|
SearchText |
Testo inserito dall'utente. Fare riferimento a questo come input per le funzioni di ricerca. |
IconName |
Nome dell'icona dell'interfaccia utente Fluent (vedi Icone dell'interfaccia utente Fluent). |
Underlined |
Se SearchBox è sottolineato o meno. |
DisableAnimation |
Se abilitare o meno l'icona SearchBox sullo stato attivo. |
PlaceholderText |
Segnaposto per la casella di ricerca. |
Proprietà aggiuntive
| Proprietà | Descrizione |
|---|---|
Theme |
L'oggetto Tema (non formattato Json). Vedi la creazione di temi per istruzioni su come eseguire la configurazione. |
AccessibilityLabel |
Etichetta aria per utilità per la lettura dello schermo. |
InputEvent |
Evento da inviare al controllo. Ad esempio, SetFocus. |
Esempio
Configura il comportamento della ricerca
Aggiungi questo controllo alla tua app laddove hai bisogno di un'interfaccia di ricerca, in genere associata a una raccolta, DetailsList, o un qualsiasi controllo in grado di visualizzare un set di dati.
Crea un'esperienza di ricerca utilizzando le espressioni Search() o Filter() che utilizzano il valore della proprietà SearchText nella SearchBox.
Search( Accounts, SearchBox.SearchText, "name" )
Limiti
Questo componente di codice può essere usato solo nelle app canvas e nelle pagine personalizzate.