Overlays
Dialog
A centered modal for focused forms, decisions, and short workflows.import { Button, Dialog } from "@hyzrui/core";
export function Example() {
return <Dialog trigger={<Button variant="outline">Open dialog</Button>} title="Dialog">Focused content.</Dialog>;
}Installation
Install the primitive source, then keep editing it inside your app. The command names the component file you want copied.
pnpm dlx hyzrui add dialogUsage
Import the component from the generated source folder and compose it with normal React props.
import { Dialog } from "@hyzrui/core";<Dialog className="my-dialog" />Customization
Every primitive accepts local props and class names, then inherits design tokens from HyzrThemeProvider . Copy the file, keep the markup, and tune the CSS until it matches your product.
--hui-radiusControls the default corner system for buttons, inputs, cards, overlays, and nested surfaces.--hui-foregroundControls the page and component text colors. Dark mode uses the same component source with different tokens.--hui-surfaceControls card, dialog, popover, and input surfaces.--hui-borderControls separators, input strokes, card outlines, and menu edges.--hui-primaryControls the main action color and the matching foreground color for solid controls.--hui-font-familyControls the font stack used by every primitive inside the provider.--hui-control-font-sizeControls the default font size for buttons, inputs, selects, tabs, command rows, and menu triggers.--hui-font-weight-controlControls the default weight of buttons, tabs, menus, badges, and compact actions.--hui-control-heightControls the default field and trigger height across forms and navigation.--hui-button-heightControls button height independently from form fields.--hui-button-paddingControls horizontal button spacing without changing the text size.--hui-card-paddingControls card, dialog, sheet, drawer, and panel interior spacing.--hui-border-widthControls default edge width for controls, cards, tables, and floating panels.--hui-focus-widthControls keyboard focus outline thickness.--hui-transition-durationControls shared hover timing for controls and surfaces.--hui-hover-liftControls subtle hover lift for raised styles.--hui-overlayControls dialog, sheet, drawer, and command overlay strength.--hui-floating-offsetControls menu, command, popover, and hover-card distance from the trigger.import { defineHyzrTheme } from "@hyzrui/core";
export const theme = defineHyzrTheme({
id: "product",
density: "comfortable",
radius: 10,
shadow: 0.08,
colors: {
background: "#fbfbfc",
foreground: "#09090b",
surface: "#ffffff",
border: "#e4e4e7",
primary: "#18181b",
primaryForeground: "#ffffff",
},
typography: {
controlSize: 14,
controlWeight: 500,
headingWeight: 680,
},
sizing: {
controlHeight: 38,
buttonHeight: 34,
buttonPadding: 14,
cardPadding: 18,
},
borders: {
radius: 10,
radiusSm: 7,
radiusLg: 16,
width: 1,
focusWidth: 2,
},
motion: {
duration: 150,
hoverLift: 0,
hoverMix: 5,
},
});See the customization guide for the full theme shape, style presets, scoped CSS overrides, and source-edit workflow.
Examples
These examples show the same primitive in realistic combinations and states.
Form dialog
Use dialogs for short forms that need the user's full attention before continuing.
import { Button, Dialog, Field, Input } from "@hyzrui/core";
export function DialogForm() {
return (
<Dialog
trigger={<Button variant="outline">Invite member</Button>}
title="Invite team member"
description="They will receive an email with a link to join your workspace."
actions={
<>
<Button variant="outline">Cancel</Button>
<Button>Send invite</Button>
</>
}
>
<div style={{ display: "grid", gap: 12 }}>
<Field label="Email address">
<Input placeholder="colleague@company.com" />
</Field>
<Field label="Role">
<Input defaultValue="Editor" />
</Field>
</div>
</Dialog>
);
}Destructive action
Destructive dialogs should name the specific consequence, not just 'are you sure?'
import { Button, Dialog } from "@hyzrui/core";
export function DialogDestructive() {
return (
<Dialog
trigger={<Button tone="danger" variant="outline">Delete project</Button>}
title="Delete project?"
description="This project and all its data will be permanently removed. This action cannot be undone."
actions={
<>
<Button variant="outline">Cancel</Button>
<Button tone="danger">Delete project</Button>
</>
}
>
<p style={{ fontSize: "0.875rem", color: "var(--hui-muted)" }}>
All 14 components, 3 releases, and activity history will be deleted.
</p>
</Dialog>
);
}API Reference
Props are intentionally small. For deeper changes, edit the component source file directly.
| Prop | Type | Default | Description |
|---|---|---|---|
className | string | - | Adds classes to the copied component without replacing the default structure. |
children | React.ReactNode | - | The rendered content for compound or wrapper components. |
...props | HTMLAttributes | - | Forwards native element props such as id, aria attributes, and event handlers. |
trigger | React.ReactNode | - | Element used to open the dialog. |
title | string | - | Dialog heading. |
description | string | - | Supporting copy below the title. |
actions | React.ReactNode | - | Footer actions. |