Collapsible
コンテンツのセクションを表示または非表示にするボタン。
CollapsibleはDisclosure (Show/Hide) WAI-ARIAデザインパターンに準拠しています。
Yes! It is headless, fully accessible, and styled with plain CSS.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Collapsible } from '@leve-ui/collapsible';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Collapsible.Root class="collapsible-default-root">
<Collapsible.Trigger class="collapsible-default-trigger">
<span>Can I use this component in my project?</span>
<LuChevronDown class="collapsible-default-chevron" aria-hidden="true" />
</Collapsible.Trigger>
<Collapsible.Content class="collapsible-default-content">
Yes! It is headless, fully accessible, and styled with plain CSS.
</Collapsible.Content>
</Collapsible.Root>
);
});.collapsible-default-root {
display: flex;
flex-direction: column;
gap: 8px;
width: 320px;
font-family: inherit;
}
.collapsible-default-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 10px 14px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.collapsible-default-trigger:hover:not(:disabled) {
background: light-dark(#f1f5f9, #ffffff14);
}
.collapsible-default-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.collapsible-default-trigger:disabled {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the collapsible is open */
.collapsible-default-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.collapsible-default-trigger[data-state="open"] .collapsible-default-chevron {
transform: rotate(180deg);
}
.collapsible-default-content {
padding: 10px 14px;
border-radius: 6px;
background: light-dark(#f1f5f9, #ffffff14);
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/collapsiblenpm install @leve-ui/collapsibleyarn add @leve-ui/collapsiblebun add @leve-ui/collapsiblepnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Collapsible } from '@leve-ui/collapsible'; // or '@leve-ui/core'
<Collapsible.Root>
<Collapsible.Trigger />
<Collapsible.Content />
</Collapsible.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
Collapsible.Root | <div> | 各パーツをラップし、開閉状態を保持します。 |
Collapsible.Trigger | <button> | コンテンツを開閉するボタン。 |
Collapsible.Content | <div> | 表示または非表示にされるコンテンツ。 |
例#
開く#
defaultOpenはコンテンツを初期状態で開きます。
A headless, accessible UI component library built for Qwik.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Collapsible } from '@leve-ui/collapsible';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './open.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Collapsible.Root defaultOpen class="collapsible-open-root">
<Collapsible.Trigger class="collapsible-open-trigger">
<span>What is leve-ui?</span>
<LuChevronDown class="collapsible-open-chevron" aria-hidden="true" />
</Collapsible.Trigger>
<Collapsible.Content class="collapsible-open-content">
A headless, accessible UI component library built for Qwik.
</Collapsible.Content>
</Collapsible.Root>
);
});.collapsible-open-root {
display: flex;
flex-direction: column;
gap: 8px;
width: 320px;
font-family: inherit;
}
.collapsible-open-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 10px 14px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.collapsible-open-trigger:hover:not(:disabled) {
background: light-dark(#f1f5f9, #ffffff14);
}
.collapsible-open-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.collapsible-open-trigger:disabled {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the collapsible is open */
.collapsible-open-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.collapsible-open-trigger[data-state="open"] .collapsible-open-chevron {
transform: rotate(180deg);
}
.collapsible-open-content {
padding: 10px 14px;
border-radius: 6px;
background: light-dark(#f1f5f9, #ffffff14);
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Disabled#
Rootのdisabledはトリガーを無効化するため、コンテンツを開閉できなくなります。
This content cannot be toggled because the collapsible is disabled.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Collapsible } from '@leve-ui/collapsible';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './disabled.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Collapsible.Root disabled class="collapsible-disabled-root">
<Collapsible.Trigger class="collapsible-disabled-trigger">
<span>Disabled section</span>
<LuChevronDown class="collapsible-disabled-chevron" aria-hidden="true" />
</Collapsible.Trigger>
<Collapsible.Content class="collapsible-disabled-content">
This content cannot be toggled because the collapsible is disabled.
</Collapsible.Content>
</Collapsible.Root>
);
});.collapsible-disabled-root {
display: flex;
flex-direction: column;
gap: 8px;
width: 320px;
font-family: inherit;
}
.collapsible-disabled-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 10px 14px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.collapsible-disabled-trigger:hover:not(:disabled) {
background: light-dark(#f1f5f9, #ffffff14);
}
.collapsible-disabled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.collapsible-disabled-trigger:disabled {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the collapsible is open */
.collapsible-disabled-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.collapsible-disabled-trigger[data-state="open"] .collapsible-disabled-chevron {
transform: rotate(180deg);
}
.collapsible-disabled-content {
padding: 10px 14px;
border-radius: 6px;
background: light-dark(#f1f5f9, #ffffff14);
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}Controlled#
bind:openはシグナルで開閉状態を制御するため、Collapsibleの外部にあるボタンから開閉できます。
This collapsible state is controlled by an external signal.
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Collapsible } from '@leve-ui/collapsible';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './controlled.css?inline';
export default component$(() => {
useStyles$(styles);
const open = useSignal(false);
return (
<div class="collapsible-controlled-wrapper">
<button
type="button"
class="collapsible-controlled-external-button"
onClick$={() => {
open.value = !open.value;
}}
>
{open.value ? 'Close' : 'Open'} from outside
</button>
<Collapsible.Root bind:open={open} class="collapsible-controlled-root">
<Collapsible.Trigger class="collapsible-controlled-trigger">
<span>Controlled collapsible</span>
<LuChevronDown class="collapsible-controlled-chevron" aria-hidden="true" />
</Collapsible.Trigger>
<Collapsible.Content class="collapsible-controlled-content">
This collapsible state is controlled by an external signal.
</Collapsible.Content>
</Collapsible.Root>
</div>
);
});.collapsible-controlled-wrapper {
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
font-family: inherit;
}
.collapsible-controlled-external-button {
height: 32px;
padding: 0 12px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
color: light-dark(#0f172a, #ffffff);
font: inherit;
font-size: 13px;
font-weight: 500;
cursor: pointer;
}
.collapsible-controlled-external-button:hover {
background: light-dark(#f1f5f9, #ffffff14);
}
.collapsible-controlled-external-button:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.collapsible-controlled-root {
display: flex;
flex-direction: column;
gap: 8px;
width: 320px;
}
.collapsible-controlled-trigger {
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
padding: 10px 14px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
text-align: left;
cursor: pointer;
}
.collapsible-controlled-trigger:hover:not(:disabled) {
background: light-dark(#f1f5f9, #ffffff14);
}
.collapsible-controlled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.collapsible-controlled-trigger:disabled {
opacity: 0.5;
cursor: not-allowed;
}
/* Rotate the chevron while the collapsible is open */
.collapsible-controlled-chevron {
flex-shrink: 0;
width: 16px;
height: 16px;
color: light-dark(#475569, #c9ddf0);
transition: transform 200ms ease;
}
.collapsible-controlled-trigger[data-state="open"] .collapsible-controlled-chevron {
transform: rotate(180deg);
}
.collapsible-controlled-content {
padding: 10px 14px;
border-radius: 6px;
background: light-dark(#f1f5f9, #ffffff14);
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| ids | – | { trigger?: string; content?: string } パーツの要素IDをオーバーライドします。 |
| defaultOpen | false | boolean コンテンツが初期状態で開いているかどうか(非制御)。 |
| bind:open | – | Signal<boolean> 開閉状態を保持するシグナル(制御)。 |
| onOpenChange$ | – | QRL<(open: boolean) => void> ユーザーがコンテンツを開閉したときに呼び出されます。 |
| disabled | false | boolean Triggerを無効化します。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-collapsible | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 無効時に存在 |
開閉状態はdefaultOpenで非制御に、bind:openで制御できます。ユーザーがコンテンツを開閉するとonOpenChange$が呼び出されます。
Trigger#
独自のpropはありません。 すべての<button>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-collapsible-trigger | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 無効時に存在 |
Rootが無効化されている場合、トリガーにはネイティブのdisabled属性が付与されます。
Content#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-collapsible-content | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 無効時に存在 |
コンテンツが閉じている間、hidden属性が付与されます。トリガーのaria-controlsが参照し続けられるよう、DOM内に留まります。
アクセシビリティ#
Disclosure (Show/Hide) WAI-ARIAデザインパターンに準拠しています。
Collapsible.Triggerは、コンテンツを指すaria-expandedとaria-controlsを持つ<button type="button">です。IDはuseId()で生成されるか、Rootのidsで設定されます。- トリガーの名前はそのテキストによって決まります。アイコンのみを含む場合は、
aria-labelを指定してください。 - 無効化されたトリガーはTabでスキップされます。
キーボード操作#
| キー | 説明 |
|---|---|
Enter / Space | コンテンツを開閉します。 |