Slider
Selector de un valor dentro de un rango continuo, de una lista de paradas (data-ts-slider-values) o de un tramo con dos manijas que no se cruzan (data-ts-slider-range). Monta sobre <input type="range"> nativos, así que arrastre y teclado son los del navegador. Puede mostrar el valor actual y las marcas de mínimo/máximo, ir en vertical (is-vertical) o de sólo lectura.
Formularios · 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.
Límite de asientos del plan
Rango de precio
Vertical
Solo lectura
Paradas no uniformes
Texto por parada
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Tamaño
El grosor del control: sm, md o lg.
Estados
is-disabled bloquea el arrastre; is-readonly se enfoca y se lee, pero no cambia.
Rango
is-range: dos manijas que no se cruzan; el tramo entre ellas se pinta.
Orientación
is-vertical: el mínimo queda abajo.
Cuándo usarlo
- El valor es aproximado y el feedback visual del rango ayuda (volumen, opacidad, un umbral).
- Lo que más importa es la relación dentro del rango, más que el número exacto.
- Ajustar arrastrando es más natural que tipear.
- Se filtra por un tramo (precio, cuota de uso, un rango de fechas de despliegue):
data-ts-slider-range, con dos manijas. - Los valores posibles forman una escala sin espaciado parejo (asientos de un plan: 5, 10, 25, 50, 100, 250):
data-ts-slider-valueslista las paradas y el control sólo cae en ellas.
Cuándo no
- Hace falta un número exacto →
number-input. - El rango es enorme y arrastrar es impreciso →
number-input. - Son pocas opciones discretas (Free, Pro, Enterprise) →
segmented-control.
Cómo usarlo
- Se muestran el valor actual y las marcas de extremo como referencia.
- Con paradas, cada una lleva su texto (
data-ts-slider-formatodata-ts-slider-texts): el lector dice «6 px, Suave», no una posición. - Se elige un
stepque no frustre (ni demasiado fino ni grueso). - Se guardan o se piden datos cuando se confirma el valor:
ts:commitsale al soltar;ts:changesale en cada movimiento. - Se usa
aria-readonly="true"en el input, nodisabled, cuando el valor se lee y viaja en el form pero no se edita.
Cómo no usarlo
- No se usa cuando la precisión importa y el error cuesta.
- No se esconde el valor: sin número, el usuario adivina.
- No se pide una request por cada cambio de un arrastre.
Relacionados
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Usa un <input type="range"> nativo para el arrastre y el teclado, y el Core suma el relleno de la pista, los límites de las manijas de range y los eventos.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-sliderdata-ts-slider-formatdata-ts-slider-raildata-ts-slider-rangedata-ts-slider-valuedata-ts-slider-valuesdata-ts-slider-valuetexts
Qué hace: Al mover, el Core actualiza el relleno, aria-valuenow, los límites ARIA de cada manija y el texto del valor. Las manijas de range no se cruzan, y cuando se superponen queda arriba la que tiene lado libre. Clic o arrastre sobre el riel mueven la manija más cercana. form.reset() repinta el relleno.
| Atributo | Qué hace |
|---|---|
data-ts-slider | La raíz del componente. |
data-ts-slider-range, data-ts-slider-rail | Dos manijas: la raíz lleva data-ts-slider-range y hay un riel data-ts-slider-rail. El relleno se pinta con --ts-slider-fill, o con --ts-slider-from y --ts-slider-to en el riel. |
data-ts-slider-values | Las paradas, separadas por comas (0,2,4,6,8,12,16,24), de menor a mayor. Con ellas el <input type="range"> trabaja en posiciones (min="0", max="n-1", step="1", value = posición) y el Core publica el valor real en aria-valuenow, aria-valuetext, el texto visible y los eventos. RePág y AvPág mueven una parada (con más de 14 paradas, una décima parte de la lista). Para que el valor viaje en el form, el name va en un <input type="hidden"> (uno por manija) que el Core mantiene al día, no en el range. |
data-ts-slider-valuetexts, data-ts-slider-valuetext | Lo que lee el lector de pantalla (aria-valuetext) cuando tiene que decir más que el valor visible: data-ts-slider-valuetexts es una lista con un texto por parada, separados por | (6 px, Suave); data-ts-slider-valuetext es una plantilla con {v}. Sin ellos, el lector dice lo mismo que se ve. |
data-ts-slider-texts | Un texto por parada, separados por | (0 px|2 px|6 px, Suave), en el orden de data-ts-slider-values. Gana sobre data-ts-slider-format. |
slider-ticks | Un <div class="ts slider-ticks" aria-hidden="true"> con un <span> vacío por parada, justo antes del input (o del primer input de un range), dibuja una marca por parada sobre el riel. |
data-ts-slider-format | El texto del valor, con {v}; también sirve para aria-valuetext. |
aria-readonly="true" (en el input) | El slider es de sólo lectura: no cambia ni avisa. |
is-vertical | Lo pone en vertical. |
ts:change | Sale en cada movimiento, cancelable (la manija vuelve), con detail.value (un número, o [inicio, fin] con range) e index. |
ts:commit | Sale al soltar el puntero o la tecla. |
Sin build, desde el CDN: taisho.slider.css, además de taisho.base.css. Con ese archivo alcanza.
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
Implementa el patrón Slider de la WAI-ARIA APG.
- Se apoya en
<input type="range">nativo: flechas del teclado, Home/End y foco accesibles de fábrica. - El label se asocia vía
for/id. - Con
data-ts-slider-formatcada manija publicaaria-valuetext(por ejemplo «40%»); sin formato, el lector dice el número. - Con paradas el input nativo trabaja en posiciones, pero cada manija publica el valor real en
aria-valuenowy el texto de la parada enaria-valuetext(siempre, aunque no haya formato;data-ts-slider-valuetextsodata-ts-slider-valuetextlo separan del texto visible): el lector dice «6 px, Suave», no «la posición 3». Las marcas de las paradas (slider-ticks) sonaria-hidden. - Sin label visible, el nombre sale de
aria-labelen el input; con label visible, el label manda. - Con
is-rangees unrole="group"nombrado por el label, y cada manija se llama «<label> Mínimo» o «<label> Máximo». Siguiendo el patrón Slider (Multi-Thumb) de la APG, elaria-valuemaxde la de inicio es el valor de la de fin y elaria-valueminde la de fin, el de inicio. - Las manijas no se cruzan: una manija que llegaría más allá de la otra se detiene en ella. Cuando quedan superpuestas, arriba va la que se puede sacar hacia el lado libre.
is-readonlypublicaaria-readonly="true": la manija se enfoca y se lee, pero ni el teclado ni el puntero la cambian. No usadisabled, así que el valor viaja en el form.is-verticalpublicaaria-orientation="vertical"; el mínimo queda abajo.- Con
forced-colors: activeel tramo pinta conHighlighty el resto conGrayText, y el foco es un outline de sistema (los box-shadow se pierden).
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| ←→ | Ajusta el valor según step (en RTL la flecha derecha resta, como el input nativo). |
| ↑↓ | Igual que las flechas horizontales; en vertical, ↑ sube hacia el máximo. |
| Home/End | Va al mínimo o al máximo. Con is-range, la manija de inicio frena en la de fin y viceversa. |
| RePág/AvPág | Salta varios pasos, como el input nativo. Con paradas (data-ts-slider-values) salta una parada, o una décima parte de la lista si hay más de 14. |
| Tab | Con is-range, recorre las dos manijas (inicio y fin) en ese orden. |
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 Mapa de teclas documentado arriba, contrastado contra el componente.
- 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.