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.
Description
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
- Esta é uma funcionalidade de pré-visualização.
- A versão prévia dos recursos não foi criada para uso em ambientes de produção e pode ter funcionalidade restrita. Esses recursos estão disponíveis antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer 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 |
aria-label do leitor de tela. |
InputEvent |
Um evento para enviar ao controle. Por exemplo, SetFocus. |
Example
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 canvas e páginas personalizadas.