Dialog
Use the dialog patch to customize this element.
Customization
Must see the source of patch at the bottom of each patch page to understand the structure then code it still code as html native element.
There are four levels of customization, in increasing order of effort:
- Patch props. Each patch exposes a small, stable set of props—typically fewer than five. Lowest friction.
- Context attributes. Use
dataTone,dataSize, anddataDensityon a container to shift tone, size, or density for an entire subtree without touching individual elements. - Inline override. Native-wins merge strategy: any property set directly on the element overrides the patch value.
- Create a variant. Clone a similar patch and edit it. Use this only when you need a reusable custom version.
Formulas
Unit - U = fontSize / 4 - convert final values with themeSpacing(n).
Size - n = intrinsic text lines, w = wrapping level, d = density factor:
height = (n * 6 + 2 * d * w) * U
paddingBlock = d * w * U
paddingInline = ceil(3 / w) * d * w * U
radius = d * w * U
Base density d = 1.5:
| U | w=0 | w=1 | w=2 | w=3 |
|---|---|---|---|---|
height (n = 1) | 6 | 9 | 12 | 15 |
| paddingBlock | 0 | 1.5 | 3 | 4.5 |
| paddingInline | 3 | 4.5 | 6 | 4.5 |
| radius | 0 | 1.5 | 3 | 4.5 |
Tone - K = N / 2 where N is the palette length. For N = 18, K = 9.
| Role | Shift | n=0 |
|---|---|---|
| Background | parent +/- n | 0 |
| Text | bg + K | 6 |
| Border | bg + K/2 | 3 |
| Hover | bg + 2K/3 | 4 |
| Selected / Focus | above +/- K/3 | 2-4 |
State shift range: K/3 <= delta <= 2K/3.
<div class="blocks">
<div class="block active" data-tab="0">
import { type PartialElement, toState, type ValueOrState } from "@domphy/core";
import {
type ThemeColor,
themeColor,
themeDensity,
themeSize,
themeSpacing,
} from "@domphy/theme";
/**
* Modal dialog patch driven by an `open` State. Calls `showModal()`/`close()`,
* fades via opacity, locks page scroll while open, focuses the first focusable
* child, and closes on outside (backdrop) click. Apply to a `<dialog>` element.
*
* @hostTag dialog
* @param props.color - Theme color tone for the dialog surface. Defaults to "neutral".
* @param props.open - Open state (`ValueOrState<boolean>`); set it to true/false to show/hide. Defaults to false.
* @example { dialog: [...], $: [dialog({ open })] }
*/
function dialog(
props: { color?: ThemeColor; open?: ValueOrState<boolean> } = {},
): PartialElement {
const { color = "neutral", open = false } = props;
const state = toState(open);
return {
_onInsert: (node) => {
if (node.tagName !== "dialog") {
console.warn(`"dialog" primitive patch must use dialog tag`);
}
},
onClick: (e: MouseEvent, node) => {
if (e.target !== node.domElement) return;
const r = node.domElement!.getBoundingClientRect();
const inside =
e.clientX >= r.left &&
e.clientX <= r.right &&
e.clientY >= r.top &&
e.clientY <= r.bottom;
if (!inside) state.set(false);
},
onTransitionEnd: (_e, node) => {
const dlg = node.domElement as HTMLDialogElement;
if (dlg.style.opacity === "0") {
dlg.close();
document.body.style.overflow = "";
}
},
_onMount: (node) => {
const dlg = node.domElement as HTMLDialogElement;
const update = (val: boolean) => {
if (val) {
dlg.showModal();
document.body.style.overflow = "hidden";
requestAnimationFrame(() => {
dlg.style.opacity = "1";
const focusable = dlg.querySelector<HTMLElement>(
'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])',
);
focusable?.focus();
});
} else {
dlg.style.opacity = "0";
}
};
update(state.get());
const release = state.addListener(update);
// Release the listener on the user-provided `open` State and always
// restore page scroll on removal — otherwise removing an open dialog
// leaks the listener and leaves document.body locked at overflow:hidden.
node.addHook("Remove", () => {
release();
document.body.style.overflow = "";
});
},
style: {
opacity: "0",
transition: "opacity 200ms ease",
fontSize: (listener) => themeSize(listener, "inherit"),
color: (listener) => themeColor(listener, "shift-10", color),
backgroundColor: (listener) => themeColor(listener, "inherit", color),
border: "none",
padding: (listener) => themeSpacing(themeDensity(listener) * 3),
boxShadow: (listener) =>
`0 ${themeSpacing(9)} ${themeSpacing(16)} ${themeColor(listener, "shift-4", "neutral")}`,
"&::backdrop": {
backgroundColor: (listener) =>
themeColor(listener, "shift-2", "neutral"),
opacity: 0.75,
},
},
};
}
export { dialog };
</div>
</div>