Pesquisa: Especificações
O componente de pesquisa permite que as pessoas insiram uma palavra-chave ou frase para encontrar informações relevantes.
Variantes
| Variante | M3 | M3 Expressive |
|---|---|---|
| Pesquisa | Disponível | Disponível |
Configurações
Estilo
O componente de pesquisa está disponível em dois estilos:
- Contido: Apresenta aparência e comportamento expressivos. Usa um contêiner preenchido para separar a barra de pesquisa de uma lista de sugestões ou resultados
- Dividido (baseline): Não inclui o estilo visual, o movimento nem a flexibilidade mais recentes


Layout
As sugestões e os resultados da pesquisa são exibidos em listas personalizáveis, com duas opções de layout: tela cheia ou ancorado. Mais sobre layouts de pesquisa




| Categoria | Configuração | M3 | M3 Expressive |
|---|---|---|---|
| Estilo | Contido | -- | Disponível |
| Dividido | Disponível | Não recomendado. Use o estilo contido. | |
| Layout | Ancorado, tela cheia | Disponível | Disponível |
Tokens e especificações
Use o menu da tabela para escolher um conjunto de tokens. O conjunto search bar contém somente os tokens da barra de pesquisa sem foco. O conjunto search view contém todos os demais tokens usados na interação com a pesquisa, abrangendo todos os estilos e layouts. Saiba mais sobre tokens de design
Pesquisa - Visualização
| Token | Valor |
|---|---|
| Search view container surface tint layer color | #6750A4 |
Pesquisa - Barra
Anatomia
O componente de pesquisa inclui uma barra de pesquisa e um contêiner para sugestões e resultados. Por padrão, o contêiner fica vazio. Use o componente lista para adicionar conteúdo. No estilo dividido (baseline), um divisor separa a barra de pesquisa dos resultados.

- Contêiner da barra de pesquisa
- Ícone inicial
- Texto de apoio
- Ícone final e avatar (opcional)
- Texto inserido
- Contêiner para sugestões ou resultados de pesquisa
Exemplos
- Com avatar
- Com um botão de ícone final
- Com dois botões de ícone finais
- Com botão de ícone final e avatar

Cor
Os valores de cor são implementados por meio de tokens de design. Para designers, isso significa trabalhar com valores de cor associados a tokens. Na implementação, um valor de cor é representado por um token que referencia um valor.
Layout de tela cheia

Funções de cor da pesquisa em tela cheia usadas nos temas claro e escuro:
- Surface container low
- On surface variant
- On surface variant
- Surface container high
- On surface variant
- On surface
Layout ancorado

Funções de cor da pesquisa ancorada usadas nos temas claro e escuro:
- Surface container high
- On surface variant
- On surface variant
- Surface container high
- On surface variant
- On surface
Estados
Estados são representações visuais que comunicam o status de um componente ou de um elemento interativo. Na pesquisa com foco, cada elemento mantém seus próprios estados de interação. Saiba mais sobre estados de interação
Barra de pesquisa

- Habilitado
- Com o cursor sobre o elemento
- Com foco
- Pressionado (efeito ripple)
Sugestões e resultados de pesquisa
O componente de pesquisa inclui um contêiner para sugestões e resultados. Por padrão, o contêiner fica vazio. Use o componente lista para adicionar conteúdo.

- Habilitado
- Com o cursor sobre o elemento
- Com foco
- Pressionado (efeito ripple)
Medidas
Barra de pesquisa


No M3 Expressive, a barra de pesquisa se expande ao receber foco. As margens passam de 24dp para 12dp.


| Elemento | Atributo | Valor |
|---|---|---|
| Contêiner | Largura | Mín.: 360dp, máx.: 720dp |
| Altura | 56dp | |
| Alinhamento do rótulo | Alinhado ao início | |
| Espaçamento interno inicial | Sem foco: 24dp, com foco: 12dp | |
| Espaçamento interno final | Sem foco: 24dp, com foco: 12dp | |
| Espaçamento interno entre o ícone inicial e o rótulo (a partir da área de toque) | 4dp | |
| Espaçamento interno entre o rótulo e o ícone final (a partir da área de toque) | 4dp | |
| Avatar | Tamanho | 30dp |
Pesquisa com foco
Estilo contido


| Elemento | Atributo | Valor |
|---|---|---|
| Contêiner de tela cheia | Largura | Largura total |
| Altura | Altura total | |
| Contêiner ancorado | Largura | Mín.: 360dp, máx.: 720dp |
| Altura | Mín.: 240dp, máx.: 2/3 da altura da tela | |
| Contêiner da barra de pesquisa | Altura | 56dp |
| Alinhamento do rótulo | Alinhado ao início | |
| Espaçamento interno inicial | 16dp | |
| Espaçamento interno final | 16dp | |
| Espaçamento interno entre o ícone inicial e o rótulo (a partir da área de toque) | 4dp | |
| Espaçamento interno entre o rótulo e o ícone final (a partir da área de toque) | 4dp |
Estilo dividido

