Alert Dialog
Preguntar antes de algo destructivo. Cancelar recibe el foco. Las acciones async esperan.
NuevoInstalación
Copia y pega el siguiente código en tu proyecto.
Actualiza las rutas de importación para que coincidan con la estructura de tu proyecto.
Anatomía
Composición
Usá la siguiente composición para construir un
AlertDialog:Usalo cuando la persona tiene que responder antes de seguir, como al borrar datos o revocar un acceso. Para formularios y cosas que se pueden cerrar sin pensar, usá Dialog. A diferencia de
Dialog, un alert dialog:- No se cierra al hacer clic en el fondo y no tiene botón de cerrar en la esquina.
- Pone el foco en
AlertDialog.Cancelal abrirse, así unEnterde más nunca confirma. - Necesita un
Titley unaDescription. Si falta alguno, deja un error en la consola.
Variantes
Por defecto (Default)
Acción async (Async Action)
Cuando el
onClick de AlertDialog.Action devuelve una promesa, el diálogo la espera. El botón muestra un spinner y queda marcado como ocupado, Cancelar y Escape se desactivan, y el diálogo se cierra cuando la promesa se resuelve. Si se rechaza, queda abierto para que puedas mostrar qué salió mal.Last used 42 minutes ago by deploy-runner.
Llamá a
event.preventDefault() dentro de onClick para dejarlo abierto sin promesa, por ejemplo cuando falla una validación.Teclado
| Tecla | Acción |
|---|---|
Tab | Se mueve entre los botones, el foco no sale del diálogo |
Shift+Tab | Se mueve hacia atrás y vuelve a empezar al llegar al borde |
Escape | Igual que Cancelar, y devuelve el foco al trigger |
Enter | Activa el botón enfocado. Al abrirse, el foco está en Cancelar |
Accesibilidad
- El contenido tiene
role="alertdialog"yaria-modal="true", con el título como nombre y la descripción como descripción accesible. Escapeejecuta Cancelar, incluido suonClick, así las dos salidas se comportan igual.- Poné
data-autofocusen otro elemento si Cancelar no es el lugar más seguro para empezar. - El scroll de la página se bloquea mientras está abierto y el foco vuelve al trigger al cerrarse.
Referencia de API
AlertDialog
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
open | boolean | - | Estado abierto controlado |
defaultOpen | boolean | false | Estado abierto inicial sin controlar |
onOpenChange | (open: boolean) => void | - | Callback cuando cambia el estado abierto |
AlertDialog.Trigger
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
asChild | boolean | false | Renderiza el elemento hijo en vez de un botón |
className | string | - | Clases CSS adicionales |
AlertDialog.Content
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
className | string | - | Clases CSS adicionales |
overlayClassName | string | - | Clases CSS adicionales del fondo |
AlertDialog.Cancel
Renderiza un
Button con la variante outline y acepta todas sus props.| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
asChild | boolean | false | Renderiza el elemento hijo en vez de un botón |
variant | ButtonProps['variant'] | 'outline' | Variante del botón |
onClick | (event: MouseEvent) => void | - | Corre antes de cerrar. Llamá a preventDefault() para quedarte |
AlertDialog.Action
Renderiza un
Button y acepta todas sus props.| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
asChild | boolean | false | Renderiza el elemento hijo en vez de un botón |
variant | ButtonProps['variant'] | 'default' | Variante del botón, casi siempre 'destructive' |
onClick | (event: MouseEvent) => void | Promise<unknown> | - | Devolvé una promesa para que la espere. preventDefault() lo deja abierto |
AlertDialog.Header, AlertDialog.Footer, AlertDialog.Title, AlertDialog.Description
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
className | string | - | Clases CSS adicionales |
¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.