ドキュメントを検索

Tabs

一度に1つずつ表示される、コンテンツのレイヤー化されたパネルです。

Tabsは、自動または手動のアクティベーションを備えたTabs WAI-ARIAデザインパターンに準拠しています。

Manage your account details and profile information.
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>
  );
});

インストール#

個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。

pnpm add @leve-ui/tabs

構造#

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はシグナルで選択されたタブを制御します。タブの外側にあるボタンで変更します。

External controls:
Panel 1 content (controlled by signal).

無効なTrigger#

Triggerのdisabledはそのタブを無効化します。矢印キーはそれをスキップします。

Panel 1: Navigating with arrow keys skips the disabled tab.

手動#

activationMode="manual"を使用すると、矢印キーはフォーカスのみを移動します。EnterまたはSpaceを押して、フォーカスされているタブを選択します。

Panel 1: In manual mode, arrow keys move focus without changing the active panel.

垂直方向#

orientation="vertical"を指定すると、ArrowLeft / ArrowRightの代わりにArrowUp / ArrowDownでタブ間を移動するようになります。aria-orientationとdata-orientationを設定します。

Profile details and public information.

APIリファレンス#

Root#

Propデフォルト型
defaultValuenullstring | null

初期選択されるタブの値(非制御)。

bind:value–Signal<string | null> | Signal<string>

選択されたタブの値を保持するシグナル(制御)。

onValueChange$–QRL<(value: string) => void>

選択されたタブが変更されたときに呼び出されます。

orientation'horizontal''horizontal' | 'vertical'

タブリストの向き。

activationMode'automatic''automatic' | 'manual'

タブの選択方法。 - 'automatic':フォーカスを受け取ったときに選択されます - 'manual':フォーカスのみが移動し、EnterまたはSpaceで選択します

looptrueboolean

矢印キーで最後のタブから最初のタブへ、またはその逆にラップするかどうか。

すべての<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>

<button>の代わりにレンダリングする要素またはコンポーネントです。コンポーネントは受け取ったpropsを1つの要素にスプレッドする必要があります。

value (必須)–string

タブを識別する一意の値。対応するContentのvalueと一致する必要があります。

disabledfalseboolean

タブを無効化します。

すべての<button>属性も受け入れます。

データ属性値
data-leve-tabs-trigger常に存在
data-state"active" | "inactive"
data-disabled無効時に存在
data-orientation"horizontal" | "vertical"

Content#

Propデフォルト型
value (必須)–string

このパネルを表示するTriggerのvalue。

すべての<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の動作が逆になります。