Seleciona o idioma
Selecionar outros idiomas

Tradução automática

Carregando tradutor…

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

Carregamento e progresso

Comunica espera e avanço de operações, distinguindo duração desconhecida, progresso mensurável, conclusão e falha.

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 uma operação exigir espera. Mostre progresso determinado somente quando houver uma medida real de avanço.

O que desenhar

Mostre o que está acontecendo, área afetada, espera, progresso, sucesso, falha e ações de recuperação.

Como se comporta

Atualizações mantêm o foco previsível. Conclusão, falha e cancelamento encerram o estado de espera com um retorno compreensível.

O que documentar no Figma

Defina o que o progresso mede, o que fica disponível durante a espera e o efeito de cancelar ou tentar novamente.

Como revisar

Confira mensagens e estados no desenho. Na implementação, verifique atualização, foco, anúncios e preferência de movimento reduzido.

Espera e medida de avanço

Disponibilidade e continuidade

Encerramento e recuperação

Métodos de Interação

Mouse, toque e teclado

O indicador apenas informativo é acompanhado pela leitura da mensagem e do progresso, sem precisar clicar nele. Clicar ou tocar em Cancelar ou Tentar novamente executa essa ação quando disponível.

Tab e Shift + Tab percorrem os controles disponíveis; Enter ou Espaço no botão Cancelar ou Tentar novamente executa a ação. Atualizações de progresso mantêm o foco na tarefa; o indicador estático não cria uma parada de foco.

Leitores de tela

Usar os comandos de leitura do leitor de telas permite identificar a operação e o valor quando determinado. Em progresso indeterminado, a pessoa identifica a espera sem receber um percentual fictício.

Ao iniciar ou encerrar a operação, a pessoa percebe a mensagem de andamento, conclusão ou falha sem deslocar o foco para a barra. Para recuperar uma falha, navega até Tentar novamente e ativa o botão.

Com leitor de telas no celular, deslizar o dedo percorre mensagens e controles no modo padrão; tocar duas vezes ativa Cancelar ou Tentar novamente quando disponível.

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 Carregamento e progresso

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

Progresso com total desconhecido

Conclusão real

Falha e recuperação

Foco durante atualizações

Pontos de atenção

Progresso de uma operação é diferente de indicador de etapas de uma jornada. Etapas concluídas não representam necessariamente uma porcentagem de tempo restante.

Respeite a preferência por movimento reduzido e preserve um retorno textual quando reduzir animações. Evite efeitos intermitentes.

Skeleton e spinner não substituem mensagens de erro, conclusão ou indisponibilidade. Evite uma espera que nunca apresenta desfecho.

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

O indicador informativo não precisa receber foco. Cancelar e Tentar novamente, quando disponíveis, seguem o comportamento de botões e entram na ordem de Tab.

Não mova o foco a cada atualização. Se um controle focado for removido no encerramento, encaminhe o foco para um destino coerente e documentado.

A barra de progresso precisa de nome e valor quando determinado. Em progresso indeterminado, não exponha um valor numérico falso. Prefira progress nativo quando adequado.

Comunique início e desfecho e, se necessário, marcos relevantes. Uma progressbar não garante anúncio automático de cada mudança; evite forçar anúncios para cada percentual.

Se usar aria-busy em uma região atualizada, volte o estado para falso ao concluir ou falhar. Mantenha a mensagem de status perceptível, inclusive quando a região estiver ocupada.

Referências

Referências adicionais sobre componentes do tipo Carregamento e progresso.

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.

Carbon — Progress bar (link externo, abre em uma nova aba)

MDN — progress (link externo, abre em uma nova aba)

W3C WAI — Status messages (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).