Tabs
一度に1つずつ表示される、コンテンツのレイヤー化されたパネルです。
Tabsは、自動または手動のアクティベーションを備えたTabs WAI-ARIAデザインパターンに準拠しています。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Tabs } from '@leve-ui/tabs';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Tabs.Root defaultValue="tab1" class="tabs-default-root">
<Tabs.List aria-label="Account settings" class="tabs-default-list">
<Tabs.Trigger value="tab1" class="tabs-default-trigger">
Account
</Tabs.Trigger>
<Tabs.Trigger value="tab2" class="tabs-default-trigger">
Password
</Tabs.Trigger>
<Tabs.Trigger value="tab3" class="tabs-default-trigger">
Settings
</Tabs.Trigger>
</Tabs.List>
<Tabs.Content value="tab1" class="tabs-default-content">
Manage your account details and profile information.
</Tabs.Content>
<Tabs.Content value="tab2" class="tabs-default-content">
Change your password and manage authentication settings.
</Tabs.Content>
<Tabs.Content value="tab3" class="tabs-default-content">
Configure application preferences and notification options.
</Tabs.Content>
</Tabs.Root>
);
});.tabs-default-root {
width: 360px;
max-width: 100%;
font-family: inherit;
font-size: 14px;
}
.tabs-default-list {
display: flex;
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.tabs-default-trigger {
margin-bottom: -1px;
padding: 8px 12px;
background: none;
border: none;
border-bottom: 2px solid transparent;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#475569, #c9ddf0);
cursor: pointer;
}
.tabs-default-trigger:hover {
color: light-dark(#0f172a, #ffffff);
}
/* Selected tab */
.tabs-default-trigger[data-state="active"] {
color: light-dark(#0f172a, #ffffff);
border-bottom-color: #009dfd;
}
.tabs-default-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.tabs-default-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
.tabs-default-content {
padding-top: 14px;
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.tabs-default-content:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/tabsnpm install @leve-ui/tabsyarn add @leve-ui/tabsbun add @leve-ui/tabspnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Tabs } from '@leve-ui/tabs'; // or '@leve-ui/core'
<Tabs.Root>
<Tabs.List>
<Tabs.Trigger />
</Tabs.List>
<Tabs.Content />
</Tabs.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
Tabs.Root | <div> | パーツをラップし、選択された値を保持します。 |
Tabs.List | <div> | タブのリストで、role="tablist"を持ちます。 |
Tabs.Trigger | <button> | role="tab"を持つ1つのタブです。同じvalueを持つContentを選択します。別の要素やコンポーネントをレンダリングするにはasを使用します。 |
Tabs.Content | <div> | タブのパネルで、role="tabpanel"を持ちます。常にレンダリングされ、そのタブが選択されていない間は非表示になります。 |
Tabs.Triggerのasに渡されるコンポーネントは、id、aria-*、data-*、およびon*$イベントハンドラーを含め、受け取ったpropsを単一の要素に展開する必要があります。
例#
Controlled#
bind:valueはシグナルで選択されたタブを制御します。タブの外側にあるボタンで変更します。
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Tabs } from '@leve-ui/tabs';
import styles from './controlled.css?inline';
export default component$(() => {
useStyles$(styles);
const selected = useSignal<string | null>('tab1');
return (
<div class="tabs-controlled-wrapper">
<div class="tabs-controlled-controls">
<span class="tabs-controlled-label">External controls:</span>
<button
type="button"
class="tabs-controlled-btn"
onClick$={() => {
selected.value = 'tab1';
}}
>
Select Tab 1
</button>
<button
type="button"
class="tabs-controlled-btn"
onClick$={() => {
selected.value = 'tab2';
}}
>
Select Tab 2
</button>
</div>
<Tabs.Root bind:value={selected} class="tabs-controlled-root">
<Tabs.List aria-label="Controlled tabs" class="tabs-controlled-list">
<Tabs.Trigger value="tab1" class="tabs-controlled-trigger">
First
</Tabs.Trigger>
<Tabs.Trigger value="tab2" class="tabs-controlled-trigger">
Second
</Tabs.Trigger>
<Tabs.Trigger value="tab3" class="tabs-controlled-trigger">
Third
</Tabs.Trigger>
</Tabs.List>
<Tabs.Content value="tab1" class="tabs-controlled-content">
Panel 1 content (controlled by signal).
</Tabs.Content>
<Tabs.Content value="tab2" class="tabs-controlled-content">
Panel 2 content (controlled by signal).
</Tabs.Content>
<Tabs.Content value="tab3" class="tabs-controlled-content">
Panel 3 content (controlled by signal).
</Tabs.Content>
</Tabs.Root>
</div>
);
});.tabs-controlled-wrapper {
display: flex;
flex-direction: column;
gap: 12px;
font-family: inherit;
font-size: 14px;
}
.tabs-controlled-controls {
display: flex;
align-items: center;
gap: 8px;
}
.tabs-controlled-label {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}
/* Secondary button */
.tabs-controlled-btn {
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;
}
.tabs-controlled-btn:hover {
background: light-dark(#f1f5f9, #ffffff14);
}
.tabs-controlled-btn:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.tabs-controlled-root {
width: 360px;
max-width: 100%;
}
.tabs-controlled-list {
display: flex;
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.tabs-controlled-trigger {
margin-bottom: -1px;
padding: 8px 12px;
background: none;
border: none;
border-bottom: 2px solid transparent;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#475569, #c9ddf0);
cursor: pointer;
}
.tabs-controlled-trigger:hover {
color: light-dark(#0f172a, #ffffff);
}
/* Selected tab */
.tabs-controlled-trigger[data-state="active"] {
color: light-dark(#0f172a, #ffffff);
border-bottom-color: #009dfd;
}
.tabs-controlled-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.tabs-controlled-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
.tabs-controlled-content {
padding-top: 14px;
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.tabs-controlled-content:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}無効なTrigger#
Triggerのdisabledはそのタブを無効化します。矢印キーはそれをスキップします。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Tabs } from '@leve-ui/tabs';
import styles from './disabled-trigger.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Tabs.Root defaultValue="tab1" class="tabs-disabled-trigger-root">
<Tabs.List aria-label="Tabs with disabled item" class="tabs-disabled-trigger-list">
<Tabs.Trigger value="tab1" class="tabs-disabled-trigger-trigger">
Available
</Tabs.Trigger>
<Tabs.Trigger value="tab2" disabled class="tabs-disabled-trigger-trigger">
Disabled
</Tabs.Trigger>
<Tabs.Trigger value="tab3" class="tabs-disabled-trigger-trigger">
Also Available
</Tabs.Trigger>
</Tabs.List>
<Tabs.Content value="tab1" class="tabs-disabled-trigger-content">
Panel 1: Navigating with arrow keys skips the disabled tab.
</Tabs.Content>
<Tabs.Content value="tab2" class="tabs-disabled-trigger-content">
Panel 2: This panel cannot be selected by the user.
</Tabs.Content>
<Tabs.Content value="tab3" class="tabs-disabled-trigger-content">
Panel 3: Reached directly from the first tab.
</Tabs.Content>
</Tabs.Root>
);
});.tabs-disabled-trigger-root {
width: 360px;
max-width: 100%;
font-family: inherit;
font-size: 14px;
}
.tabs-disabled-trigger-list {
display: flex;
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.tabs-disabled-trigger-trigger {
margin-bottom: -1px;
padding: 8px 12px;
background: none;
border: none;
border-bottom: 2px solid transparent;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#475569, #c9ddf0);
cursor: pointer;
}
.tabs-disabled-trigger-trigger:hover {
color: light-dark(#0f172a, #ffffff);
}
/* Selected tab */
.tabs-disabled-trigger-trigger[data-state="active"] {
color: light-dark(#0f172a, #ffffff);
border-bottom-color: #009dfd;
}
.tabs-disabled-trigger-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.tabs-disabled-trigger-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
.tabs-disabled-trigger-content {
padding-top: 14px;
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.tabs-disabled-trigger-content:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}手動#
activationMode="manual"を使用すると、矢印キーはフォーカスのみを移動します。EnterまたはSpaceを押して、フォーカスされているタブを選択します。
import { $, component$, type PropsOf, Slot, sync$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Tabs } from '@leve-ui/tabs';
import styles from './manual.css?inline';
// Example of a router link component (such as Qwik City's <Link>) that spreads received props onto <a>
const ClientTabLink = component$<PropsOf<'a'>>(({ onClick$, ...props }) => {
const visited = useSignal(false);
const preventDefault$ = sync$((event: MouseEvent) => {
event.preventDefault();
});
const handleClick$ = $(() => {
visited.value = true;
});
return (
<a
{...props}
data-visited={visited.value ? 'true' : undefined}
onClick$={[preventDefault$, handleClick$, onClick$]}
>
<Slot />
</a>
);
});
export default component$(() => {
useStyles$(styles);
return (
<Tabs.Root activationMode="manual" defaultValue="tab1" class="tabs-manual-root">
<Tabs.List aria-label="Manual activation tabs" class="tabs-manual-list">
<Tabs.Trigger as={ClientTabLink} href="#first" value="tab1" class="tabs-manual-trigger">
First
</Tabs.Trigger>
<Tabs.Trigger as={ClientTabLink} href="#second" value="tab2" class="tabs-manual-trigger">
Second
</Tabs.Trigger>
<Tabs.Trigger as={ClientTabLink} href="#third" value="tab3" class="tabs-manual-trigger">
Third
</Tabs.Trigger>
</Tabs.List>
<Tabs.Content value="tab1" class="tabs-manual-content">
Panel 1: In manual mode, arrow keys move focus without changing the active panel.
</Tabs.Content>
<Tabs.Content value="tab2" class="tabs-manual-content">
Panel 2: Press Enter or Space to activate the focused tab.
</Tabs.Content>
<Tabs.Content value="tab3" class="tabs-manual-content">
Panel 3: Active panel updated.
</Tabs.Content>
</Tabs.Root>
);
});.tabs-manual-root {
width: 360px;
max-width: 100%;
font-family: inherit;
font-size: 14px;
}
.tabs-manual-list {
display: flex;
border-bottom: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.tabs-manual-trigger {
display: inline-block;
margin-bottom: -1px;
padding: 8px 12px;
background: none;
border: none;
border-bottom: 2px solid transparent;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#475569, #c9ddf0);
text-decoration: none;
cursor: pointer;
}
.tabs-manual-trigger:hover {
color: light-dark(#0f172a, #ffffff);
}
/* Selected tab */
.tabs-manual-trigger[data-state="active"] {
color: light-dark(#0f172a, #ffffff);
border-bottom-color: #009dfd;
}
.tabs-manual-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.tabs-manual-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
.tabs-manual-content {
padding-top: 14px;
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.tabs-manual-content:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}垂直方向#
orientation="vertical"を指定すると、ArrowLeft / ArrowRightの代わりにArrowUp / ArrowDownでタブ間を移動するようになります。aria-orientationとdata-orientationを設定します。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Tabs } from '@leve-ui/tabs';
import styles from './vertical.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Tabs.Root orientation="vertical" defaultValue="tab1" class="tabs-vertical-root">
<Tabs.List aria-label="Vertical navigation" class="tabs-vertical-list">
<Tabs.Trigger value="tab1" class="tabs-vertical-trigger">
Profile
</Tabs.Trigger>
<Tabs.Trigger value="tab2" class="tabs-vertical-trigger">
Billing
</Tabs.Trigger>
<Tabs.Trigger value="tab3" class="tabs-vertical-trigger">
Notifications
</Tabs.Trigger>
</Tabs.List>
<Tabs.Content value="tab1" class="tabs-vertical-content">
Profile details and public information.
</Tabs.Content>
<Tabs.Content value="tab2" class="tabs-vertical-content">
Billing history and subscription plan.
</Tabs.Content>
<Tabs.Content value="tab3" class="tabs-vertical-content">
Notification preferences and email alerts.
</Tabs.Content>
</Tabs.Root>
);
});.tabs-vertical-root {
display: flex;
gap: 16px;
width: 360px;
max-width: 100%;
font-family: inherit;
font-size: 14px;
}
.tabs-vertical-list {
display: flex;
flex-direction: column;
border-right: 1px solid light-dark(#e2e8f0, #ffffff1f);
}
.tabs-vertical-trigger {
margin: 0 -1px 0 0;
padding: 8px 12px;
background: none;
border: none;
border-right: 2px solid transparent;
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#475569, #c9ddf0);
text-align: left;
cursor: pointer;
}
.tabs-vertical-trigger:hover {
color: light-dark(#0f172a, #ffffff);
}
/* Selected tab */
.tabs-vertical-trigger[data-state="active"] {
color: light-dark(#0f172a, #ffffff);
border-right-color: #009dfd;
}
.tabs-vertical-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.tabs-vertical-trigger[data-disabled] {
opacity: 0.5;
cursor: not-allowed;
}
.tabs-vertical-content {
padding-top: 8px;
font-size: 13px;
line-height: 1.6;
color: light-dark(#475569, #c9ddf0);
}
.tabs-vertical-content:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| defaultValue | null | string | null 初期選択されるタブの値(非制御)。 |
| bind:value | – | Signal<string | null> | Signal<string> 選択されたタブの値を保持するシグナル(制御)。 |
| onValueChange$ | – | QRL<(value: string) => void> 選択されたタブが変更されたときに呼び出されます。 |
| orientation | 'horizontal' | 'horizontal' | 'vertical' タブリストの向き。 |
| activationMode | 'automatic' | 'automatic' | 'manual' タブの選択方法。
- |
| loop | true | boolean 矢印キーで最後のタブから最初のタブへ、またはその逆にラップするかどうか。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-tabs | 常に存在 |
data-orientation | "horizontal" | "vertical" |
選択された値はdefaultValueで非制御、またはbind:valueで制御できます。onValueChange$は、選択されたタブが変更されたときに呼び出されます。各Triggerと対応するContentに同じvalueを指定してください。
List#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-tabs-list | 常に存在 |
data-orientation | "horizontal" | "vertical" |
Trigger#
| Prop | デフォルト | 型 |
|---|---|---|
| as | 'button' | keyof HTMLElementTagNameMap | Component<any>
|
| value (必須) | – | string タブを識別する一意の値。対応するContentの |
| disabled | false | boolean タブを無効化します。 |
すべての<button>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-tabs-trigger | 常に存在 |
data-state | "active" | "inactive" |
data-disabled | 無効時に存在 |
data-orientation | "horizontal" | "vertical" |
Content#
| Prop | デフォルト | 型 |
|---|---|---|
| value (必須) | – | string このパネルを表示するTriggerの |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-tabs-content | 常に存在 |
data-state | "active" | "inactive" |
data-orientation | "horizontal" | "vertical" |
そのタブが選択されていない間、Contentにはhidden属性が付与されます。
アクセシビリティ#
Tabs WAI-ARIAデザインパターンに準拠しています。
Tabs.List上のaria-labelまたはaria-labelledbyでタブリストに名前を付けます。Tabs.Listはrole="tablist"とaria-orientationをレンダリングします。- 各
Tabs.Triggerはrole="tab"、aria-selected、および対応するContentを指すaria-controlsを持つ<button type="button">です。そのテキストコンテンツがアクセシブルな名前になります。無効化されたタブはネイティブのdisabled属性を使用するため、フォーカスを受け取りません。 - 各
Tabs.Contentはrole="tabpanel"と対応するTriggerを指すaria-labelledbyをレンダリングします。tabIndex={0}を持つため、パネル自体がフォーカスを受け取ることができます。 - タブシーケンスに含まれるタブは1つだけです。選択されているタブ、または何も選択されていない場合は有効な最初のタブです。
キーボード操作#
| キー | 説明 |
|---|---|
Tab | 選択されているタブにフォーカスを移動します。タブにフォーカスがある場合、選択されているパネルにフォーカスを移動します。 |
ArrowRight / ArrowLeft | 水平方向のみ。次の/前の有効なタブにフォーカスを移動し、自動モードではそれを選択します。loopがtrueの場合は先頭/末尾をループします。 |
ArrowDown / ArrowUp | 垂直方向のみ。次の/前の有効なタブにフォーカスを移動し、自動モードではそれを選択します。loopがtrueの場合は先頭/末尾をループします。 |
Home | 有効な最初のタブにフォーカスを移動し、自動モードではそれを選択します。 |
End | 有効な最後のタブにフォーカスを移動し、自動モードではそれを選択します。 |
Enter / Space | フォーカスされているタブを選択します(手動モード)。 |
右から左(RTL)のテキストでは、ArrowRightとArrowLeftの動作が逆になります。