Sparkle Design

Input Date

インプットデイトはユーザーが日付を入力するために使用するコンポーネントです。

Input Date の概要図

Anatomy: 解剖図

Input Dateの構成要素を示す解剖図。1はHTML Inputエレメントを表すContainerを、2はユーザーからの入力を受けるエディタブルな要素を表すValueを、3はアクションを実行するためのトリガー要素を表すTriggerを示します。
ItemNameDescriptionComponentOptional
1ContainerHTML Input エレメント
2Valueユーザーからの入力を受けるエディタブルな要素
3Triggerアクションを実行するためのトリガー要素Icon Button

Options: 選択肢

Size

sm

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

Size sm のInput Date。

md (default)

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

Size md のInput Date。

lg

大きなインプットデイトは入力の重要性を高めるため、使用は極力控えてください。

Size lg のInput Date。

States: 状態

Enable状態のInput Date。グレーの枠線で囲まれた入力フィールド内に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Enable

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

Hover状態のInput Date。Enable状態より濃いグレーの枠線で囲まれた入力フィールド内に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Hover

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

Focus状態のInput Date。青い枠線で囲まれた入力フィールド内に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Focus

フィールドが操作可能な状態。キャレットが表示され、編集が可能であることがユーザーに伝達されます。

Disabled状態のInput Date。半透明のグレーの枠線で囲まれた入力フィールド内に半透明の「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Disabled

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

Invalid

Invalid Enable状態のInput Date。赤い枠線で囲まれた入力フィールド内に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Enable

入力内容が特定のフォーマットに準拠していない場合の状態です。ユーザーが適切な入力を行うことで無効状態は解除されます。

Invalid Hover状態のInput Date。Enable状態より濃い赤い枠線で囲まれた入力フィールド内に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Hover

ユーザーがフィールドにマウスオーバーしている場合かつ、入力内容が特定の条件やフォーマットに準拠していない場合の状態です。

Invalid Focus状態のInput Date。青い枠線で囲まれた入力フィールド内に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Focus

フォーカスされている場合かつ、入力内容が特定の条件やフォーマットに準拠していない場合の状態です。

Invalid Disabled状態のInput Date。半透明のグレーの枠線で囲まれた入力フィールド内に半透明の「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示されています。

Disabled

システムによってフィールドが非活性化されている場合かつ、入力内容が特定の条件やフォーマットに準拠
していない場合の状態です。

Behaviors: 振る舞い

カレンダー

日付を選択する際はカレンダーコンポーネントが展開され、カレンダーで選択した日付がフィールドへ反映されます。

カレンダーの振る舞いを示す図。上部に「年/月/日」というプレースホルダーテキストとカレンダーアイコンが表示された入力フィールドがあり、その下に「2024年 2月」というヘッダーと日付が並んだカレンダーが展開されています。15日が青い背景で強調表示されています。

Metrics: 寸法

sm

  • Vertical Resizing: Hug
  • Horizontal Resizing: Fixed
  • Container Height: 32px
  • padding Vertical: 4px
  • padding Horizontal: 4px
Size sm の寸法仕様を示す図。

md

  • Vertical Resizing: Hug
  • Horizontal Resizing: Fixed
  • Container Height: 40px
  • padding Vertical: 4px
  • padding Horizontal: 4px
Size md の寸法仕様を示す図。

lg

  • Vertical Resizing: Hug
  • Horizontal Resizing: Fixed
  • Container Height: 48px
  • padding Vertical: 4px
  • padding Horizontal: 4px
Size lg の寸法仕様を示す図。

Field

  • Vertical Resizing: Hug
  • Horizontal Resizing: Fill
  • padding Horizontal: 8px
Fieldの寸法仕様を示す図。

Usage: 使い方

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

Change log: 変更履歴

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