SearchBox controle (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Controle usado para criar uma experiência de pesquisa.

Descrição

Uma caixa de pesquisa (SearchBox) fornece um campo de entrada para pesquisar itens específicos em um site ou aplicativo.

Esse componente de código fornece um wrapper para o controle SearchBox da interface do usuário do Fluent para uso em telas e páginas personalizadas.

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Principais propriedades

Propriedade	Description
SearchText	Texto inserido pelo usuário. Consulte isso como a entrada para funções de pesquisa.
IconName	Nome do ícone da interface do usuário do Fluent (consulte Ícones da interface do usuário do Fluent).
Underlined	Se a SearchBox está sublinhada ou não.
DisableAnimation	Se o ícone SearchBox deve ou não ser animado quando em foco.
PlaceholderText	Espaço reservado para a caixa de pesquisa.

Propriedades adicionais

Propriedade	Description
Theme	O objeto Tema (não formatado em Json). Consulte os temas para obter orientação sobre como configurar.
AccessibilityLabel	Rótulo aria do leitor de tela.
InputEvent	Um evento para enviar ao controle. Por exemplo, SetFocus.

Exemplo

Configurar comportamento de pesquisa

Adicione esse controle ao seu aplicativo onde precisar de uma interface de pesquisa, geralmente combinada a uma galeria, DetailsList ou algum controle que pode exibir um conjunto de dados.

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

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

Limitações

Esse componente de código só pode ser usado em aplicativos de tela e páginas personalizadas.