Progress
Barra de progreso determinada (con data-ts-value) o indeterminada (is-indeterminate, animación continua) para mostrar el avance de una tarea. Tiene tamaños, variantes de color y aria-label como nombre accesible. También se parte en tramos (is-steps, is-stacked) para cuotas, o se dibuja como anillo (shape-circle).
Avisos y estado · TaishoDS Core, en HTML plano.
Ejemplos
Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.
Barra con etiqueta
Variante de éxito
Indeterminada
Por pasos
Por segmentos
Circular con valor
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Tamaño
El grosor de la barra: sm, md o lg.
Variante
El color de la barra: default o el semántico (success, danger, brand…).
Por tramos
is-steps: la barra en N tramos iguales; is-filled marca los llenos (3 de 5 asientos).
Segmentos
is-stacked: varios valores de distinto color en una sola barra (usado y reservado).
Forma
shape-circle: el progreso en un anillo; el size es el diámetro.
Estados
is-indeterminate para progreso desconocido (animación continua).
Combinaciones
Tamaño y color actuando juntos.
Cuándo usarlo
- Se sabe cuánto falta y se puede expresar como porcentaje: una subida, un import, un paso 3 de 5.
- La espera es larga y ver el avance evita que el usuario abandone.
- Se busca mostrar una proporción de algo completado (cuota, checklist).
- Es una cuota por tramos:
is-stepspara "3 de 5 asientos",is-stackedpara usado y reservado del plan. - El espacio es chico o cuadrado (una celda, una tarjeta):
shape-circle.
Cuándo no
- La espera es corta y no se sabe cuánto falta →
spinner. - Es actividad discreta dentro de un texto o un botón →
loading-dots. - Se está cargando contenido que va a ocupar lugar →
skeleton.
Cómo usarlo
- Conviene darle
aria-label: es el nombre accesible de la barra. - Si no se puede calcular el avance real, se usa
is-indeterminateen vez de inventar un número. - Con
is-stacked, la leyenda de colores va al lado: el color solo no alcanza para distinguir los tramos.
Cómo no usarlo
- No se falsea el progreso: una barra que salta al 90% y se queda ahí es peor que ninguna.
- No se usa una barra para una espera de medio segundo: parpadea y molesta.
Relacionados
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
El ancho del relleno es un valor continuo: lo lee la hoja de estilos desde --ts-progress-value (por defecto 0 %) y esa variable la escribe el Core. Hasta que el Core corre, la barra se ve vacía en vez de mostrar su valor.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-value
Qué hace: Se escribe data-ts-value="40" (porcentaje) en cada [data-progress-fill], también en los tramos apilados. El Core lo lleva a --ts-progress-value al iniciar y cuando el atributo cambia. La barra indeterminada no lleva el atributo. No hay interacción: es sólo el valor de reposo.
Sin build, desde el CDN: taisho.progress.css, además de taisho.base.css. Con ese archivo alcanza.
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Usa
role="progressbar"conaria-valuenow/min/max(omitidos en modo indeterminado). labelprovee el nombre accesible de la barra.- Con
is-stepsois-stackedllevaaria-valuetext(«3 de 5», «Usado 40, Reservado 20 de 100»): el lector anuncia los tramos, no sólo un número. Enshape-circleel SVG es decorativo (aria-hidden) y el porcentaje visible repite el valor delrole="progressbar". - No es interactivo (sin foco ni teclado). Con
prefers-reduced-motionel avance del arco es instantáneo (los tokens de duración globales); el giro indeterminado sigue, igual que el Spinner, porque es la señal de carga. La barra indeterminada queda quieta como un tramo fijo de la pista (el modo indeterminado se sigue leyendo, sinaria-valuenow).
Verificación
Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.
- axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
- teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
- lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.