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>
);
});.label-default-field {
display: flex;
flex-direction: column;
gap: 6px;
width: 280px;
font-family: inherit;
font-size: 14px;
}
.label-default {
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
}
.label-default-input {
height: 36px;
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: 14px;
}
.label-default-input::placeholder {
color: light-dark(#475569, #c9ddf0);
opacity: 0.7;
}
.label-default-input:focus-visible {
border-color: #009dfd;
outline: 2px solid #009dfd;
outline-offset: 2px;
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/labelnpm install @leve-ui/labelyarn add @leve-ui/labelbun add @leve-ui/labelpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Label } from '@leve-ui/label'; // or '@leve-ui/core'
<Label.Root />
| パーツ | 要素 | 説明 |
|---|---|---|
Label.Root | <label> | ラベルです。forを使用するか、コントロールをラップすることでコントロールと関連付けます。 |
例#
ラップ#
コントロールをLabel.Rootでラップすると、forとidを使用せずに関連付けることができます。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Label } from '@leve-ui/label';
import styles from './wrapping.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Label.Root class="label-wrapping-inline">
<input type="checkbox" class="label-wrapping-checkbox" />
Accept terms
</Label.Root>
);
});/* The label wraps the checkbox, so clicking the text toggles it */
.label-wrapping-inline {
display: inline-flex;
align-items: center;
gap: 8px;
font-family: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
}
.label-wrapping-checkbox {
width: 16px;
height: 16px;
margin: 0;
accent-color: #009dfd;
cursor: pointer;
}
.label-wrapping-checkbox:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}APIリファレンス#
Root#
独自のpropはありません。 すべての<label>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-label | 常に存在 |
forを含むすべてのpropsはネイティブの<label>に渡されます。Field内では、代わりにField.Labelを使用してください。コントロールと自動的に関連付けられます。
アクセシビリティ#
- ラベルは関連付けられたコントロールのアクセシブルな名前になります。
forにコントロールのidを設定するか、ラベルでコントロールをラップしてください。 - ラベルをクリックするとコントロールにフォーカスが当たるか、チェックボックスやラジオボタンの場合は状態が切り替わります。
- Labelにはキーボード操作はありません。