id: dialog
label: Dialog
family: family-a-overlay
category: Overlay
intent: Display critical content requiring user interaction
description: Modal dialog component
composable: true
capabilities: OpenClose, FocusTrap, KeyboardEsc, AriaModal
required_parts: ["DialogContent", "DialogTitle"]
optional_parts: ["DialogOverlay", "DialogDescription", "DialogClose"]
tags: ["dialog", "modal", "popup", "window", "overlay", "confirmation"]
keywords:
pain: Dialogs break focus trap and accessibility roles
promise: Dialog accessibility and lifecycle enforced via primitives
why: |
DialogPrimitive defines overlay, portal and content with ARIA compliance. VisibilityState guarantees correct open/close synchronization. This ensures safe modal behavior across SSR and client.
rules: ["CR-001", "CR-004"]
use_cases: ["modals", "forms"]
related: ["alert_dialog", "drawer", "sheet", "modal", "confirm_dialog", "tooltip", "hover_card", "popover"]
file: dialog_ui.css
tokens: dialog-*, space-*, radius-*, shadow-*, motion-*, font-*
foundation: spacing, radius, shadow, motion, typography
states: ["open", "closed"]
island: dialog_boundary.rs
pillar: overlay
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift", "Island Architecture"]
before: |
// ❌ Typical
view! {
<div class="modal">"Content"</div>
}
after: |
// ✅ CanonRS
view! {
<Dialog>
<DialogTrigger>"Open"</DialogTrigger>
<DialogPortal>
<DialogOverlay />
<DialogContent>
<DialogTitle>"Title"</DialogTitle>
</DialogContent>
</DialogPortal>
</Dialog>
}
boundary_type: interaction
ix_group: ix_overlay
block: []
blocks_primitives: [center, stack]