フォーム

Form Field

ラベル・補助の説明文・エラー文を、入力欄とひとまとめにする部品。読み上げソフトがどの欄の説明かを正しく読み取れるよう、内部のひも付けも自動で行います。

ReactVueWeb Components
Storybook で見る

プレイグラウンド

使用例

<FormField label="Email" help="We never share it." error={err} required>
  <Input type="email" />
</FormField>

設定できる項目

名前 既定値 説明
label 必須 ReactNode Field label text.
help ReactNode Optional help/hint text below the control.
error ReactNode Error message; when present, the field is marked invalid.
required boolean Mark the field as required (adds an indicator + `required` on control).
hideLabel boolean Visually hide the label (still available to screen readers).
children 必須 ReactNode The control (Input, Select, …).
className string

アクセシビリティ

  • 文字と背景の明るさの差をしっかり取り、読みやすくしています。ライトでもダークでも、見やすさの国際基準 WCAG の最高ランク AAA(明るさの差が 7:1 以上)を満たします。
  • マウスがなくても、キーボードだけですべての操作ができます。
  • いまどこを操作しているかを示す枠(フォーカスの囲み)が、常にはっきり見えます。
  • 利用者が「画面の動きを減らす」設定にしているときは、過剰なアニメーションを止めます。

どのコンポーネントも、だれにとっても使いやすいように、見やすさの国際基準 WCAG の最高ランク AAA(WCAG 2.1 AAA)を満たすよう作っています。