AlertDialog
Diálogo que fuerza una decisión antes de seguir: bloquea, y a diferencia de Modal el fondo NO lo descarta. Para confirmaciones destructivas o irreversibles — borrar, cancelar, descartar cambios.
Capas flotantes · 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.
Confirmación para borrar la cuenta
Confirmar tipeando el nombre del proyecto
Nombre propio más descriptivo
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Variante
La naturaleza de la acción: default, o danger para la destructiva (el botón de confirmar se pinta de peligro).
Texto de confirmación
Confirmar queda deshabilitado hasta tipear el texto exacto (borrados peligrosos).
Cuándo usarlo
- La acción es destructiva o irreversible y merece una confirmación explícita.
- Cerrar sin querer tendría consecuencias: hace falta una respuesta deliberada.
- La elección se reduce a dos o tres caminos claros (confirmar / cancelar).
Cuándo no
- Es información o una tarea que puede cerrarse sin costo →
modal. - El aviso no bloquea nada y puede vivir en la página →
banneronote. - Es una notificación de algo que ya pasó →
toast.
Cómo usarlo
- El botón nombra la acción: “Borrar proyecto”, no “Aceptar”.
- La acción peligrosa se marca visualmente (
variant-dangeren el botón de confirmar) y la cancelación queda como salida segura. - Si el borrado no tiene vuelta atrás (un proyecto entero, una cuenta), se puede pedir tipear el nombre para confirmar con
data-ts-confirm-text: Confirmar queda deshabilitado hasta que coincide.
Cómo no usarlo
- No se usa para avisos neutros: si nada se pierde, no se bloquea al usuario.
- No se ofrecen cinco opciones — si hay más de un par de caminos, no es una confirmación.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Es un <dialog> modal: abrir, cerrar, atrapar el foco y Escape los hace el navegador, y la variante destructiva es sólo estilo. Lo único que pide JavaScript es la confirmación por escrito: tipear un texto exacto para habilitar Confirmar.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-confirmdata-ts-confirm-inputdata-ts-confirm-textdata-ts-field-spinnerdata-ts-input
Qué hace: Sólo con confirmación por escrito: el <dialog> lleva data-ts-confirm-text="...", el campo data-ts-confirm-input y el botón data-ts-confirm (que sale disabled). El Core lo habilita cuando lo tipeado coincide exacto, lo vuelve a bloquear al cargar y vacía el campo al cerrar el diálogo. Sin confirmación por escrito no hay nada que iniciar: el foco inicial cae en el campo, el primer control del diálogo.
Limitación
Sin build, desde el CDN: este componente no tiene archivo propio, se arma con taisho.base.cssy con los de abajo. También se carga:
taisho.button.csstaisho.icon.csstaisho.input.csstaisho.kbd.csstaisho.modal.csstaisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
Implementa el patrón Alert Dialog de la WAI-ARIA APG.
- Rol
alertdialog: el lector de pantalla anuncia el título y la descripción al abrir. - El nombre accesible sale del título (
aria-labelledby). Unaria-labelo unaria-labelledbypropios en el<dialog>lo reemplazan; sin ningún nombre (un atributotitletambién cuenta como nombre), el Core lo avisa por la consola cuando la página se sirve desdelocalhost. - El foco inicial cae en el primer control del diálogo: en el ejemplo es Cancelar, que va antes que la acción destructiva, así que un Enter accidental no la dispara. Si se cambia el orden, se pone
autofocusen Cancelar. - Con
data-ts-confirm-text, en el ejemplo el foco inicial cae en el campo, que es el primer control (Confirmar sigue deshabilitado, así que no hay Enter peligroso). El campo tiene una<label>visible y Confirmar queda condisablednativo hasta que lo tipeado coincide exacto; al cerrar, el campo se vacía. - Escape equivale a cancelar; el clic en el backdrop no cierra — la decisión debe ser explícita.
- Hereda de
<dialog>+showModal(): top-layer, foco atrapado, fondoinerty foco devuelto al trigger al cerrar. En WebKit, si el diálogo se abrió con el mouse, al cerrar el foco no vuelve al disparador: Safari no enfoca un botón al hacerle clic. - Con el diálogo abierto, la página de atrás no se desplaza y conserva el lugar de la barra de desplazamiento (
scrollbar-gutter: stable), así que el contenido no se corre.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Escape | Cancela — nunca confirma: la acción destructiva requiere intención. |
| Enter | Activa el botón enfocado. |
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.