SearchBox controlo (pré-visualização)

[Este artigo inclui documentação pré-versão e está sujeito a alterações.]

Um controlo utilizado para criar uma experiência de pesquisa.

Descrição

Uma caixa de pesquisa (SearchBox) fornece um campo de entrada para pesquisar num site ou numa aplicação para encontrar itens específicos.

Este componente de código fornece um wrapper em torno do controlo SearchBox da Fluent UI para utilização em telas e páginas personalizadas.

Importante

• Esta é uma funcionalidade de pré-visualização.
• As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Propriedades chave

Property	Description
SearchText	Texto que é introduzido pelo utilizador. Consulte isto como a entrada para as funções de pesquisa.
IconName	Nome do ícone da Fluent UI (consulte Ícones da Fluent UI).
Underlined	Se SearchBox está sublinhado ou não.
DisableAnimation	Se animar ou não o ícone de SearchBox quando em foco.
PlaceholderText	Marcador de posição para a caixa de pesquisa.

Propriedades adicionais

Property	Description
Theme	O objeto de Tema (não formatado por JSON). Consulte personalizar o tema para obter orientações sobre como configurar.
AccessibilityLabel	Etiqueta aria de leitor de ecrã.
InputEvent	Um evento a enviar ao controlo. Por exemplo, SetFocus.

Exemplo

Configurar comportamento de pesquisa

Adicione este controlo à aplicação onde é necessário uma interface de pesquisa, normalmente, aliada a uma galeria, DetailsList, ou qualquer controlo que possa apresentar um conjunto de dados.

Crie uma experiência de pesquisa utilizando as expressões Search() ou Filter() que utilizam o valor da propriedade SearchText no SearchBox.

Search( Accounts, SearchBox.SearchText, "name" )

Limitações

Este componente de código só pode ser utilizado em aplicações de tela e páginas personalizadas.