Sparkle Design

Form

フォームはフォームの入力要素・ラベル・ヘルパーテキストを包括して提供するために使用するコンポーネントです。

Form の概要図

Anatomy: 解剖図

Formの構成要素を示す解剖図。1はフォームの概要を表すHeaderエリアを、2はオプションで配置可能なフォームの補足情報を伝えるHelperTextを、3は入力フィールドを配置するFieldエリアを、4はオプションで配置可能なフォームに不正が発生した場合にエラーの詳細内容を伝えるErrorTextを示します。
ItemNameDescriptionComponentOptional
1Headerフォームの概要を表すためのヘッダーエリア
2HelperTextフォームの補足情報を伝えるためのテキスト要素任意
3Field入力フィールドを配置するエリア
4ErrorTextフォームに不正が発生した場合にエラーの詳細内容を伝えるためのテキスト要素任意

Options: 選択肢

ErrorText

False (Default)

エラーテキストが非表示のデフォルトの状態です。

ErrorText false のForm。「フォームタイトル」「必須」という赤いバッジ付きのHeader、「入力内容」という入力フィールドが表示されています。

True

エラーテキストを有効化するためのオプションです。
フォームに不正がある場合にはエラーテキストを用いてエラー内容を提示します。

ErrorText true のForm。「フォームタイトル」「必須」という赤いバッジ付きのHeader、「入力内容」という入力フィールド、赤い感嘆符アイコンと「エラーメッセージ」というテキストが表示されています。

HelperText

False (Default)

ヘルパーテキストが非表示のデフォルトの状態です。
ヘルパーテキストがなくてもフォームの入力に支障がない場合は省略することができます。

HelperText false のForm。「フォームタイトル」「必須」という赤いバッジ付きのHeader、「入力内容」という入力フィールドが表示されています。

True

ヘルパーテキストを有効化するためのオプションです。
ラベルとフィールドだけではフォームの入力に支障をきたす場合はヘルパーテキストでフォームを補足します。

HelperText true のForm。「フォームタイトル」「必須」という赤いバッジ付きのHeader、「ヘルパーメッセージ」という補足情報、「入力内容」という入力フィールドが表示されています。

True (Default)

ヘッダーを表示するオプションです。
基本的にフォーム要素にはラベルを付与します。

Header false のForm。「フォームタイトル」「必須」という赤いバッジ付きのHeader、「入力内容」という入力フィールドが表示されています。

False

ヘッダーを非表示にするオプションです。
ヘッダーがなくてもフォームの情報を伝達できる場合は要素を省略することができます。

Header true のForm。「入力内容」という入力フィールドのみが表示されています。

isRequired

False (Default)

必須バッジを非表示にするオプションです。

入力が必須ではないフィールドに対してはバッジを非表示とします。

isRequired false のForm。「フォームタイトル」というHeaderと「入力内容」という入力フィールドが表示されています。

True

必須バッジを表示するオプションです。

入力が必須なフィールドに対して必須バッジを表示します。

isRequired true のForm。「フォームタイトル」「必須」という赤いバッジ付きのHeaderと「入力内容」という入力フィールドが表示されています。

isHint

False (Default)

ヒントアイコンを非表示にするオプションです。

入力に関するより詳細な情報が必要ない場合はバッジを非表示とします。

isHint false のForm。「フォームタイトル」というHeaderと「入力内容」という入力フィールドが表示されています。

True

ヒントアイコンを表示するオプションです。

入力に関するより詳細な情報を提供するためのヒントアイコンを表示します。

isHint true のForm。「フォームタイトル」というHeaderの右側に疑問符アイコンが配置され、「入力内容」という入力フィールドが表示されています。

Behaviors: 振る舞い

Hintの表示・非表示

ユーザーがヒントアイコンにマウスをホバーしたりフォーカスすることで表示されます。また、ホバーやフォーカスを解除すると、ツールチップが閉じられます。

Hintの表示・非表示の振る舞いを示す図。「契約番号」というラベルの右側に疑問符アイコンが配置され、その上に「契約番号とは、サービスご契約時に利用する8桁の数字です。」というツールチップが表示されています。

Metrics: 寸法

  • Vertical resizing:Hug
  • Horizontal resizing:Hug
  • Item spacing:4px
Formの寸法仕様を示す図。

Usage: 使い方

適切な使用例。「メールアドレス」というラベル、「半角英数字で入力してください」というヘルパーテキスト、入力フィールドが配置されています。
Do

入力に関わる情報はプレースホルダーではなくヘルパーテキストで表示してください。

不適切な使用例。「メールアドレス」というラベル、「半角英数字」というプレースホルダーが入力フィールド内に表示されています。
Don’t

プレースホルダーに重要な情報を入力することはアクセシビリティに対応していません。値が入力されるとプレースホルダーが表示されなくなります。

適切な使用例。「契約期間」というグループラベル、「開始日」「終了日」というそれぞれのラベルと入力フィールド、「開始日を入力してください」というエラーメッセージが表示されています。
Do

期間指定など、1つのフォームに2つ以上のinputを含む場合は、それぞれラベルを付与してください。
エラーの対象が明確にわかるように、文脈を提示する必要があります。

Contents: 内容

HelperText

適切な使用例。「メールアドレス」と「必須」という赤いバッジ付きのヘッダー、「半角英数字で入力してください」というヘルパーテキスト、入力フィールドが配置されています。
Do

ヘルパーテキストではフィールドに正しく入力するための特定の要件など、ヒントや役立つ情報を伝えます。

不適切な使用例。「メールアドレス」と「必須」という赤いバッジ付きのヘッダー、「メールアドレスを入力してください」というヘルパーテキスト、入力フィールドが配置されています。
Don’t

ヘルパーテキストではラベルと同じ情報を単に繰り返すだけではいけません。ユーザーにとって意味のない情報は追加しないでください。

ErrorText

適切な使用例。「メールアドレス」と「必須」という赤いバッジ付きのヘッダー、「半角英数字で入力してください」というヘルパーテキスト、「sparkle@sample.com」という入力済みフィールド、「すでに登録済みのメールアドレスです」というエラーメッセージが表示されています。
Do

エラーテキストは、フィールドに何を入力する必要があるか理解できる内容を明確かつ簡潔に伝えてください。

不適切な使用例。「メールアドレス」と「必須」という赤いバッジ付きのヘッダー、「半角英数字で入力してください」というヘルパーテキスト、「sparkle@sample.com」という入力済みフィールド、「このメールアドレスは登録できません」というエラーメッセージが表示されています。
Don’t

エラーテキストは、何が問題なのかを述べて解決方法を推測させるだけではいけません。

曖昧なメッセージはエラーとして認識されない場合もあることを留意してください。

Change log: 変更履歴

DateChanges
2025/6/20ドキュメントを更新
2024/11/22初版を公開
小さな気づきや違和感があればお気軽に教えてください。
フィードバック
Chat illustration