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
- As sugestões são valores obrigatórios ou a pessoa pode confirmar um texto que não aparece na lista? Essa regra está disponível antes do preenchimento?
- Este guia adota combobox editável com lista de sugestões e confirmação explícita. A seleção múltipla é outro padrão, discutido no componente Select.
- A busca começa ao focar, digitar ou atingir uma quantidade mínima de caracteres? A interface explica quando é preciso digitar mais?
Opções e estados
- É possível distinguir texto digitado, opção ativa e valor confirmado? Sugestões com nomes semelhantes têm contexto suficiente para a escolha?
- Carregamento, ausência de sugestões e falha têm mensagens diferentes? Uma falha preserva a entrada e permite tentar novamente?
- A lista permanece utilizável com teclado virtual, ampliação e rótulos longos? A opção ativa continua visível durante a rolagem?
Confirmar e cancelar
- O que acontece ao clicar em uma sugestão, pressionar
Enter, sair comTabou fechar comEsc? No padrão deste guia,Escfecha sem confirmar a opção apenas percorrida. - Depois de confirmar, editar o texto invalida a escolha anterior? Documente a relação entre o texto exibido e o identificador salvo.
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
- QUANDO uso
Tabpara focar o campo e digito um termo com sugestões - VEJO o foco e consigo percorrer sugestões com
setassem impedir a edição nativa do texto - ENTÃO, quando pressiono
Enter, VEJO o valor confirmado; ao pressionarEscantes de confirmar, VEJO a lista fechar sem salvar a opção apenas percorrida
Leitor de telas para desktop
- QUANDO navego até o combobox editável com leitor de telas no computador
- OUÇO seu rótulo, estado de expansão e as sugestões ativas durante a navegação
- ENTÃO, quando confirmo uma sugestão, OUÇO ou percebo o valor confirmado e o fechamento da lista conforme o padrão definido
Leitor de telas para dispositivos móveis
- QUANDO foco o campo com leitor de telas no celular e digito um termo
- OUÇO ou percebo a disponibilidade das sugestões e consigo explorá-las pelos gestos da plataforma
- ENTÃO, quando aciono uma sugestão, OUÇO ou percebo o valor confirmado sem depender apenas do destaque visual
Cenários complementares — ampliação editorial
Percorrer sem confirmar
- DADAS sugestões disponíveis
- QUANDO percorro com
setase pressionoEsc - ENTÃO a lista fecha sem salvar a sugestão apenas percorrida e posso continuar editando.
Confirmar uma opção
- DADA uma opção ativa
- QUANDO pressiono
Enterou a aciono por toque - ENTÃO o campo apresenta o valor confirmado e a lista fecha conforme a regra documentada.
Respostas fora de ordem
- DADAS consultas sucessivas
- QUANDO a resposta antiga chega após a mais recente
- ENTÃO ela não substitui as sugestões atuais nem altera o valor confirmado.
Sem correspondência em entrada restrita
- DADA entrada restrita às opções
- QUANDO tento confirmar um texto sem correspondência
- ENTÃO recebo orientação associada ao campo, o texto é preservado e nenhum identificador antigo é enviado como se fosse a nova escolha.
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.