Sparkle Design

Popover

ポップオーバーはトリガーからウィンドウパネルを展開するために使用するコンポーネントです。

Popover の概要図

Anatomy: 解剖図

Popoverの構成要素を示す解剖図。1はコンテナ要素を表すContainerを、2はヘッダー要素を表すHeaderを、3はボディ要素を表すBodyを、4はフッター要素を表すFooterを示します。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素
2Headerヘッダー要素任意
3Bodyボディ要素
4Footerフッター要素任意

Options: 選択肢

Placement

Placement top-startの状態。トリガーの上部左側にポップオーバーが配置されています。

top-start

トリガー上部の左側にポップオーバーが配置されるオプションです。

Placement top-midの状態。トリガーの上部中央にポップオーバーが配置されています。

top-mid

トリガー上部の中央にポップオーバーが配置されるオプションです。

Placement top-endの状態。トリガーの上部右側にポップオーバーが配置されています。

top-end

トリガー上部の右側にポップオーバーが配置されるオプションです。

Placement bottom-startの状態。トリガーの下部左側にポップオーバーが配置されています。

bottom-start

トリガー下部の左側にポップオーバーが配置されるオプションです。

Placement bottom-midの状態。トリガーの下部中央にポップオーバーが配置されています。

bottom-mid

トリガー下部の中央にポップオーバーが配置されるオプションです。

Placement bottom-endの状態。トリガーの下部中央にポップオーバーが配置されています。

bottom-end

トリガー下部の中央にポップオーバーが配置されるオプションです。

Placement left-startの状態。トリガーの左側上部にポップオーバーが配置されています。

left-start

トリガー左側の上部にポップオーバーが配置されるオプションです。

Placement left-midの状態。トリガーの左側中央にポップオーバーが配置されています。

left-mid

トリガー左側の中央にポップオーバーが配置されるオプションです。

Placement left-endの状態。トリガーの左側下部にポップオーバーが配置されています。

left-end

トリガー左側の下部にポップオーバーが配置されるオプションです。

Placement right-startの状態。トリガーの右側上部にポップオーバーが配置されています。

right-start

トリガー右側の上部にポップオーバーが配置されるオプションです。

Placement right-midの状態。トリガーの右側中央にポップオーバーが配置されています。

right-mid

トリガー右側の中央にポップオーバーが配置されるオプションです。

Placement right-endの状態。トリガーの右側下部にポップオーバーが配置されています。

right-end

トリガー右側の下部にポップオーバーが配置されるオプションです。

isHeader

true

デフォルトのポップオーバーです。

isHeader trueの状態。「タイトル」というヘッダー、右上に閉じるボタン、「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。

false

ヘッダーを無効化した状態です。

トリガーがポップオーバーの見出しを代替している場合など、タイトルがなくてもポップオーバーの役割を伝達できる場合はヘッダーを非表示にすることができます。

isHeader falseの状態。「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。

isFooter

true

フッターを有効化した場合のスタイルです。
ポップオーバーを介してユーザーがインタラクションを行う場合はフッターを有効化し、トリガーを配置します。

isFooter trueの状態。「タイトル」というヘッダー、右上に閉じるボタン、「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。

false

フッターが無効化されているデフォルトの状態です。
閲覧専用のポップオーバーを展開する場合はこのレイアウトを活用します。

isFooter falseの状態。「タイトル」というヘッダー、右上に閉じるボタン、「SLOT」というボディ領域が表示されています。

isCloseTrigger

true

クローズボタンがあるスタイルです。

isCloseTrigger trueの状態。「タイトル」というヘッダー、右上に閉じるボタン、「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。

false

クローズボタンがないスタイルです。基本的に、ポップオーバーの外側、またはトリガーを再度クリックして閉じることができます。

isCloseTrigger falseの状態。「タイトル」というヘッダー、「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。

isArrow

true

矢印を表示するスタイルです。

isArrow trueの状態。「タイトル」というヘッダー、右上に閉じるボタン、「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。

false

矢印を表示しないスタイルです。

isArrow falseの状態。「タイトル」というヘッダー、右上に閉じるボタン、「SLOT」というボディ領域、「キャンセル」と「保存」というボタンがあるフッターが表示されています。トリガーを指している矢印は非表示にしています。

Behaviors: 振る舞い

レイアウト

Popoverはトリガーと4pxの隙間を空けて配置されます。

レイアウトの仕様を示す図。情報アイコン(トリガー)の下に「リマインダーの設定方法」というヘッダーと説明文が表示されたポップオーバーが配置されています。Popoverはトリガーと4pxの隙間を空けて配置されています。

Metrics: 寸法

  • Vertical Resizing: Hug
  • Horizontal Resizing: 320px
  • Container Height: Hug
  • Item Spacing: 0px
  • padding Vertical: 16px
  • padding Horizontal: 0px
寸法仕様を示す図。

Usage: 使い方

適切な使用例。情報アイコンをトリガーとして、「リマインダーの設定方法」というヘッダー、右上に閉じるボタンと2つの番号付きリストが表示されたポップオーバーが展開されています。
Do

ポップオーバーを用いることで簡略化されたインターフェイスに対して補足の情報やコンテンツのを補完できます。

不適切な使用例。「ダウンロード」というアイコンボタンとその上に下向き矢印アイコンが付きのポップオーバーが表示されています。
Don’t

コンテンツが少ない場合は、Popoverを使わず、代わりにTooltip の使用を検討してください。

適切な使用例。「絞り込み」というボタンをトリガーとして、「地域」と「料金」のドロップダウンフィールド、「条件をクリア」というボタンが表示されたポップオーバーが展開されています。
Do

ポップオーバーには、ユーザーが素早く操作できる簡単なコンポーネントを配置することができます。

Change log: 変更履歴

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