Modales y Diálogos
Reglas
- Usa el Dialog de Radix o
<Dialog> de shadcn — accesible, con foco atrapado y bloqueo de desplazamiento por defecto
- Cuadros de diálogo de confirmación para acciones destructivas: "¿Eliminar este proyecto?" con botones Cancelar (secundario) y Eliminar (destructivo)
- Hojas/paneles deslizables para móvil:
<Sheet> de shadcn — se desliza desde abajo o desde un lado, mejor objetivo táctil que los modales centrados
- Foco atrapado: Radix lo maneja automáticamente — el primer elemento enfocable recibe el foco al abrir, y lo devuelve al cerrar
- Bloqueo de desplazamiento: evita el desplazamiento del body cuando el modal está abierto — Radix lo maneja con
<Dialog.Overlay>
- Disparadores de cierre: tecla Escape, clic fuera del overlay, botón de cierre explícito — todos proporcionados por Radix
- Estado controlado: props
open + onOpenChange — no confíes en el estado interno para modales activados por eventos externos
- Formularios en diálogos: enviar con Enter, cerrar al tener éxito, mostrar errores en línea — no cerrar en caso de fallo de validación
- Móvil: usa
<Sheet> (panel inferior) en lugar de <Dialog> centrado para acciones en pantallas pequeñas
Patrones
import {
AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent,
AlertDialogDescription, AlertDialogFooter, AlertDialogHeader,
AlertDialogTitle, AlertDialogTrigger,
} from "@/components/ui/alert-dialog";
function BotonEliminar({ onDelete }: { onDelete: () => Promise<void> }) {
const [cargando, setCargando] = useState(false);
return (
<AlertDialog>
<AlertDialogTrigger asChild>
<Button variant="destructive">Eliminar proyecto</Button>
</AlertDialogTrigger>
<AlertDialogContent>
<AlertDialogHeader>
<AlertDialogTitle>¿Eliminar este proyecto?</AlertDialogTitle>
<AlertDialogDescription>
Esto eliminará permanentemente el proyecto y todos sus datos. Esta acción no se puede deshacer.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
<AlertDialogCancel>Cancelar</AlertDialogCancel>
<AlertDialogAction
onClick={async () => { setCargando(true); await onDelete(); setCargando(false); }}
disabled={cargando}
>
{cargando ? "Eliminando..." : "Eliminar"}
</AlertDialogAction>
</AlertDialogFooter>
</AlertDialogContent>
</AlertDialog>
);
}
import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetTrigger } from "@/components/ui/sheet";
function MenuMovil() {
return (
<Sheet>
<SheetTrigger asChild><Button variant="ghost" size="icon"><IconoMenu /></Button></SheetTrigger>
<SheetContent side="bottom">
<SheetHeader><SheetTitle>Acciones</SheetTitle></SheetHeader>
<nav className="flex flex-col gap-2 py-4">
<Button variant="ghost">Editar</Button>
<Button variant="ghost">Compartir</Button>
<Button variant="destructive">Eliminar</Button>
</nav>
</SheetContent>
</Sheet>
);
}
Evita
- Construir modales personalizados con
position: fixed y gestión manual del foco — usa Dialog de Radix/shadcn
- Omitir la tecla Escape y el cierre al hacer clic fuera — Radix maneja ambos, no los sobrescribas
- Modales centrados en móvil para menús de acciones — usa Sheet/Drawer inferior para mejor alcance del pulgar
- Cerrar el diálogo al fallar la validación de un formulario — manténlo abierto, muestra errores en línea, deja que el usuario corrija y reenvíe
- Diálogos anidados sin contexto de apilamiento adecuado — si son necesarios, usa el soporte de diálogos anidados de Radix con un
z-index apropiado