Saltar al contenido

Select

Selector de un valor de una lista conocida. No es el <select> nativo: soporta grupos, búsqueda interna, selección múltiple y opciones con ícono y descripción. El panel vive en el top-layer del navegador (Popover API).

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.

Rol del miembro con una opción no disponible

Invitar como
html

Limpiable con valor

Proyecto
html

Solo lectura

Entorno
html

Cargando

Responsable
html

Selección múltiple

Notificar a
html

Con íconos y descripciones

Plan
html

Obligatorio con ayuda

Rol
html

Deshabilitado

Facturación
html

Obligatorio sin valor

Permiso inicial
html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Tamaño

El alto del campo: sm, md o lg.

html

Variante

El color del borde según validación: default, success, warning, info o danger.

html

Densidad

El aire interno del campo.

html

Estados

is-disabled, is-readonly, is-loading y la opción seleccionada.

html

Combinaciones

Tamaño, variante y densidad actuando juntos.

html

Cuándo usarlo

  • Se elige uno o varios elementos de un conjunto conocido y acotado que se recorre de un vistazo.
  • Hace falta selección múltiple o un buscador dentro del panel.
  • Es un campo de formulario: el valor elegido queda y se envía.

Cuándo no

  • La lista es larga y tipear para filtrar es la interacción principal → combobox.
  • El usuario tiene que poder escribir un valor que no está en la lista → combobox con data-ts-allow-custom.
  • El caso no es elegir un valor sino disparar una acción → menu.

Cómo usarlo

  • El campo se etiqueta con el HTML de field: label, ayuda y error atados al control.
  • Las opciones se ordenan con criterio (frecuencia o alfabético) y se agrupan si son muchas.

Cómo no usarlo

  • No se usa para dos o tres opciones excluyentes que conviene ver siempre → segmented-control o radio.
  • No se mezclan acciones (“Editar”, “Borrar”) entre las opciones: un Select elige, no ejecuta.

TaishoDS Core

Necesita el JS del Core: maneja foco, teclado y estado.

Es una lista de opciones propia, no un <select> nativo: tiene teclado, búsqueda por escritura y selección múltiple.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-clear
  • data-ts-count-suffix
  • data-ts-listbox
  • data-ts-listbox-label
  • data-ts-listbox-loading
  • data-ts-listbox-native
  • data-ts-listbox-panel
  • data-ts-listbox-spinner
  • data-ts-listbox-template
  • data-ts-listbox-trigger
  • data-ts-listbox-value
  • data-ts-multiple
  • data-ts-placeholder
  • data-ts-required-proxy
  • data-ts-value

Qué hace: Lista de opciones completa (patrón listbox de la APG): abrir y cerrar, foco, ↑ ↓, Home, End, búsqueda por escritura, selección múltiple, botón de limpiar y posicionamiento. Tab con el panel abierto lo cierra y el foco sigue. El texto del disparador y el estado is-placeholder salen de la selección.

Atributo Qué hace
data-ts-count-suffixCon varias opciones elegidas el disparador dice «3 seleccionados»; el sufijo sale de este atributo.
data-ts-clearBotón de limpiar la selección.
aria-readonly="true" (en el disparador)Sólo lectura: no abre, no elige y no muestra chevron ni limpiar.
setSelectLoading(root, true | false)Pone is-loading, aria-busy, el Spinner y «Cargando…».
data-select-option-icon, data-select-option-descriptionOpciones con ícono y descripción: marcado y CSS.

Sin build, desde el CDN: taisho.select.css, además de taisho.base.css. También se carga:

  • taisho.button.css
  • taisho.checkbox.css
  • taisho.icon.css
  • taisho.input.css
  • taisho.kbd.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

Implementa el patrón Combobox de la WAI-ARIA APG.

  • El trigger es un <button> con role="combobox" y aria-expanded.
  • Navegación por teclado: flechas para moverse, Enter para elegir, Escape para cerrar.
  • required pinta el asterisco del label (decorativo, aria-hidden) y pone aria-required="true" en el trigger, que el rol combobox admite. Como required nativo no aplica a un <button>, además suma un <input data-ts-required-proxy> sin name, invisible, aria-hidden y fuera del orden de Tab, que bloquea el envío del formulario vacío con el mensaje nativo del navegador y pasa el foco al trigger. No valida con disabled ni readonly. Con disabled, el valor no viaja en el formulario.
  • El botón de limpiar (data-ts-clear) es un hermano del trigger (un <button> no admite otro adentro): entra en el orden de Tab justo después de él, tiene aria-label propio y sólo se ve con selección y sin disabled. Al activarlo con Enter o Espacio se limpia (en múltiple, todo) y el foco vuelve al trigger.
  • readonly pone aria-readonly="true" en el trigger: sigue enfocable, pero no abre el panel ni con el mouse ni con el teclado, y no muestra chevron ni botón de limpiar. El valor sigue viajando en el form.
  • Para el estado de carga, se llama a setSelectLoading(root, true|false): pone is-loading y aria-busy="true" en el disparador y en el panel, suma un Spinner en el campo (role="status") y «Cargando…» en el panel; no bloquea el campo ni oculta las opciones. Si se pone sólo la clase, no se anuncia.
  • Las opciones con descripción se nombran por su etiqueta (aria-labelledby) y se describen con aria-describedby; el ícono es decorativo (aria-hidden). El trigger muestra sólo la etiqueta.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
↑↓Recorre las opciones.
HomeEndLlevan a la primera o a la última opción habilitada.
Enter/EspacioElige la opción resaltada.
EscapeCierra sin cambiar la selección.
TabCierra el panel y el foco sigue su camino: las opciones no son tabulables.

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.