Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
[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 | Descrição |
|---|---|
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 | Descrição |
|---|---|
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.