Accordion
コンテンツの各セクションの表示・非表示を切り替える見出しの積み重ね。
AccordionはAccordionのWAI-ARIAデザインパターンに従います。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root class="accordion-default-root">
<Accordion.Item value="item-1" class="accordion-default-item">
<Accordion.Header class="accordion-default-header">
<Accordion.Trigger class="accordion-default-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-default-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-default-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-default-item">
<Accordion.Header class="accordion-default-header">
<Accordion.Trigger class="accordion-default-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-default-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-default-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-default-item">
<Accordion.Header class="accordion-default-header">
<Accordion.Trigger class="accordion-default-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-default-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-default-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-default-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-default-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-default-header {
margin: 0;
}
.accordion-default-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-default-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-default-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-default-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-default-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-default-trigger[data-state="open"] .accordion-default-chevron {
transform: rotate(180deg);
}
.accordion-default-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/accordionnpm install @leve-ui/accordionyarn add @leve-ui/accordionbun add @leve-ui/accordionpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Accordion } from '@leve-ui/accordion'; // or '@leve-ui/core'
<Accordion.Root>
<Accordion.Item value="item-1">
<Accordion.Header>
<Accordion.Trigger />
</Accordion.Header>
<Accordion.Content />
</Accordion.Item>
</Accordion.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
Accordion.Root | <div> | 各項目をラップし、どの項目が開いているかを保持します。 |
Accordion.Item | <div> | valueで識別される、ヘッダーとコンテンツのペア。 |
Accordion.Header | <h1>–<h6> | Triggerをラップする見出し。levelでレベルを設定します(デフォルトは3)。 |
Accordion.Trigger | <button> | コンテンツを表示または非表示にします。 |
Accordion.Content | <div> | コンテンツのセクション。項目が閉じている間は非表示になります。 |
例#
Multiple#
type="multiple"を指定すると、複数の項目を同時に開くことができます。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './multiple.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root type="multiple" defaultValue={['item-1']} class="accordion-multiple-root">
<Accordion.Item value="item-1" class="accordion-multiple-item">
<Accordion.Header class="accordion-multiple-header">
<Accordion.Trigger class="accordion-multiple-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-multiple-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-multiple-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-multiple-item">
<Accordion.Header class="accordion-multiple-header">
<Accordion.Trigger class="accordion-multiple-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-multiple-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-multiple-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-multiple-item">
<Accordion.Header class="accordion-multiple-header">
<Accordion.Trigger class="accordion-multiple-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-multiple-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-multiple-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-multiple-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-multiple-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-multiple-header {
margin: 0;
}
.accordion-multiple-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-multiple-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-multiple-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-multiple-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-multiple-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-multiple-trigger[data-state="open"] .accordion-multiple-chevron {
transform: rotate(180deg);
}
.accordion-multiple-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Collapsible#
collapsibleを指定すると、開いている項目のTriggerを再度アクティブにして閉じることができます。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './collapsible.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root collapsible defaultValue={['item-1']} class="accordion-collapsible-root">
<Accordion.Item value="item-1" class="accordion-collapsible-item">
<Accordion.Header class="accordion-collapsible-header">
<Accordion.Trigger class="accordion-collapsible-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-collapsible-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-collapsible-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.{' '}
<a href="#learn-more" class="accordion-collapsible-link">
Learn more about leve-ui
</a>
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-collapsible-item">
<Accordion.Header class="accordion-collapsible-header">
<Accordion.Trigger class="accordion-collapsible-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-collapsible-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-collapsible-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-collapsible-item">
<Accordion.Header class="accordion-collapsible-header">
<Accordion.Trigger class="accordion-collapsible-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-collapsible-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-collapsible-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-collapsible-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-collapsible-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-collapsible-header {
margin: 0;
}
.accordion-collapsible-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-collapsible-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-collapsible-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-collapsible-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-collapsible-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-collapsible-trigger[data-state="open"] .accordion-collapsible-chevron {
transform: rotate(180deg);
}
.accordion-collapsible-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.accordion-collapsible-link {
color: light-dark(#006ce9, #4cb8ff);
text-decoration: underline;
}
.accordion-collapsible-link:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}Disabled#
Accordion.Itemにdisabledを指定するとその項目が無効化されます。Rootにdisabledを指定するとすべての項目が無効化されます。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './disabled.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Accordion.Root class="accordion-disabled-root">
<Accordion.Item value="item-1" class="accordion-disabled-item">
<Accordion.Header class="accordion-disabled-header">
<Accordion.Trigger class="accordion-disabled-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-disabled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-disabled-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" disabled class="accordion-disabled-item">
<Accordion.Header class="accordion-disabled-header">
<Accordion.Trigger class="accordion-disabled-trigger">
<span>Is it accessible? (Disabled)</span>
<LuChevronDown class="accordion-disabled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-disabled-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and keyboard
interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-disabled-item">
<Accordion.Header class="accordion-disabled-header">
<Accordion.Trigger class="accordion-disabled-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-disabled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-disabled-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS, Tailwind,
or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
);
});.accordion-disabled-root {
width: 320px;
max-width: 100%;
font-family: inherit;
}
.accordion-disabled-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-disabled-header {
margin: 0;
}
.accordion-disabled-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-disabled-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-disabled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-disabled-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-disabled-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-disabled-trigger[data-state="open"] .accordion-disabled-chevron {
transform: rotate(180deg);
}
.accordion-disabled-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Controlled#
外部から開いている項目を読み取ったり変更したりするには、シグナルをbind:valueに渡します。
Open items: item-1
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Accordion } from '@leve-ui/accordion';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './controlled.css?inline';
export default component$(() => {
useStyles$(styles);
const openValues = useSignal<string[]>(['item-1']);
return (
<div class="accordion-controlled-wrapper">
<Accordion.Root collapsible bind:value={openValues} class="accordion-controlled-root">
<Accordion.Item value="item-1" class="accordion-controlled-item">
<Accordion.Header class="accordion-controlled-header">
<Accordion.Trigger class="accordion-controlled-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="accordion-controlled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-controlled-content">
leve-ui is a headless UI component library built for Qwik with full WAI-ARIA compliance.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-2" class="accordion-controlled-item">
<Accordion.Header class="accordion-controlled-header">
<Accordion.Trigger class="accordion-controlled-trigger">
<span>Is it accessible?</span>
<LuChevronDown class="accordion-controlled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-controlled-content">
Yes, all components follow WAI-ARIA Authoring Practices Guide (APG) patterns and
keyboard interactions.
</Accordion.Content>
</Accordion.Item>
<Accordion.Item value="item-3" class="accordion-controlled-item">
<Accordion.Header class="accordion-controlled-header">
<Accordion.Trigger class="accordion-controlled-trigger">
<span>Can I customize the styles?</span>
<LuChevronDown class="accordion-controlled-chevron" aria-hidden="true" />
</Accordion.Trigger>
</Accordion.Header>
<Accordion.Content class="accordion-controlled-content">
Yes, leve-ui components are headless and unstyled. You can style them using CSS,
Tailwind, or any CSS-in-JS library.
</Accordion.Content>
</Accordion.Item>
</Accordion.Root>
<p class="accordion-controlled-status">
Open items: {openValues.value.length > 0 ? openValues.value.join(', ') : 'none'}
</p>
</div>
);
});.accordion-controlled-wrapper {
display: flex;
flex-direction: column;
gap: 12px;
font-family: inherit;
}
.accordion-controlled-root {
width: 320px;
max-width: 100%;
}
.accordion-controlled-item {
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.accordion-controlled-header {
margin: 0;
}
.accordion-controlled-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 12px 2px;
background: none;
border: none;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.accordion-controlled-trigger:hover:not([data-disabled]) {
color: light-dark(#006ce9, #4cb8ff);
}
.accordion-controlled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.accordion-controlled-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the item is open */
.accordion-controlled-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.accordion-controlled-trigger[data-state="open"] .accordion-controlled-chevron {
transform: rotate(180deg);
}
.accordion-controlled-content {
padding: 0 2px 12px;
font-size: 14px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.accordion-controlled-status {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| type | 'single' | 'single' | 'multiple' 同時に開くことができるアイテムの数。
- |
| defaultValue | [] | string[] 初期状態で開いているアイテムの値(非制御)。 |
| bind:value | – | Signal<string[]> 開いているアイテムの値を保持するシグナル(制御)。 |
| onValueChange$ | – | QRL<(value: string[]) => void> ユーザーがアイテムを開閉したときに呼び出されます。 |
| collapsible | false | boolean
|
| disabled | false | boolean すべてのアイテムを無効化します。 |
| orientation | 'vertical' | 'vertical' | 'horizontal' Accordionの向き。フォーカスを移動する矢印キーを決定します。 |
| loop | true | boolean 矢印キーで最後のTriggerから最初のTriggerへ、またはその逆へループするかどうか。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-accordion | 常に存在 |
data-orientation | "vertical" | "horizontal" |
data-disabled | Rootが無効化されている場合に存在 |
開いている項目はdefaultValueでは非制御、bind:valueでは制御されます。ユーザーが項目を開閉するとonValueChange$が呼び出されます。
Item#
| Prop | デフォルト | 型 |
|---|---|---|
| value (必須) | – | string このアイテムを識別する一意の値。 |
| disabled | false | boolean このアイテムを無効化します。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-accordion-item | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 項目またはRootが無効化されている場合に存在 |
data-orientation | "vertical" | "horizontal" |
Header#
| Prop | デフォルト | 型 |
|---|---|---|
| level | 3 | 1 | 2 | 3 | 4 | 5 | 6 Triggerをラップする要素の見出しレベル(1〜6)。 |
すべての<h1>–<h6>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-accordion-header | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 項目が無効化されている場合に存在 |
data-orientation | "vertical" | "horizontal" |
Trigger#
独自のpropはありません。 すべての<button>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-accordion-trigger | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 項目が無効化されている場合に存在 |
data-orientation | "vertical" | "horizontal" |
無効化された項目のTriggerにはネイティブのdisabled属性が付与されます。
Content#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-accordion-content | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 項目が無効化されている場合に存在 |
data-orientation | "vertical" | "horizontal" |
コンテンツは、項目が閉じている間hidden属性を持ちます。Triggerのaria-controlsが参照し続けられるよう、DOM内に留まります。
アクセシビリティ#
Accordion WAI-ARIAデザインパターンに準拠しています。
Accordion.Triggerは<button type="button">であり、そのコンテンツを指すaria-expandedとaria-controlsを持ちます。Accordion.Contentはrole="region"と、トリガーを指すaria-labelledbyを持ちます。IDはuseId()で生成されます。- ページのヘッダー構造に合った
Accordion.Headerのlevelを選択してください。 typeが"single"かつcollapsibleがfalseの場合、開いているアイテムのトリガーは閉じることができないため、aria-disabled="true"を持ちます。- 無効化されたトリガーは、Tabおよび矢印キーによってスキップされます。
キーボード操作#
| キー | 説明 |
|---|---|
Enter / Space | フォーカスされているトリガーのアイテムを開閉します。 |
Tab / Shift+Tab | 次または前のフォーカス可能な要素にフォーカスを移動します。 |
ArrowDown / ArrowUp | orientationが"vertical"の場合、次または前のトリガーにフォーカスを移動します。 |
ArrowRight / ArrowLeft | orientationが"horizontal"の場合、次または前のトリガーにフォーカスを移動します(右から左のテキストでは逆になります)。 |
Home / End | 最初または最後のトリガーにフォーカスを移動します。 |
loopがtrue(デフォルト)の場合、矢印キー操作は最後のトリガーから最初へ、また最初から最後へとループします。