Accordion
Use accordion on a container of <details> elements to build a bordered accordion. In type: "single" mode (default), opening one item automatically closes all siblings. Pair with details patches on the child <details> elements.
| Prop | Type | Default | Description |
|---|---|---|---|
type | "single" | "multiple" | "single" | In single mode, opening one item closes all siblings. |
color | ValueOrState<ThemeColor> | "neutral" | Border and background tone. |
accentColor | ValueOrState<ThemeColor> | "primary" | Focus-outline tone on summary elements. |
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,
themeSpacing,
} from "@domphy/theme";
/**
* Container patch that groups `<details>` elements into a bordered accordion.
* In `type: "single"` mode (default), opening one item closes all siblings.
*
* @param props.type - `"single"` (default) or `"multiple"`. Single mode auto-closes siblings.
* @param props.color - Theme color tone for borders and backgrounds. Defaults to `"neutral"`.
* @param props.accentColor - Accent color for focus outlines on summary. Defaults to `"primary"`.
* @example
* { div: [
* { details: [{ summary: "Section A" }, { p: "Content A" }], $: [details()] },
* { details: [{ summary: "Section B" }, { p: "Content B" }], $: [details()] },
* ], $: [accordion()] }
*/
function accordion(
props: {
type?: "single" | "multiple";
color?: ValueOrState<ThemeColor>;
accentColor?: ValueOrState<ThemeColor>;
} = {},
): PartialElement {
const { type = "single" } = props;
const color = toState(props.color ?? "neutral", "color");
const accentColor = toState(props.accentColor ?? "primary", "accentColor");
return {
_onMount: (node) => {
if (type !== "single") return;
const el = node.domElement;
if (!el) return;
el.addEventListener("click", (event) => {
const summary = (event.target as Element).closest("summary");
if (!summary) return;
const item = summary.closest("details") as HTMLDetailsElement | null;
if (!item || item.parentElement !== el) return;
if (!item.open) {
Array.from(el.querySelectorAll(":scope > details")).forEach(
(detail) => {
if (detail !== item) (detail as HTMLDetailsElement).open = false;
},
);
}
});
},
style: {
display: "flex",
flexDirection: "column",
borderRadius: (listener) => themeSpacing(themeDensity(listener) * 1),
outline: (listener) =>
`1px solid ${themeColor(listener, "shift-4", color.get(listener))}`,
outlineOffset: "-1px",
overflow: "hidden",
"& > details": {
borderBottom: (listener) =>
`1px solid ${themeColor(listener, "shift-4", color.get(listener))}`,
},
"& > details:last-child": {
borderBottom: "none",
},
"& > details > summary:focus-visible": {
outline: (listener) =>
`${themeSpacing(0.5)} solid ${themeColor(listener, "shift-6", accentColor.get(listener))}`,
},
},
};
}
export { accordion };
</div>
<div class="block" data-tab="1">
import { type PartialElement, toState, type ValueOrState } from "@domphy/core";
import {
type ThemeColor,
themeColor,
themeDensity,
themeSize,
themeSpacing,
} from "@domphy/theme";
/**
* Styles a native disclosure widget: a themed `<summary>` header with an
* animated rotating chevron and an expand/collapse transition on the body
* content. Apply to a `<details>` element.
*
* @hostTag details
* @param props.color - Theme color tone (`ValueOrState<ThemeColor>`) for the body/summary. Defaults to "neutral".
* @param props.accentColor - Accent color (`ValueOrState<ThemeColor>`) for the summary's focus outline. Defaults to "primary".
* @param props.duration - Open/close transition duration in milliseconds. Defaults to 240.
* @example { details: [{ summary: "More" }, { div: "Body" }], $: [details()] }
*/
function details(
props: {
color?: ValueOrState<ThemeColor>;
accentColor?: ValueOrState<ThemeColor>;
duration?: number;
} = {},
): PartialElement {
const { duration = 240 } = props;
const color = toState(props.color ?? "neutral", "color");
const accentColor = toState(props.accentColor ?? "primary", "accentColor");
return {
_onInsert: (node) => {
if (node.tagName !== "details") {
console.warn(`"details" primitive patch must use details tag`);
}
},
style: {
fontSize: (listener) => themeSize(listener, "inherit"),
color: (listener) => themeColor(listener, "shift-9", color.get(listener)),
backgroundColor: (listener) =>
themeColor(listener, "inherit", color.get(listener)),
overflow: "hidden",
"& > summary": {
backgroundColor: (listener) =>
themeColor(listener, "shift-2", color.get(listener)),
color: (listener) =>
themeColor(listener, "shift-10", color.get(listener)),
fontSize: (listener) => themeSize(listener, "inherit"),
listStyle: "none",
display: "flex",
justifyContent: "space-between",
alignItems: "center",
gap: themeSpacing(2),
cursor: "pointer",
userSelect: "none",
fontWeight: 500,
paddingInline: (listener) => themeSpacing(themeDensity(listener) * 4),
height: themeSpacing(10),
},
"& > summary::-webkit-details-marker": {
display: "none",
},
"& > summary::marker": {
content: `""`,
},
"& > summary::after": {
content: `""`,
width: themeSpacing(2),
height: themeSpacing(2),
flexShrink: 0,
marginTop: `-${themeSpacing(0.5)}`,
borderInlineEnd: (listener) =>
`${themeSpacing(0.5)} solid ${themeColor(listener, "shift-9", color.get(listener))}`,
borderBottom: (listener) =>
`${themeSpacing(0.5)} solid ${themeColor(listener, "shift-9", color.get(listener))}`,
transform: "rotate(45deg)",
transition: `transform ${duration}ms ease`,
},
"&[open] > summary::after": {
transform: "rotate(-135deg)",
},
"& > summary:hover": {
backgroundColor: (listener) =>
themeColor(listener, "shift-3", color.get(listener)),
},
"& > summary:focus-visible": {
borderRadius: (listener) => themeSpacing(themeDensity(listener) * 2),
outlineOffset: `-${themeSpacing(0.5)}`,
outline: (listener) =>
`${themeSpacing(0.5)} solid ${themeColor(listener, "shift-6", accentColor.get(listener))}`,
},
"& > :not(summary)": {
maxHeight: "0px",
opacity: 0,
overflow: "hidden",
paddingInline: (listener) => themeSpacing(themeDensity(listener) * 3),
paddingTop: 0,
paddingBottom: 0,
transition: `max-height ${duration}ms ease, opacity ${duration}ms ease, padding ${duration}ms ease`,
},
"&[open] > :not(summary)": {
maxHeight: themeSpacing(250),
opacity: 1,
paddingTop: (listener) => themeSpacing(themeDensity(listener) * 1),
paddingBottom: (listener) => themeSpacing(themeDensity(listener) * 3),
},
},
};
}
export { details };
</div>
</div>