Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
[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 | Descrição |
|---|---|
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 | Descrição |
|---|---|
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.