ドキュメントを検索

Label

フォームコントロールのラベルです。

ラベル用のWAI-ARIA APGパターンはありません。Labelはネイティブの<label>をレンダリングし、関連付けられたコントロールの名前を指定します。

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

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

  return (
    <div class="label-default-field">
      <Label.Root for="email" class="label-default">
        Email
      </Label.Root>
      <input id="email" type="email" placeholder="[email protected]" class="label-default-input" />
    </div>
  );
});

インストール#

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

pnpm add @leve-ui/label

構造#

import { Label } from '@leve-ui/label'; // or '@leve-ui/core'

<Label.Root />
パーツ要素説明
Label.Root<label>ラベルです。forを使用するか、コントロールをラップすることでコントロールと関連付けます。

例#

ラップ#

コントロールをLabel.Rootでラップすると、forとidを使用せずに関連付けることができます。

APIリファレンス#

Root#

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

データ属性値
data-leve-label常に存在

forを含むすべてのpropsはネイティブの<label>に渡されます。Field内では、代わりにField.Labelを使用してください。コントロールと自動的に関連付けられます。

アクセシビリティ#

  • ラベルは関連付けられたコントロールのアクセシブルな名前になります。forにコントロールのidを設定するか、ラベルでコントロールをラップしてください。
  • ラベルをクリックするとコントロールにフォーカスが当たるか、チェックボックスやラジオボタンの場合は状態が切り替わります。
  • Labelにはキーボード操作はありません。