Controllo SearchBox (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.