Progress Indicator
Indicador de progresso
Um indicador de progresso mostra que o trabalho ainda está acontecendo. Uma barra ou um anel mostra um progresso conhecido. Um spinner significa que o tempo de espera é desconhecido.
Um exemplo real
Um upload de 400 MB mostra 62% e o tempo restante. Uma busca rápida com tempo desconhecido usa um pequeno spinner.
Partes principais
- 01State signal
- 02Human-readable message
- 03Timing or progress
- 04Recovery path
Use-o quando
Use uma barra com um ponto final sempre que você puder medir o trabalho.
Não o use quando
Nunca mostre um spinner infinito sem explicação, sem forma de cancelar e sem estado de falha.
Nome usado no código
<progress> / aria-busy 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 Indicador de progresso (Progress Indicator). User context: Um upload de 400 MB mostra 62% e o tempo restante. Uma busca rápida com tempo desconhecido usa um pequeno spinner. Recommended pattern: Indicador de progresso (Progress Indicator). Why it fits: Use uma barra com um ponto final sempre que você puder medir o trabalho. Do not use it when: Nunca mostre um spinner infinito sem explicação, sem forma de cancelar e sem estado de falha. 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): Nenhum padrão oficial único controla todo o termo. Seu significado pode mudar entre equipes, plataformas ou frameworks. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Conferir este pedido
Review how Indicador de progresso (Progress Indicator) is used now. Definition: Um indicador de progresso mostra que o trabalho ainda está acontecendo. Uma barra ou um anel mostra um progresso conhecido. Um spinner significa que o tempo de espera é desconhecido. 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.