Progressbar
Barra de progresso
Uma barra de progresso mostra quanto de uma tarefa cronometrada foi concluída. As pessoas podem lê-la, mas não a controlam diretamente.
Um exemplo real
Enquanto um arquivo de 2,4 GB é carregado, a barra anuncia “Carregando, 68 por cento” e atualiza somente quando é útil. Mostra uma quantidade desconhecida enquanto o servidor verifica o arquivo. Cancelar permanece como um botão separado.
Partes principais
- 01Etiqueta da tarefa
- 02Rastrear e preencher
- 03Valor atual
Use-o quando
Mostre um número quando o trabalho total for conhecido. Se for desconhecido, rotule esse estado e explique o que está acontecendo agora.
Não o use quando
Não torne a barra de progresso focável ou ajustável. Use um controle deslizante quando a pessoa controlar o valor.
Nome usado no código
role=progressbar with aria-valuemin/max/now and accessible name Antes de lançar
Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states.
Outcome: Complete the task with Barra de progresso (Progressbar). User context: Enquanto um arquivo de 2,4 GB é carregado, a barra anuncia “Carregando, 68 por cento” e atualiza somente quando é útil. Mostra uma quantidade desconhecida enquanto o servidor verifica o arquivo. Cancelar permanece como um botão separado. Recommended pattern: Barra de progresso (Progressbar). Why it fits: Mostre um número quando o trabalho total for conhecido. Se for desconhecido, rotule esse estado e explique o que está acontecendo agora. Do not use it when: Não torne a barra de progresso focável ou ajustável. Use um controle deslizante quando a pessoa controlar o valor. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): O padrão cobre apenas o escopo listado. Ele não escolhe o estilo visual, decisão do produto ou exemplo de Vibulary. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Barra de progresso (Progressbar) is used now. Definition: Uma barra de progresso mostra quanto de uma tarefa cronometrada foi concluída. As pessoas podem lê-la, mas não a controlam diretamente. Release checks: Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.