Saltar al contenido

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

html

Variante de éxito

html

Indeterminada

html

Por pasos

html

Por segmentos

html

Circular con valor

72%
html

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.

html

Variante

El color de la barra: default o el semántico (success, danger, brand…).

html

Por tramos

is-steps: la barra en N tramos iguales; is-filled marca los llenos (3 de 5 asientos).

html

Segmentos

is-stacked: varios valores de distinto color en una sola barra (usado y reservado).

html

Forma

shape-circle: el progreso en un anillo; el size es el diámetro.

60%
html

Estados

is-indeterminate para progreso desconocido (animación continua).

html

Combinaciones

Tamaño y color actuando juntos.

html

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-steps para "3 de 5 asientos", is-stacked para 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-indeterminate en 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.

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" con aria-valuenow/min/max (omitidos en modo indeterminado).
  • label provee el nombre accesible de la barra.
  • Con is-steps o is-stacked lleva aria-valuetext («3 de 5», «Usado 40, Reservado 20 de 100»): el lector anuncia los tramos, no sólo un número. En shape-circle el SVG es decorativo (aria-hidden) y el porcentaje visible repite el valor del role="progressbar".
  • No es interactivo (sin foco ni teclado). Con prefers-reduced-motion el 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, sin aria-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.