Seleciona o idioma
Selecionar outros idiomas

Tradução automática

Carregando tradutor…

Magoofaça seus componentes funcionarem corretamenteVoltar para página principal

Autocomplete

Oferece sugestões durante a digitação, distinguindo texto em edição, opção ativa e valor confirmado.

Para ver exemplos funcionais e padrões de design deste componente, consulte a aba de referências (abre as referências na mesma página).

GUIA DO COMPONENTE

Explore os comportamentos antes de definir a interface.

Guia rápido para designers

Quando usar

Use quando sugestões ajudarem a encontrar ou preencher um valor. Para poucas opções visíveis, avalie um controle mais simples.

O que desenhar

Mostre rótulo, campo, lista de sugestões, opção ativa, valor confirmado, carregamento, ausência de opções e falha.

Como se comporta

Digitar solicita sugestões. Percorrer opções não precisa confirmar uma escolha; Enter confirma conforme o padrão documentado.

O que documentar no Figma

Defina entrada livre ou restrita, gatilho da consulta, confirmação, cancelamento e efeito de sair do campo.

Como revisar

Confira os estados no desenho. Na implementação, verifique edição, opção ativa e confirmação com teclado e leitores de tela.

Escolher o comportamento

Opções e estados

Confirmar e cancelar

Métodos de Interação

Mouse e toque

Clicar ou tocar em uma sugestão confirma seu valor. A lista não deve desaparecer antes que o acionamento seja concluído.

Teclado

Tab entra no campo. Digitação, seleção, copiar e colar mantêm os comandos nativos de edição.

Com a lista aberta, setas para baixo e para cima percorrem sugestões; Enter confirma a opção ativa; Esc fecha a lista sem confirmar uma opção apenas percorrida.

Tab sai do campo sem percorrer cada sugestão. Neste padrão de confirmação explícita, sair não confirma automaticamente a opção ativa.

Leitores de tela

Ao focar o campo com leitor de telas, a pessoa identifica seu nome e se as sugestões estão abertas. Usar setas para cima ou para baixo percorre as opções e permite identificar a opção ativa; Enter confirma.

Com leitor de telas no celular, a pessoa digita pelo teclado virtual, percorre sugestões com os gestos de navegação do leitor e toca duas vezes na opção focada para confirmar. A lista pode informar a quantidade ou ausência de sugestões após a resposta.

Gherkin

Metodologia BDD (Behavior-Driven Development ou Desenvolvimento Orientado ao Comportamento) com foco em 3 pilares: Histórias de Usuário, Critérios de Aceite e Sintaxes Gherkin (Dado (Given), Quando (When), Então (Then)).

Cenário: Considerando que estou em uma página que contém Autocomplete

Cenários educacionais para orientar a revisão do comportamento. Devem ser adaptados ao contexto e executados na implementação; a presença deste texto não significa que os testes foram realizados.

Navegação por teclado

Leitor de telas para desktop

Leitor de telas para dispositivos móveis

Cenários complementares — ampliação editorial

Percorrer sem confirmar

Confirmar uma opção

Respostas fora de ordem

Sem correspondência em entrada restrita

Pontos de atenção

Autocomplete de sugestões é diferente do atributo HTML autocomplete, que fornece informações ao navegador sobre preenchimento automático.

Não coloque links ou botões acionáveis dentro de opções de uma listbox. Conteúdo com ações independentes exige outro padrão.

Cancelamento de requisições e descarte de respostas antigas precisam ser implementados. O desenho documenta a intenção, mas não comprova esse funcionamento.

Notas de implementação e decisões de comportamento

Exponha nome, estado de expansão e relação com a lista. No modelo com aria-activedescendant, o foco DOM permanece no campo e a opção ativa precisa existir e estar identificada na lista.

A quantidade ou ausência de sugestões pode ser comunicada após a resposta, sem anunciar cada tecla. Verifique também exploração e confirmação com leitor de telas no celular.

Referências

Referências adicionais sobre componentes do tipo Autocomplete.

Importante:
A maior parte das referências estão na plataforma do curso junto com as aulas citadas neste material.

Isenção de responsabilidade:
Os links indicados aqui não são recomendações, mas apenas uma curadoria de referências onde você pode encontrar componentes construídos. É importante ressaltar que não há uma unificação nos formatos de construção e não há garantias de que os links mencionados aqui cumpram todos os padrões de design. Dúvidas devem ser direcionadas para as respectivas equipes envolvidas nas construções dos materiais indicados. Antes de "copiar" algum modelo apresentado, leve em consideração que todos os materiais são atualizados constantemente e que os padrões (principalmente proprietários) podem sofrer alterações.

Referências técnicas e exemplos consultados para esta adaptação editorial. Cada fonte conserva seu escopo; consultar um exemplo não comprova a acessibilidade de outra implementação.

W3C APG — Combobox (link externo, abre em uma nova aba)

W3C APG — Listbox (link externo, abre em uma nova aba)

Conteúdo autoral de Marcelo Sales, originalmente utilizado nas aulas do curso AccessBoost (link externo - abre em uma nova janela). As interações representam o formato padrão da indústria, mas em casos específicos podem ser customizadas (desde que haja instruções suficientes para que as pessoas compreendam a mudança de comportamento).