ドキュメントを検索

Fieldset

関連するフォームコントロールをlegendの下にグループ化します。

fieldsetに関するWAI-ARIA APGパターンはありません。Fieldsetはネイティブの<fieldset>要素および<legend>要素をレンダリングするため、グループはrole="group"を取得し、そのlegendによって名前が付けられます。

Shipping method
import { component$, useStyles$ } from '@builder.io/qwik';
import { Fieldset } from '@leve-ui/fieldset';
import styles from './default.css?inline';

export default component$(() => {
  useStyles$(styles);

  return (
    <Fieldset.Root class="fieldset-default">
      <Fieldset.Legend class="fieldset-default-legend">Shipping method</Fieldset.Legend>
      <label class="fieldset-default-option">
        <input class="fieldset-default-radio" type="radio" name="shipping" value="standard" />{' '}
        Standard
      </label>
      <label class="fieldset-default-option">
        <input class="fieldset-default-radio" type="radio" name="shipping" value="express" />{' '}
        Express
      </label>
    </Fieldset.Root>
  );
});

インストール#

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

pnpm add @leve-ui/fieldset

構造#

import { Fieldset } from '@leve-ui/fieldset'; // or '@leve-ui/core'

<Fieldset.Root>
  <Fieldset.Legend />
</Fieldset.Root>
パーツ要素説明
Fieldset.Root<fieldset>フォームコントロールをグループ化します。
Fieldset.Legend<legend>グループのラベル。Rootの最初の子として配置します。

例#

Disabled#

Rootのdisabledは、ネイティブの<fieldset disabled>と同様に、内部のすべてのフォームコントロールを無効化します。内部にあるleve-uiのコントロール(Checkbox、Switch、Radio Group、Toggle、Toggle Group、Field)も無効化され、data-disabledを描画してクリックを無視します。HTMLと同様に、Legend内のコントロールはそのFieldsetによって無効化されることはなく、ネストされたFieldsetは祖先が無効化されている場合に無効化されます。

Notifications

APIリファレンス#

Root#

独自のpropはありません。 すべての<fieldset>属性を受け入れます。

データ属性値
data-leve-fieldset常に存在
data-disabled無効時に存在

disabledを含むすべてのpropsは、ネイティブの<fieldset>に渡されます。

Legend#

独自のpropはありません。 すべての<legend>属性を受け入れます。

データ属性値
data-leve-fieldset-legend常に存在
data-disabledRootが無効化されている場合に存在

アクセシビリティ#

  • ネイティブの<fieldset>は暗黙のrole="group"を持ち、Fieldset.Legendがグループのアクセシブルな名前を提供します。
  • Rootが無効化されると、その内部のコントロールは無効化され、Tabキーによってスキップされます。ネイティブコントロールはブラウザによって、leve-uiコントロールはFieldsetを通じてスキップされます。
  • Fieldset自体にはキーボード操作はありません。