v0.21

d-datepicker

<d-popover>と<d-calendar>を組み合わせ、ネイティブスタイルのトリガー、クリアボタン、単一・範囲選択モード、日付のローカライズ表示、キーボードショートカットを備えたフォーム連動の日付選択コンポーネントです。

1<!-- プレースホルダー付き単一選択 -->
2<d-datepicker name="due_date" placeholder="pick a date"></d-datepicker>
3
4<!-- 初期値とローカライズ表示、クリアボタン有効 -->
5<d-datepicker name="event_date" value="2026-11-19" format="localized" clearable></d-datepicker>
6
7<!-- 範囲選択 -->
8<d-datepicker name="reservation" mode="range" value="2026-11-10,2026-11-20" clearable></d-datepicker>
9
10<!-- 選択可能範囲の制限 -->
11<d-datepicker min="2026-11-01" max="2026-11-30"></d-datepicker>

属性とプロパティ(d-datepicker)

属性 プロパティ 型 デフォルト値 フォーム 説明
name name string "" いいえ FormDataやネイティブフォーム送信用のフィールド名
value value string "" はい 選択値(YYYY-MM-DDまたは範囲from,to)
mode mode string "single" いいえ 選択モード("single"、"multiple"、または"range")
placeholder placeholder string "" いいえ 未選択時のプレースホルダー(未指定時は"pick a date"または"pick date range")
format format string "" いいえ 表示フォーマット("localized"で地域言語形式、空文字でISO形式)
era era string "" いいえ カレンダーの年号表示形式(和暦表記の場合は"japanese")
min min string "" いいえ 選択可能な最小日付(YYYY-MM-DD)
max max string "" いいえ 選択可能な最大日付(YYYY-MM-DD)
locale locale string "" いいえ カレンダーおよび日付表示に使用するBCP 47ロケールコード
clearable clearable boolean false いいえ 日付選択時にクリアボタンを表示するかどうか
disabled disabled boolean false いいえ トリガーおよび内部カレンダーの操作を無効化
week-starts-on weekStartsOn number 0 いいえ カレンダーの開始曜日(0 日曜日、1 月曜日)
show-outside-days showOutsideDays boolean true いいえ カレンダーに前後の月の日付を表示するかどうか
close-on-select closeOnSelect boolean true いいえ 日付または範囲の選択完了後にポップオーバーを自動で閉じるかどうか
side side string "bottom" いいえ ポップオーバーの配置方向("top"または"bottom")
align align string "center" いいえ ポップオーバーの揃え位置("start"、"center"、"end")

プログラム用api(d-datepicker)

1const picker = select('d-datepicker');
2
3// ポップオーバーの操作
4picker.open();
5picker.close();
6picker.toggle();
7picker.clear();
8
9// 状態ゲッター
10picker.isOpen; // boolean
11picker.selectedDate; // 単一選択時のDateオブジェクトまたはnull
12picker.range; // 範囲選択時の{ from: Date, to: Date }
13picker.value; // string

イベント(d-datepicker)

イベント ペイロード バブリング 説明
change { value, from, to, date, dates } はい 日付の選択状態が変更されたとき
input { value } はい 値が更新されたとき
open {} はい カレンダーポップオーバーが開いたとき
close {} はい カレンダーポップオーバーが閉じたとき

動作仕様(d-datepicker)