Saltar al contenido

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

html

Confirmar tipeando el nombre del proyecto

html

Nombre propio más descriptivo

html

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).

html

Texto de confirmación

Confirmar queda deshabilitado hasta tipear el texto exacto (borrados peligrosos).

html

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 → banner o note.
  • 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-danger en 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.

Relacionados

ModalToastNote

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-confirm
  • data-ts-confirm-input
  • data-ts-confirm-text
  • data-ts-field-spinner
  • data-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

El disparador usa invoker commands (`command` y `commandfor`), que el navegador trae desde Chrome 135, Firefox 144 y Safari 26.2. En los anteriores el JS del Core ejecuta los comandos sobre el dialog; si no se cargó ese JS, el botón no abre y hay que abrirlo con `dialog.showModal()` desde tu código.

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.css
  • taisho.icon.css
  • taisho.input.css
  • taisho.kbd.css
  • taisho.modal.css
  • taisho.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). Un aria-label o un aria-labelledby propios en el <dialog> lo reemplazan; sin ningún nombre (un atributo title también cuenta como nombre), el Core lo avisa por la consola cuando la página se sirve desde localhost.
  • 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 autofocus en 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 con disabled nativo 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, fondo inert y 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
EscapeCancela — nunca confirma: la acción destructiva requiere intención.
EnterActiva 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.