PatternDisponible
Dialog
Ventana modal para una tarea concreta con gestión del foco.
Instalación
Agrega el componente y sus dependencias desde el registro que está ejecutándose en tu computadora.
terminal
npx shadcn@latest add https://brutallab.facilito.dev/r/dialog.jsonUso
Importa el componente en tu proyecto y conserva el código bajo tu control.
tsx
'use client';
import {
Dialog,
DialogTrigger,
DialogContent,
DialogHeader,
DialogTitle,
DialogDescription,
DialogFooter,
DialogClose,
} from '@/components/ui/dialog';
import { Button } from '@/components/ui/button';
export default function Demo() {
return (
<Dialog>
<DialogTrigger render={<Button variant="outline" />}>
Open dialog
</DialogTrigger>
<DialogContent>
<DialogHeader>
<DialogTitle>Workspace details</DialogTitle>
<DialogDescription>
Review this example and close it when you are done.
</DialogDescription>
</DialogHeader>
<div className="p-4 bl-type-body">
BrutalLab workspace · 12 components
</div>
<DialogFooter>
<DialogClose render={<Button />}>Done</DialogClose>
</DialogFooter>
</DialogContent>
</Dialog>
);
}
Estados e interacción
Aspecto, comportamiento y comprobación con teclado.
- Comprueba cerrado, abierto, opción resaltada, seleccionado y deshabilitado cuando el componente los admita.
- Los diálogos y menús deben poder abrirse con teclado. Escape cierra los overlays no persistentes y devuelve el foco al disparador. Tooltip y Hover Card también deben mostrarse al enfocar.
- Prueba el ejemplo con Tab y Shift+Tab. El foco debe seguir visible en ambos temas.
Referencia API
Propiedades propias de BrutalLab. También acepta los atributos nativos correspondientes.
| Prop | Tipo | Default | Descripción |
|---|---|---|---|
| open | boolean | uncontrolled | Controls panel visibility. |
| onOpenChange | function | — | Reports requests to open or close. |
| DialogContent / DialogFooter.closeLabel | string | Close | Translated accessible name of the default close control. |
Accesibilidad
Reglas que deben conservarse cuando el componente se adapte a un producto.
Conserva las etiquetas visibles y el HTML semántico del ejemplo.
Mantén el foco visible y comprueba la composición mediante el teclado.
Personaliza el aspecto con className sin reemplazar los atributos ARIA de la primitiva.