Sparkle Design

Select

セレクトはオプショングループの中から値を選択する形式でユーザーからの入力を取得するために使用するコンポーネントです。

Select の概要図

Anatomy: 解剖図

Selectの構成要素を示す解剖図。1はHTML Selectエレメントを表すContainerを、2は1に内包されてユーザーの選択内容を反映するフィールドを表すValueを、3は右端に配置されており、下向き矢印アイコンを表すIconを示しています。
ItemNameDescriptionComponentOptional
1ContainerHTML Select エレメント
2Valueユーザーの選択内容を反映するフィールド
3IconSelect要素であることを明示するアイコンIcon

Options: 選択肢

Size

sm

通常よりも小さなサイズです。限られたスペースにセレクトを配置する場合かつ入力の重要性が低い場合に使用します。

smサイズのSelect。小さなサイズのセレクトフィールドに「Small」というテキストと下向き矢印が表示されています。

md (default)

セレクトのデフォルトのサイズです。ミディアムが最も使用されるサイズです。他のサイズのセレクトはミディアムを基準に重要度に応じて使用します。

mdサイズのSelect。smよりも大きいデフォルトのサイズのセレクトフィールドに「Medium」というテキストと下向き矢印が表示されています。

lg

大きなセレクトは入力の重要性を高めるため、使用は極力控えてください。

lgサイズのSelect。mdよりも大きいデフォルトのサイズのセレクトフィールドに「Medium」というテキストと下向き矢印が表示されています。

States: 状態

Enable状態のSelect。白背景でグレーの枠線のContainerに、「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Enable

ユーザーが操作を行う前のデフォルトの状態。

Hover状態のSelect。白背景でEnableよりも濃いグレーの枠線のContainerに、「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Hover

ユーザーがセレクトにマウスオーバーしている状態。

Focus状態のSelect。白背景でグレーの枠線のContainerの外側に青い枠線が表示されており、「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Focus

セレクトが展開可能な状態。クリックやキー操作によってセレクトが展開され、オプションが表示されます。

Disabled状態のSelect。薄いグレー背景で薄いグレーの枠線のContainerに、「選択してください」という薄いグレーのプレースホルダーテキストと薄いグレーの下向き矢印が表示されています。

Disabled

システムによってセレクトが非活性化されている状態。ユーザーによる操作は不能です。

Invalid

Invalid Enable状態のSelect。赤い枠線で囲まれた「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Enable

選択内容が不正な場合の状態です。ユーザーが適切な入力を行うことで無効状態は解除されます。

Invalid Hover状態のSelect。Enableよりも濃い赤い枠線で囲まれた「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Hover

ユーザーがフィールドにマウスオー バーしている場合かつ、選択内容が不正な場合の状態です。

Invalid Focus状態のSelect。白背景で赤いの枠線のContainerの外側に青い枠線が表示されており、「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Focus

フォーカスされている場合かつ、選択内容が不正な場合の状態です。

Invalid Disabled状態のSelect。薄い赤い枠線で囲まれた薄いグレーの「選択してください」というプレースホルダーテキストと下向き矢印が表示されています。

Disabled

システムによってフィールドが非活性化されている場合かつ、選択内容が不正な場合の状態です。

Behaviors: 振る舞い

オプショングループ

セレクトから展開されるオプショングループのスタイルや挙動はブラウザの仕様に準じます。

オプショングループの表示例。「選択してください」というフィールドの下に「寿司」「天麩羅」(チェックマーク付き)「蕎麦」「鰻」という4つのオプションが表示されています。

Metrics: 寸法

sm

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 32px
  • Item Spacing: 8px
  • padding Vertical: 4px
  • padding Horizontal: 8px, 4px
smサイズの寸法仕様を示す図。

md

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 40px
  • Item Spacing: 8px
  • padding Vertical: 4px
  • padding Horizontal: 12px, 6px
mdサイズの寸法仕様を示す図。

lg

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 48px
  • Item Spacing: 8px
  • padding Vertical: 4px
  • padding Horizontal: 16px, 8px
lgサイズの寸法仕様を示す図。

Usage: 使い方

Selectを使用する際はFormコンポーネントの用法に従ってください。

不適切な使用例。「選択してください」というフィールドの下に「蕎麦」(チェックマーク付き)「うどん」という2つのオプションが表示されています。
Don’t

要素が4つ未満の場合はラジオを使用してください。また、縦方向のスペースに余裕がある場合も同様にラジオを使用してください。

Contents: 内容

適切な使用例。「選択してください」というフィールドの下に「寿司」「天麩羅」(チェックマーク付き)「蕎麦」「鰻」という4つのシンプルなオプションが表示されています。
Do

オプション項目は短く簡潔に表記します。テキストが複数行に折り返されるような長い項目名は推奨されません。

不適切な使用例。「選択してください」というフィールドの下に「寿司(おまかせ10貫盛り合わせ)」「天麩羅(海老、イカ、帆立、れんこん)」(チェックマーク付き)「蕎麦(十割せいろ冷やしそば)」「鰻(ひつまぶし)」という4つの長い説明付きオプションが表示されています。
Don’t

長く、説明的なオプション項目は非推奨です。テキストの折り返しが頻繁に発生場合はテキストを修正するか、代替のUIで提示することを検討してください。

Change log: 変更履歴

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