Sparkle Design

Switch

スイッチは設定のオンとオフを切り替えるために使用するコンポーネントです。

Switch の概要図

Anatomy: 解剖図

Switchの構成要素を示す解剖図。1のグレーの横長の楕円形のコンテナの左側に、2のオンとオフの状態を表す白い円形のThumbが配置されています。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素
2Thumbオンとオフの状態を表す要素

Options: 選択肢

Size

sm

通常よりも小さなサイズです。限られたスペースにスイッチを配置する場合かつアクションの重要性が低い場合に使用します。

smの状態。上部にグレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されたオフ状態のスイッチと、下部に青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されたオン状態のスイッチが表示されています。

md (default)

スイッチのデフォルトのサイズです。ノーマルが最も使用されるサイズです。他のサイズのスイッチはノーマルを基準に重要度に応じて使用します。

mdの状態。smよりも大きいサイズで、上部にグレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されたオフ状態のスイッチと、下部に青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されたオン状態のスイッチが表示されています。

lg

大きなスイッチはアクションの重要性を高めるため、使用は極力控えてください。

lgの状態。mdよりも大きいサイズで、上部にグレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されたオフ状態のスイッチと、下部に青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されたオン状態のスイッチが表示されています。

States: 状態

Default

Default Enable状態のSwitch。グレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されています。

Enable

ユーザーがスイッチを操作する前のデフォルトの状態。

Default Hover状態のSwitch。Enableよりも濃いグレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されています。

Hover

ユーザーがスイッチにマウスオーバーしている状態。

Default Focus状態のSwitch。青い枠線で囲まれたグレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されています。

Focus

ユーザーがタッチ操作や、キーボードや音声による操作を用いてスイッチに注視している状態。

Default Disabled状態のSwitch。Enableよりも薄いグレーの横長の楕円形のコンテナの左側に薄いグレーの円形のつまみが配置されています。

Disabled

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

Checked

Checked Enable状態のSwitch。青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されています。

Enable

スイッチが選択されていることを表す状態。

Checked Hover状態のSwitch。Enableよりも濃い青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されています。

Hover

ユーザーがスイッチにマウスオーバーしている場合かつ、スイッチが選択されている場合の状態です。

Checked Focus状態のSwitch。青い枠線で囲まれた青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されています。

Focus

スイッチがフォーカスされている場合かつ、スイッチが選択されている場合の状態です。

Checked Disabled状態のSwitch。薄い青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されています。

Disabled

スイッチが非活性化されている場合かつ、スイッチが選択されている場合の状態です。

Behaviors: 振る舞い

チェック状態

スイッチはオンまたオフにできます。チェックされている場合は右側にタブが表示されます。チェックされていない場合は左側に表示されます。

チェック状態の切り替えを示す図。上部にグレーの横長の楕円形のコンテナの左側に白い円形のつまみが配置されたオフ状態のスイッチと、下部に青い横長の楕円形のコンテナの右側に白い円形のつまみが配置されたオン状態のスイッチが表示されています。

タッチエリア

コンテナ・サムネイルともに、最低24px四方を担保できるように、タッチエリアが定義されています。

タッチエリアを示す図。sm、md、lgの各サイズのオフ状態とオン状態のスイッチが表示されており、タッチエリアが定義されています。

Metrics: 寸法

sm

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 16px
  • padding Vertical: 2px
  • padding Horizontal: 2px
  • Thumb
    • Width:12px
    • Height:12px
smの寸法仕様を示す図。

md

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 24px
  • padding Vertical: 2px
  • padding Horizontal: 2px
  • Thumb
    • Width:20px
    • Height:20px
mdの寸法仕様を示す図。

lg

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 32px
  • padding Vertical: 2px
  • padding Horizontal: 2px
  • Thumb
    • Width:28px
    • Height:28px
lgの寸法仕様を示す図。

Usage: 使い方

適切な使用例。左側に「Wi-Fi」というラベルと青いオン状態のスイッチ、「Bluetooth」というラベルとグレーのオフ状態のスイッチが表示されています。
Do

スイッチはオンとオフを切り替えるために、使用してください。

不適切な使用例。右側に「Wi-Fi」というラベルとチェック済みのチェックボックス、「Bluetooth」というラベルと未チェックのチェックボックスが表示されています。
Don’t

オンとオフを切り替える機能に、チェックボックスを使用しないでください。

適切な使用例。「ギャラリービュー」と「リストビュー」の2つのボタンがセグメントコントロールで表示されています。
Do

同一のオブジェクトを異なる表現方法に切り替える時、セグメントコントロールを使用してください。

不適切な使用例。「ギャラリービュー」というラベルとスイッチ、「リストビュー」というラベルが表示されています。
Don’t

スイッチはオブジェクトのオンオフ状態を選択するために使用されます。二つの表現方法を切り替える時、スイッチを使用しないでください。

適切な使用例。「日本語」「英語」「中国語」という3つのラジオボタンが表示され、「日本語」が選択されています。
Do

多くの選択肢から、一つだけを選択する場合、ラジオを使用してください。

不適切な使用例。「日本語」というラベルと青いオン状態のスイッチ、「英語」というラベルとグレーのオフ状態のスイッチ、「中国語」というラベルとグレーのオフ状態のスイッチが表示されています。
Don’t

多くの選択肢から、一つだけを選択する場合、スイッチを使用しないでください。

Contents: 内容

適切な使用例。左側に「ダークモード」というラベルと青いオン状態のスイッチが表示されています。
Do

簡潔なラベルでスイッチの機能と影響範囲を伝えてください。

不適切な使用例。右側に「ダークモードに切り替える」というラベルと青いオン状態のスイッチが表示されています。
Don’t

状態や影響範囲を明確に示すことができない、曖昧なラベルを使用しないでください。

適切な使用例。左側に「メール通知」というラベルと青いオン状態のスイッチが表示されています。
Do

必ずスイッチの内容を示すラベルを併記してください。

不適切な使用例。右側に青いオン状態のスイッチのみが表示され、ラベルがありません。
Don’t

内容が不明瞭な状態で、スイッチを単体で使用しないでください。

Change log: 変更履歴

DateChanges
2025/1/31ドキュメントを公開
2025/5/16Behaviors / Contentsをアップデート
小さな気づきや違和感があればお気軽に教えてください。
フィードバック
Chat illustration