Sparkle Design

Card

カードはコンテンツをグルーピングして表示するために使用するコンポーネントです。遷移トリガーやドラッグ&ドロップなど、インタラクションを想定する場合は、Clickable Cardコンポーネントを使用します。

Card の概要図

Anatomy: 解剖図

Card

Cardの構成要素を示す解剖図。1はCard全体を囲むContainerを、2はオプションで配置可能なHeaderを、3はコンテンツを表示するBodyを、4はオプションで配置可能なFooterを示します。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素
2Headerヘッダー要素任意
3Bodyボディ要素
4Footerフッター要素任意

Clickable Card

Clickable Cardの構成要素を示す解剖図。1はCard全体を囲むContainerを、2はオプションで配置可能なHeaderを、3はコンテンツを表示するBodyを示します。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素
2Headerヘッダー要素任意
3Bodyボディ要素
Headerの構成要素を示す解剖図。1はHeader全体を構成するアイテム要素を、2はタイトルを提示するTextを、3はオプションで配置可能なTitle Slotを、4はオプションで配置可能なControl Slotを示します。
ItemNameDescriptionComponentOptional
1Headerアイテム要素
2Titleタイトルを提示するテキスト要素
3TitleSlotスロット要素Slot任意
4ControlSlotスロット要素Slot任意

Options: 選択肢

isHeader

true

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

isHeader true のCard。「タイトル」というテキストとSLOTエリアを含むHeaderが表示された、デフォルトの状態です。

false

ヘッダーを非表示にするオプションです。

ヘッダーやタイトルがなくてもカードの情報を伝達できる場合はヘッダーを非表示にすることができます。

isHeader false のCard。Headerが非表示で、SLOTエリアのみが表示されています。

isFooter

true

フッターを表示するオプションです。

ヘッダーだけではカードに関するアクションや情報が納まらない場合はフッターを使用します。

isFooter true のCard。SLOTエリアの下部に「キャンセル」と「保存」ボタンを含むFooterが表示されています。

false

フッター非表示にするオプションです。

isFooter false のCard。Footerが非表示で、SLOTエリアのみが表示されています。

isTitleSlot

true

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

isTitleSlot true のCard。「タイトル」というTextの横にSLOTエリアが表示されています。

false

ヘッダーにタイトルスロットを非表示するオプションです。

isTitleSlot false のCard。タイトルスロットが非表示で、「タイトル」というTextのみが表示されています。

isControlSlot

true

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

isControlSlot true のCard。ヘッダーの右側にSLOTエリアが表示されています。

false

ヘッダーにコントロールスロットを非表示するオプションです。

isControlSlot false のCard。コントロールスロットが非表示で、「タイトル」のみが表示されています。

States: 状態

Enable状態のCard。操作可能な初期状態のCardです。

Enable

ユーザーがカードを操作する前のデフォルトの状態。

Hover状態のCard。グレーを基調としたCardです。

Hover

ユーザーがカードにマウスオーバーしている状態。

Active状態のCard。青い枠線が表示され、グレーを基調としたCardです。

Active

ユーザーがカードを操作している状態。

Focus状態のCard。青い枠線が表示され、白色を基調としたCardです。

Focus

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

Disabled状態のCard。半透明状態のCardです。

Disabled

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

Behaviors: 振る舞い

トリガー

Clickable Cardコンポーネントを使用すると、カードは情報を提示すると同時に、カード自身をトリガーとして機能させることができます。

トリガーとして使用する場合は、カード全体がクリッカブルエリアとして機能します。

Clickable Cardをトリガーとして使用する例。

Metrics: 寸法

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

Usage: 使い方

適切な使用例。画像エリアと簡潔な説明テキストのみを含むCardです。
Do

カードでは必要最小限の情報を簡潔に示してください。

不適切な使用例。タイトル、画像エリア、説明テキスト、いいね数、詳細テキストとアクションを含むCardです。
Don’t

必要以上に情報やアクションを含めないでください。カードは詳細な情報へアクセスするためのトリガーとして使用します。

不適切な使用例。タイトル、説明テキストを含むClickable Cardの中に2つのボタンが配置されています。
Don’t

カードを遷移のトリガーとして扱う場合、ボタンなどの別のトリガーを含まないでください。

ドラッグ&ドロップなど、遷移を伴わないトリガーの場合は、ボタンなどを含んでも問題ありません。

不適切な使用例。タイトル、説明テキストを含むCardの中に「詳細を見る」ボタンが配置されています。
Don’t

カード内のアクションがカードにて提示している情報へのナビゲーションのみの場合はナビゲーションを行うボタンを配置しないでください。カード自身をトリガーとして使用します。

Change log: 変更履歴

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