Saltar al contenido

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

html

Rango de precio

⁨20 USD⁩ – ⁨80 USD⁩
0 100
html

Vertical

60%
html

Solo lectura

65%
html

Paradas no uniformes

25 asientos
5 asientos 250 asientos
html

Texto por parada

25 asientos
html

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.

40
40
40
html

Estados

is-disabled bloquea el arrastre; is-readonly se enfoca y se lee, pero no cambia.

html

Rango

is-range: dos manijas que no se cruzan; el tramo entre ellas se pinta.

html

Orientación

is-vertical: el mínimo queda abajo.

html

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-values lista 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-format o data-ts-slider-texts): el lector dice «6 px, Suave», no una posición.
  • Se elige un step que no frustre (ni demasiado fino ni grueso).
  • Se guardan o se piden datos cuando se confirma el valor: ts:commit sale al soltar; ts:change sale en cada movimiento.
  • Se usa aria-readonly="true" en el input, no disabled, 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.

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-slider
  • data-ts-slider-format
  • data-ts-slider-rail
  • data-ts-slider-range
  • data-ts-slider-value
  • data-ts-slider-values
  • data-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-sliderLa raíz del componente.
data-ts-slider-range, data-ts-slider-railDos 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-valuesLas 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-valuetextLo 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-textsUn 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-ticksUn <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-formatEl 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-verticalLo pone en vertical.
ts:changeSale en cada movimiento, cancelable (la manija vuelve), con detail.value (un número, o [inicio, fin] con range) e index.
ts:commitSale 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-format cada manija publica aria-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-valuenow y el texto de la parada en aria-valuetext (siempre, aunque no haya formato; data-ts-slider-valuetexts o data-ts-slider-valuetext lo separan del texto visible): el lector dice «6 px, Suave», no «la posición 3». Las marcas de las paradas (slider-ticks) son aria-hidden.
  • Sin label visible, el nombre sale de aria-label en el input; con label visible, el label manda.
  • Con is-range es un role="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, el aria-valuemax de la de inicio es el valor de la de fin y el aria-valuemin de 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-readonly publica aria-readonly="true": la manija se enfoca y se lee, pero ni el teclado ni el puntero la cambian. No usa disabled, así que el valor viaja en el form.
  • is-vertical publica aria-orientation="vertical"; el mínimo queda abajo.
  • Con forced-colors: active el tramo pinta con Highlight y el resto con GrayText, 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/EndVa al mínimo o al máximo. Con is-range, la manija de inicio frena en la de fin y viceversa.
RePág/AvPágSalta 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.
TabCon 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.