Spinner
Carregador
Um spinner roda sem parar para mostrar que há trabalho acontecendo quando não existe um número de conclusão útil.
Um exemplo real
Durante uma busca rápida, um pequeno indicador de carregamento aparece no campo. Os resultados ou um erro o substituem.
Partes principais
- 01State signal
- 02Human-readable message
- 03Timing or progress
- 04Recovery path
Use-o quando
Use-o para uma pequena espera com tempo desconhecido quando você não puder prever o layout do conteúdo.
Não o use quando
Evite quando for possível medir o progresso ou o formato do conteúdo já for conhecido. Explique esperas longas em vez de bloquear a página inteira.
Nome usado no código
aria-busy + animated indicator 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 Carregador (Spinner). User context: Durante uma busca rápida, um pequeno indicador de carregamento aparece no campo. Os resultados ou um erro o substituem. Recommended pattern: Carregador (Spinner). Why it fits: Use-o para uma pequena espera com tempo desconhecido quando você não puder prever o layout do conteúdo. Do not use it when: Evite quando for possível medir o progresso ou o formato do conteúdo já for conhecido. Explique esperas longas em vez de bloquear a página inteira. 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 Carregador (Spinner) is used now. Definition: Um spinner roda sem parar para mostrar que há trabalho acontecendo quando não existe um número de conclusão útil. 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.