Sparkle Design

モーダルはコンテンツに重ねられたウィンドウを介して、ユーザーの注意を特定の情報に集中させるために使用するコンポーネントです。

Modal の概要図

Anatomy: 解剖図

Modalの構成要素を示す解剖図。1はヘッダー要素を表すHeaderを、2はボディ要素を表すBodyを、3はフッター要素を表すFooterを、4はコンテナ要素を表すContainerを示します。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素—
2Headerヘッダー要素任意
3Bodyボディ要素—
4Footerフッター要素任意
Headerの構成要素を示す解剖図。1はアイテム要素を表すHeaderを、2はタイトルを表示するテキスト要素を表すTitleを、3はモーダルを非表示にするための要素を表すCloseを示します。
ItemNameDescriptionComponentOptional
1Headerアイテム要素—
2Titleタイトルを表示するテキスト要素—
3Closeモーダルを非表示にするための要素IconButton任意

Options: 選択肢

Size

sm

Smallサイズのモーダルです。横幅は320pxです。

md

Mediumサイズのモーダルです。横幅は512pxです。

Size mdのModal。

lg

Largeサイズのモーダルです。横幅は672pxです。

Size lgのModal。

xl

XLargeサイズのモーダルです。横幅は1024pxです。

Size xlのModal。

full

Fullサイズのモーダルです。上下左右には40pxのオフセットが存在します。

データコンテンツなど、コンテンツ量が多い、または複雑な場合に使用します。

Size fullのModal。

isHeader

True (default)

ヘッダーを表示するデフォルトのオプションです。

False

ヘッダーを非表示にします。ヘッダーを非表示にする場合、必ずフッターを表示してください。

isCloseTrigger

True (default)

ヘッダーのクローズボタンを表示するデフォルトのオプションです。

False

ヘッダーのクローズボタンをを非表示にします。クローズボタンを非表示にする場合、必ずフッターで代替のクローズトリガーを表示してください。

isFooter

True

フッターを表示するデフォルトのオプションです。

ヘッダーを非表示にする場合や、ヘッダーだけでモーダルに関するアクションや情報を表現できない場合は、フッターを表示します。

False (default)

フッターを非表示にします。

フッターを非表示にする場合、必ずヘッダーを表示し、クローズボタンが機能するようにしてください。

Behaviors: 振る舞い

レイアウト

モーダルはウインドウの画面中央に固定表示されます。

上下左右には40pxのオフセットが存在します。また、モーダルはオーバーレイコンポーネントの上に配置されます。

フルサイズのモーダルも同様に上下左右に40pxのオフセットが存在します。これによりメインUIの文脈を残すことができます。

レイアウトの仕様を示す図。グレーの背景(オーバーレイ)の上に「ステータス設定」というモーダルが中央に配置されています。
フルサイズのレイアウトを示す図。

領域外のクリック

領域外をクリックした際にモーダルを閉じるかどうかを、オプションで選択することができます。

Info
デフォルトは無効 (クリックでモーダルを閉じない) です。
有効にする場合は、モーダル内で行った作業内容が失われる可能性に考慮します。
基本的に情報を提示するモーダルのみに使用してください。
領域外のクリックを示す図。グレーの背景の上に「ステータス設定」というモーダルが表示され、背景の右上にカーソルアイコンが表示されています。

コンテンツのオーバーフロー

ディスプレイの表示領域よりもコンテンツが多い場合、コンテンツがオーバーフローされます。

ボディー領域の最下部は、追加コンテンツがあることを示す必要があります。

コンテンツのオーバーフローを示す図。「期間」と「備考」というラベル、日付入力フィールド、テキスト入力フィールド、「キャンセル」ボタンが表示されたモーダルです。

Metrics: 寸法

  • Vertical resizing: Hug
  • Horizontal resizing: Fixed
  • Padding top: 16px
  • Padding bottom: 16px
寸法仕様を示す図。

Usage: 使い方

Do

編集や管理タスクなど、短時間で頻度の低いタスクで使用します。

Don’t

アクションの実行・中断など、ユーザーのアクションを確認するメッセージには使用しないでください。代わりにダイアログを使用してください。

Don’t

ユーザーの確認アクションを伴わないメッセージには使用しないでください。代わりにトーストを使用してください。

Contents: 内容

Do

ヘッダータイトルは、モーダル内のタスクや目的を示すように簡潔に記述してください。また、タスクのアクションの接頭辞として機能するように留意してください。

Don’t

ヘッダータイトルは改行せずに記述してください。複数行になった場合は、タイトルを再検討してください。

Change log: 変更履歴

DateChanges
2025/06/02Modalのmd〜fullサイズ調整 ドキュメント更新
2025/03/27ModalにFullサイズを追加
2025/01/31ドキュメントを公開
2023/10/14Figmaを公開
小さな気づきや違和感があれば、お気軽に教えてください。
フィードバック
Chat illustration