Progressbar
Barra di progresso
Una barra di avanzamento mostra quanto di un compito a tempo è stato completato. Le persone possono leggerla ma non controllarla direttamente.
Un esempio vero
Durante il caricamento di un file di 2,4 GB, la barra annuncia “Caricamento, 68 percento” e si aggiorna solo quando utile. Mostra una quantità sconosciuta mentre il server verifica il file. Annulla rimane un pulsante separato.
Parti principali
- 01Etichetta del compito
- 02Traccia e riempi
- 03Valore corrente
Usalo quando
Mostra un numero quando il lavoro totale è noto. Se non è noto, etichetta quello stato e spiega cosa sta succedendo ora.
Non usarlo quando
Non rendere un progressbar selezionabile o regolabile. Usa un cursore quando la persona controlla il valore.
Nome usato nel codice
role=progressbar with aria-valuemin/max/now and accessible name Prima di spedire
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 di progresso (Progressbar). User context: Durante il caricamento di un file di 2,4 GB, la barra annuncia “Caricamento, 68 percento” e si aggiorna solo quando utile. Mostra una quantità sconosciuta mentre il server verifica il file. Annulla rimane un pulsante separato. Recommended pattern: Barra di progresso (Progressbar). Why it fits: Mostra un numero quando il lavoro totale è noto. Se non è noto, etichetta quello stato e spiega cosa sta succedendo ora. Do not use it when: Non rendere un progressbar selezionabile o regolabile. Usa un cursore quando la persona controlla il valore. 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): Lo standard copre solo l'ambito elencato. Non sceglie lo stile visivo, la decisione sul prodotto o l'esempio di vocabolario. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Controlla questa richiesta
Review how Barra di progresso (Progressbar) is used now. Definition: Una barra di avanzamento mostra quanto di un compito a tempo è stato completato. Le persone possono leggerla ma non controllarla direttamente. 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.