@aiquants/period-slider 0.9.0 → 0.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +156 -0
- package/README.md +71 -33
- package/dist/DateSelector.d.ts +2 -2
- package/dist/DateSelector.d.ts.map +1 -1
- package/dist/MonthSelector.d.ts +2 -2
- package/dist/MonthSelector.d.ts.map +1 -1
- package/dist/PeriodSlider.d.ts +126 -16
- package/dist/PeriodSlider.d.ts.map +1 -1
- package/dist/StepperButton.d.ts +58 -0
- package/dist/StepperButton.d.ts.map +1 -0
- package/dist/YearSelector.d.ts +2 -2
- package/dist/YearSelector.d.ts.map +1 -1
- package/dist/dragPresentation.d.ts +191 -0
- package/dist/dragPresentation.d.ts.map +1 -0
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +2 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1917 -1746
- package/dist/rangeAreaWheel.d.ts +111 -0
- package/dist/rangeAreaWheel.d.ts.map +1 -0
- package/dist/styles/period-slider.css +1 -1
- package/dist/styles/period-slider.standalone.css +1 -1
- package/dist/usePeriodSlider.d.ts +4 -2
- package/dist/usePeriodSlider.d.ts.map +1 -1
- package/package.json +2 -1
- package/src/DateSelector.tsx +12 -28
- package/src/MonthSelector.tsx +10 -26
- package/src/PeriodSlider.tsx +1305 -572
- package/src/StepperButton.tsx +251 -0
- package/src/YearSelector.tsx +9 -23
- package/src/dragPresentation.ts +273 -0
- package/src/index.ts +1 -1
- package/src/rangeAreaWheel.ts +330 -0
- package/src/styles/period-slider.css +307 -108
- package/src/usePeriodSlider.ts +30 -17
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to `@aiquants/period-slider` are documented here.
|
|
4
|
+
見出しは公開済みの版番号です。`## Unreleased` は次の公開に入る変更であり、公開のコミットで版番号へ改め、新しい `## Unreleased` を起こします
|
|
5
|
+
(改めないと、同梱される release notes が公開後も `## Unreleased` のままになります)。
|
|
6
|
+
本書は 0.10.0 で起こしたため、0.7.0 以前の項はありません (0.8.0 と 0.9.0 は公開済みの差分から起こした要約です)。
|
|
7
|
+
|
|
8
|
+
## Unreleased
|
|
9
|
+
|
|
10
|
+
## 0.10.1
|
|
11
|
+
|
|
12
|
+
### 修正
|
|
13
|
+
|
|
14
|
+
- **別文書へ移されたスライダーが、移った先の文書で `Shift` + ホイールを受け取ります**。`Shift` + ホイールの登録先
|
|
15
|
+
(共有リスナーを張る `window`) をコミットのたびに読み直すようにしました。以前はマウント時の `window` へ 1 度だけ
|
|
16
|
+
登録していたため、描画済みの部分木ごと別文書へ移されたスライダー (ポップアウトのパネル) は、移った先では操作を
|
|
17
|
+
1 度も受け取らず、去った文書では新しい文書の座標で持ち主争いに加わり続けていました。読み直すのはそのスライダーが
|
|
18
|
+
描画されるコミットであるため、Props が 1 つも動かない移動では次の描画まで元の `window` のままです。
|
|
19
|
+
- **掴んでいる最中に `mode` が変わっても、掴みが残りません**。解放は「いまの `mode`」の分岐へ入るため、
|
|
20
|
+
以前は反対側のドラッグ文脈が誰にも消されず、`isGestureLive` が永久に真になって 2 本目のポインター・ホイール・
|
|
21
|
+
矢印キー・ステッパーをすべて締め出していました。終わり方は `pointerup` / `pointercancel` と同じで、
|
|
22
|
+
中断した位置がそのまま確定値です。
|
|
23
|
+
- **`macroIsDiscrete` / `microIsDiscrete` が `false` の間、`macroAllowedDates` / `microAllowedDates` を読みません**。
|
|
24
|
+
README と設計仕様が「参照されない」と書いているとおりになり、定義域の外だけを持つ候補配列を離散スナップ無しで
|
|
25
|
+
渡しても `RangeError` になりません (フックは以前からフラグで塞いでおり、本体だけが無条件に読んでいました)。
|
|
26
|
+
- **`Shift` + ホイールの持ち主判定が、`container-type` を宣言した祖先と、切り取る祖先のボーダーを正しく扱います**。
|
|
27
|
+
前者はレイアウトの封じ込めを伴うため `transform` と同じく絶対・固定配置の子孫の包含ブロックであり、
|
|
28
|
+
後者の切り取り線はボーダーボックスではなくパディングボックスです。
|
|
29
|
+
|
|
30
|
+
## 0.10.0
|
|
31
|
+
|
|
32
|
+
範囲領域 (range area) の `Shift` + ホイール、ステッパーの矢印言語、ドラッグの連続描画。統治文書はリポジトリの
|
|
33
|
+
`docs/plans/2026.09.17 [AI] range-area-shift-wheel-and-stepper-arrow-language-implementation-plan.md` と
|
|
34
|
+
`docs/plans/2026.09.18 [AI] continuous-drag-presentation-implementation-plan.md` (どちらも公開物には同梱しません)。
|
|
35
|
+
|
|
36
|
+
### 利用側の契約が変わる点 (0.9.0 からの移行)
|
|
37
|
+
|
|
38
|
+
- **境界に着いたステッパー / セレクタの ◀▶ はネイティブの `disabled` を持ちません**。`aria-disabled="true"` で
|
|
39
|
+
使用不可を伝え、フォーカスとタブ順を保ちます (キーボードで押し続けた利用者がフォーカスを失わないため)。
|
|
40
|
+
- 利用側の表明は `toBeDisabled()` から `toHaveAttribute("aria-disabled", "true")` + 「クリックで何も発火しない」へ
|
|
41
|
+
移してください。押下は捕捉フェーズで飲み込むため、`mousedown` / `mouseup` / `click` は React のルートコンテナ
|
|
42
|
+
より下のもの (ボタン自身・ホストの祖先) へ 1 つも届かず、押下がフォーカスを奪うこともありません。
|
|
43
|
+
ネイティブの `disabled` と同じく `pointerdown` / `pointerup` は配送されます。
|
|
44
|
+
- **矢印は `svg[data-arrow="left" | "right" | "up" | "down"]` です**。スライダーのステッパーは 0.9.0 まで文字グリフ
|
|
45
|
+
(`◀` / `▶`) だったため、テキストで探しているロケータは当たりません。3 セレクタの ◀▶ は 0.9.0 では CSS の
|
|
46
|
+
ボーダー三角形 (`<span>`) であり、こちらは文字ではなく**形の作り方**が変わりました (どちらも同じ属性で特定できます)。
|
|
47
|
+
- **ルート要素がレール方向に当たり判定の予約を持ちます** (`px-[19px]` / `py-[19px]`、`showStepper={false}` では
|
|
48
|
+
`px-[calc(var(--ps-target-size)/2)]`)。同じ幅を与えたときのレールは 38px (ステッパー非表示時は 44px) 短くなります。
|
|
49
|
+
縦向きのトラック長は「高さ − 104px」、`showStepper={false}` では「高さ − 44px」です。
|
|
50
|
+
- **セレクタのルートから外側の余白 (`mx-1` / `my-auto`) と固定幅 (`w-32` / `w-38`) が無くなりました**。離隔はホストが
|
|
51
|
+
持ちます (必要量の表は README の「配置の注意」)。ルートは内容幅になり、既定の書式では `YearSelector` が 128px から
|
|
52
|
+
138px へ、`MonthSelector` と `DateSelector` が 152px から 178px へ変わります。2 つのセレクタを縦に積んで幅が
|
|
53
|
+
揃うことに依存しているレイアウトは、上げ直しの際に整列を確かめてください。
|
|
54
|
+
- **公開エクスポートから `getActiveDragHandle` が消え、`resolveDraggedEdge` が入りました**。交差の判定は値空間の
|
|
55
|
+
比較ではなく、描かれているつまみの比率で行います。
|
|
56
|
+
- **ドラッグは掴んだ要素へポインターを捕捉します** (`setPointerCapture`)。`jsdom` はこの API を実装していないため、
|
|
57
|
+
利用側の `jsdom` テストは `ResizeObserver` と同じくシムが要ります (`Element.prototype.setPointerCapture` /
|
|
58
|
+
`releasePointerCapture` / `hasPointerCapture`)。
|
|
59
|
+
- **ノギスの `onChangeMacroRange` / `onChangeMicroRange` は、選択が動いていない操作では鳴りません**。判定基準は
|
|
60
|
+
確定している選択そのもので、平レールの `onChangeRange` / `onChangePoint` と同じ規則です (押しただけで動かさない
|
|
61
|
+
操作や、マクロ窓だけを動かした操作でミクロ側が鳴ることはありません)。
|
|
62
|
+
|
|
63
|
+
### 追加
|
|
64
|
+
|
|
65
|
+
- 範囲領域のどこでも (インジケーターの真上でなくても) `Shift` + ホイールで選択が 1 単位ずつ平行移動します。
|
|
66
|
+
持ち主は幾何で決まり (トラック中心線が最も近いスライダー、同距離なら登録順で先のもの。登録は 1 台につき 1 回で、
|
|
67
|
+
マウントした文書に留まる限り登録順はマウント順そのもの)、描かれていないスライダー
|
|
68
|
+
(`visibility: hidden` / `display: none` / 切り取る祖先の中) はどの点も持ちません。
|
|
69
|
+
- ドラッグ中、掴んだ部品はポインターそのものの位置へ描かれ、指を離すと確定位置へ収まります
|
|
70
|
+
(`data-drag-snap="true"` と `--ps-drag-snap-duration`)。公開 Props は増えません。
|
|
71
|
+
- トラックを押して指を動かさずに離すと、最寄りの対象がその位置へ寄ります (WCAG 2.2 SC 2.5.7)。
|
|
72
|
+
- 1 つの操作が押下から解放まで値の持ち主です。掴んでいる間、2 本目のポインター・ホイール・矢印キー・ステッパーは
|
|
73
|
+
値を動かしません。
|
|
74
|
+
- ノギスの読み取りの針が `data-testid="period-slider-hairline"` を、台形プロジェクションが
|
|
75
|
+
`data-testid="period-slider-vernier-projection"` を持ちます。
|
|
76
|
+
|
|
77
|
+
### 見た目が変わる点
|
|
78
|
+
|
|
79
|
+
- **目盛のインクがレールの境界線と同じになりました** (ライト `#64748b`、ダーク `#90a1b9`)。ノギスの目盛線も離散
|
|
80
|
+
レールの候補点も、載っているレールの塗りに対し 3:1 以上になります (SC 1.4.11。以前は 1.20:1 と 1.53:1)。
|
|
81
|
+
候補点は自分のユーティリティで塗らなくなり、目盛と同じ 1 つのインクを受けます。
|
|
82
|
+
- **強制カラー (`forced-colors: active`) で目盛と針が残ります**。以前はどちらも背景色だけで描かれていたため、
|
|
83
|
+
UA の置き換えでページ・レールと同じ色になって消えていました。
|
|
84
|
+
- **読み取りの針が線の中心を値へ合わせます** (以前は箱の縁を合わせており、目盛との間に 0.5px のずれが残っていました)。
|
|
85
|
+
|
|
86
|
+
### 修正
|
|
87
|
+
|
|
88
|
+
- **ノギスの半円つまみが強制カラーで消えなくなりました**。UA は SVG の `fill` / `stroke` を置き換えない
|
|
89
|
+
(算出 `forced-color-adjust` が `preserve-parent-color` になる) ため、以前は author の色がそのまま残り、
|
|
90
|
+
`colorScheme="monochrome"` のミクロつまみは強制カラーの暗色背景に対し 1.19:1 で見えませんでした。
|
|
91
|
+
縁を `CanvasText`、面を `Canvas` (掴んでいる間は `Highlight`) で塗り直します。
|
|
92
|
+
- **定義域の内包を、値が載るレールの解像度で判定します**。`unit="month"` に `2026-09-15` のような期間途中の
|
|
93
|
+
`minDate` を渡すと、レールの先頭は `2026-09-01` であり、`Home` キー・ステッパー・ドラッグ・フックはいずれも
|
|
94
|
+
その日付を確定値として配ります。以前はその値をそのまま制御 Props (`range` / `value` / `microRange` 等) へ
|
|
95
|
+
戻すと `RangeError` で利用側の木が落ちました。フック 4 種の窓内包も同じ解像度になり、`microUnit="day"` で
|
|
96
|
+
`maxDate` と同じ値 (`new Date()` の形) を初期ミクロ選択に渡す構成も通ります。1 単位でも外れた値は従来どおり
|
|
97
|
+
`RangeError` です。
|
|
98
|
+
- **別文書へ `createPortal` したスライダー (ポップアウトのパネル、同一オリジンの `<iframe>`) が操作を受け取ります**。
|
|
99
|
+
ポインター操作の 4 つのリスナーは、モジュールを読み込んだ文書ではなくスライダーが描かれている文書の `window` へ
|
|
100
|
+
張ります (以前は最初の押下で掴みが永久に生き続け、ホイール・矢印キー・ステッパーを締め出したままでした)。
|
|
101
|
+
ホイールのヒットテストとステッパーの例外も realm に束縛される `instanceof` をやめ、`Node.contains` で判定します。
|
|
102
|
+
|
|
103
|
+
## 0.9.0
|
|
104
|
+
|
|
105
|
+
ノギスの窓と離散レールの正準規則、`Shift` + ホイールによる平行移動、`variant="date"` の表記揃え。
|
|
106
|
+
|
|
107
|
+
### 利用側の契約が変わる点 (0.8.0 からの移行)
|
|
108
|
+
|
|
109
|
+
- **`useVernierSlider` が `useVernierSliderRange` へ改名されました** (別名は残していません)。オプション型・戻り値型も
|
|
110
|
+
`UseVernierSliderRangeOptions` / `UseVernierSliderRangeReturn` へ揃います。4 つのフックが 1 つの family として読める形です。
|
|
111
|
+
- **ノギスのミクロレールの開始が、マクロ窓の開始と同じ規則になりました**。`macroRange[0]` が期間の途中を指す構成
|
|
112
|
+
(`macroUnit="month"` に `2026-09-15` など) で、ミクロレールの下端が生の値 (`2026-09-15`) ではなくマクロつまみが名乗る
|
|
113
|
+
位置 (`2026-09-01`) になります。上端は 0.8.0 でも期間末まで広げていたため、両端が別々の規則で解かれていた不整合の解消です。
|
|
114
|
+
- **ノギスのミクロ選択が宣言済み定義域 (`[minDate, maxDate]`) の内側を要求します**。`microRange` / `defaultMicroRange` /
|
|
115
|
+
`microValue` / `defaultMicroValue` が定義域の外にある構成は、以前は黙って受理されていましたが `RangeError` になります。
|
|
116
|
+
- **`useVernierSliderRange.shiftMicroRange` が離散指定を読みます**。`microIsDiscrete` 有効時は暦単位ではなく候補集合の上を
|
|
117
|
+
`delta` 個分歩き、外れるシフトは幅を崩さず全体を中止します (レール・ドラッグ・ステッパーと同じ規則)。
|
|
118
|
+
|
|
119
|
+
### 追加
|
|
120
|
+
|
|
121
|
+
- `Shift` + ホイールで選択が 1 単位ずつ平行移動します。この版のリスナーはトラック要素そのものへ張るため、効くのは
|
|
122
|
+
トラックとその子孫の上だけです (範囲領域のどこでも受けるようになるのは 0.10.0)。ノギスはポインターが載っている段の
|
|
123
|
+
スケールが動きます。
|
|
124
|
+
- 公開エクスポート `getMacroWindowStartDate` と `resolveMacroWindow` (マクロ窓と定義域の交差を解く正準関数)。
|
|
125
|
+
|
|
126
|
+
### 見た目が変わる点
|
|
127
|
+
|
|
128
|
+
- **`variant="date"` のネイティブ入力が、同じ値を示すドロップダウンと同じ書体・字送り・寄せ・面で描かれます**。
|
|
129
|
+
中央寄せはユーティリティでは届かないため、同梱スタイルシートが公開クラス `.period-slider-native-date-field` を持ちます
|
|
130
|
+
(自前のマークアップで同じ揃えが必要な場合に付けてください)。
|
|
131
|
+
|
|
132
|
+
## 0.8.0
|
|
133
|
+
|
|
134
|
+
ノギスのミクロレールに**時点**の形態を追加。
|
|
135
|
+
|
|
136
|
+
### 利用側の契約が変わる点 (0.7.0 からの移行)
|
|
137
|
+
|
|
138
|
+
- **`PeriodSliderVernierProps` が 2 形態の合併型になりました**。ミクロが期間の形態 (`PeriodSliderVernierRangeProps`) と
|
|
139
|
+
時点の形態 (`PeriodSliderVernierPointProps`) のいずれかであり、この型を受けて `microRange` を直接読んでいたコードは
|
|
140
|
+
形態での絞り込みが要ります。共通部分は `BasePeriodSliderVernierProps` が持ちます。
|
|
141
|
+
- 期間側の 3 Props (`microRange` / `defaultMicroRange` / `onChangeMicroRange`) と時点側の 3 Props
|
|
142
|
+
(`microValue` / `defaultMicroValue` / `onChangeMicroPoint`) は**相互排他**です。型では互いを `never` として宣言し、
|
|
143
|
+
JavaScript からの同時指定は描画時に `RangeError` で拒否します。
|
|
144
|
+
|
|
145
|
+
### 追加
|
|
146
|
+
|
|
147
|
+
- `mode="vernier"` のミクロが**時点**の形態。つまみは 3 つ (マクロ 2 + ミクロ 1) で、ミクロの連結バーを描きません。
|
|
148
|
+
つまみのアクセシブル名は `pointAriaLabel` (既定 `"Micro selected date"`)、DOM フックは
|
|
149
|
+
`[data-handle-type="micro-point"]` です。
|
|
150
|
+
- 公開エクスポート `useVernierSliderPoint`、型 `PeriodSliderVernierPointProps` / `PeriodSliderVernierRangeProps` /
|
|
151
|
+
`VernierMicroShape`。
|
|
152
|
+
|
|
153
|
+
### 修正
|
|
154
|
+
|
|
155
|
+
- マクロ窓の操作でミクロレールの形が変わっても、時点の形態が幅を持ちません (内部は常に幅ゼロのタプル `[v, v]`)。
|
|
156
|
+
- フックの候補解決がレールと同じ規則を読みます (以前はフックとレールで最近傍候補が食い違うことがありました)。
|
package/README.md
CHANGED
|
@@ -39,26 +39,28 @@
|
|
|
39
39
|
- 2 つのつまみが同じ値に重なったときは、同一文字列のラベルを 2 枚並べず 1 枚へ畳みます。冗長な側のラベルには `data-duplicate="true"` が付いて `visibility: hidden` になり (要素は残るため実測は継続)、残った 1 枚は 90° に傾いたままつまみの中心に立ちます (畳んでも角度は変えず、離す相手が居なくなった水平方向の押し退けだけを 0 にします)。畳まれたかどうかは傾斜の可否を動かしません。値が一致していても、上記のとおり実測が揃うまで・`autoSlantLabels={false}`・垂直レイアウトでは直立のままです。同じ機構がノギスのマクロ対・ミクロ対にも適用され (判定は各対の符号化値の厳密一致)、可視ラベルは掴んだ・打鍵した・`Tab` で到達したつまみへ追従します。
|
|
40
40
|
- トラック上をホバーしたときに出る追従ラベル (ポインターオーバーレイ) も、指している値がつまみの確定値と一致する間は同じ機構で隠します。つまみのラベルと一字一句同じ文字列が 4px ずれて二重に描かれるのを防ぐためで、判定はラベル併合と同じ符号化値の厳密一致です。ポインター位置そのものを示す点とガイドは表示したままです。
|
|
41
41
|
- 操作中 (ドラッグ中)、直近にクリック・キー操作・フォーカスしたラベル・つまみを前面 (`z-index`) に強調表示。併合時に見えるのはこの前面側のラベルです。
|
|
42
|
+
- **ドラッグは指に付いて来ます (目盛りの粗さに関わらず)**: つまみ・帯・ラベル・針・ノギスの台形プロジェクションは、押している間はポインターそのものの位置に描かれます。年スケールのように 1 目盛りが数十ピクセルあるレールでも、つまみが固まってから跳ぶことはありません。**公表される値は従来どおり離散のまま**で、コールバック・`debounceMs`・`aria-valuenow` は 1 ビットも変わりません。指を離すと 120ms の短い収め戻しで確定位置へ座ります。キーボード・ホイール・ステッパーによる変化は決して動きません — 収め戻しの窓が開いている最中に起きた変化でも、値を動かす前に窓を閉じます (`prefers-reduced-motion: reduce` では収め戻しも動きません)。専用の Props はありません。
|
|
42
43
|
- **上限/下限交差 (クロスオーバー) の動的ハイライト追従**:
|
|
43
44
|
- レンジドラッグ中につまみが相手側アンカーを超えて上限と下限が入れ替わった際、現在ポインターで操作している側のつまみへアクティブ状態 (`[data-active="true"]`、スケール縮小+ブルーグロー・波紋) がリアルタイムに自動スワップ。
|
|
44
45
|
- **充実した日付セレクタ**:
|
|
45
46
|
- `YearSelector`: ドロップダウンと ◀▶ ステッパーで年を選択。
|
|
46
47
|
- `MonthSelector`: カレンダー入力 (`variant="date"`, 既定) / ドロップダウン (`variant="dropdown"`) 対応の月セレクタ。連続した境界のほか、実データに存在する月だけを選ばせる離散集合 (`allowedMonths`) に対応。
|
|
47
48
|
- `DateSelector`: 日付入力 (`variant="date"`, 既定)、単一セレクトボックス (`variant="dropdown"`)、年月日の 3 分割セレクト (`variant="split-dropdown"`) に対応。離散集合 (`allowedDates`) にも対応。
|
|
49
|
+
- 3 セレクタの ◀▶ とスライダーのステッパーは同じ部品を共有し、押せる間だけホバーで強調され、44px の当たり判定とキーボードフォーカスのリングを持ちます。境界に着いたボタンはフォーカスを保ち、タブ順にも残ったまま使用不可 (`aria-disabled="true"`) になります。どのボタンも `type="button"` のため、ホストの `<form>` の中に置いても押下でフォームを送信しません。
|
|
48
50
|
- **カラーテーマ・メリハリ対比 & ダークモード**:
|
|
49
51
|
- `colorScheme`: 6 系統のカラーパレット (`"blue-rose"` [既定], `"indigo-amber"`, `"teal-emerald"`, `"violet-fuchsia"`, `"slate-sky"`, `"monochrome"`) をサポート。
|
|
50
52
|
- ノギス 2 段スケールにおける広域マクロ (青系) と確定ミクロ (赤系) の明確なメリハリ対比、および境界を結ぶ台形プロジェクション光の動的 2 色グラデーション。
|
|
51
53
|
- トラック、ノブ、目盛線、ツールチップ、セレクタ群 (`YearSelector`, `MonthSelector`, `DateSelector`) を含む Tailwind `.dark` クラスによるダークモード完全対応。
|
|
52
|
-
- **CSS カスタムプロパティによるスタイリング API**: 配色 11 個に加え、重なり順 (z-index) 8
|
|
54
|
+
- **CSS カスタムプロパティによるスタイリング API**: 配色 11 個に加え、重なり順 (z-index) 8 個、インジケーターラベルの配色・文字寸法・余白・角丸 7 個とノギスのレール離隔 1 個の計 27 変数を `--aqps-` 接頭辞で公開。対応する Props は持たず、自前の CSS か `style` プロップで上書きします。既定値は現在の描画結果そのもののため、何も与えなければ見た目は一切変わりません。
|
|
53
55
|
- **垂直レイアウト対応 (`isVertical`)**:
|
|
54
56
|
- `isVertical={true}` によりダッシュボードのサイドバーや狭小パネルに最適な垂直指向スライダーを提供。
|
|
55
|
-
- つまみのラベルはつまみの左側、ホバーガイドのラベルはトラックの右側へ排他配置し、垂直時の重なりを構造的に回避。つまみ左端からラベル右端までの実測離隔は 16px です (`right: calc(100% +
|
|
57
|
+
- つまみのラベルはつまみの左側、ホバーガイドのラベルはトラックの右側へ排他配置し、垂直時の重なりを構造的に回避。つまみ左端からラベル右端までの実測離隔は 16px です (スタイルシートの 1 つの宣言 `right: calc(100% + var(--ps-vertical-label-gap))` が決めます。`--ps-vertical-label-gap` は内部変数であり、上書きしてよい公開の CSS カスタムプロパティではありません — 名前も値も予告なく変わります)。
|
|
56
58
|
- **ノギスの均一 8px クリアランス & ツールチップ色分け**:
|
|
57
59
|
- ノギス (Vernier) モードでは、上下左右いずれのレールでも半円つまみの平面からラベルまでの距離を 8px に統一 (`--aqps-label-rail-gap` で変更可)。
|
|
58
60
|
- ノギスモードではマクロツールチップ (`--aqps-macro-color`) とミクロツールチップ (`--aqps-micro-color`) がセマンティックに色分けされ、上下段の対応関係が一目で判別可能。
|
|
59
61
|
- **ロケール中立な表示文字列**: 組み込み文字列に特定の言語を持ちません。アクセシブル名の既定値は英語、日付表記の既定値は ISO 8601 で、`locale` を渡せば `Intl.DateTimeFormat` 書式、フォーマッタ Props を渡せば任意書式になります。`<input>` の `value` と `<option value>` は常に ISO 8601 (または生の数値) で、`locale` の影響を受けません。
|
|
60
62
|
- **高いアクセシビリティ**: WAI-ARIA `slider` ロール、キーボード操作 (矢印キー, PageUp/Down, Home/End) 完全準拠 (Vernier ノギスハンドル含む)。
|
|
61
|
-
- **`Shift` + ホイールによる平行移動**:
|
|
63
|
+
- **`Shift` + ホイールによる平行移動**: スライダーの範囲領域 (レールの行・つまみとラベルが描かれる帯 — レール方向にもラベルの外縁まで — ・ステッパー) のどこでも `Shift` を押しながらホイールを回すと、選択がステッパーと同じ ±1 単位だけ平行移動します。インジケーターの真上である必要はありません。`Shift` 無しの素のホイールはページのスクロールのままで、ページのスクロールを奪うのは `Shift` 付きのホイールが使えるデルタを運んでいるときだけです (選択が端に着いていて結果的に何も動かない場合も、操作は範囲領域へ向けられているため奪います)。縦向きレールではレールの正方向が上のため符号が反転します。ノギスではポインターがトラック中心線のどちら側にあるかで段 (マクロレールならマクロ窓、ミクロレールならミクロ選択) が決まり、ステッパーの上ではクリックと同じミクロ選択が動きます。
|
|
62
64
|
- **レールが描く位置だけを名乗り、そこだけを確定させる**: 離散ミクロレール (`microIsDiscrete`) は候補集合しか描かないため、つまみの位置・読み上げ値・ラベル・そして確定値がすべて同じ 1 規則 (候補があれば最近傍候補、無ければ窓へのクランプ) を読みます。つまみが描かれている場所と利用側が受け取る値が食い違いません。
|
|
63
65
|
- **マクロ窓の両境界は対**: ノギスのミクロレールは、マクロつまみが名乗る期間をちょうど覆います。`macroRange` に期間の途中を指す日付を渡しても、開始側は先頭マクロ期間の先頭へ (`getMacroWindowStartDate`)、終了側は末尾マクロ期間の末日へ (`getMacroWindowEndDate`) 揃います (例: `2026-09-15`〜`2026-10-15` は `2026-09-01`〜`2026-10-31`)。丸めた窓が `[minDate, maxDate]` をはみ出す場合は定義域で切り落とされ、この交差は `resolveMacroWindow` が一手に引き受けます — レール・フックの収め込み・ミクロセレクタが同じ窓を読むため、どの経路も定義域外のミクロ日付を確定させません。
|
|
64
66
|
|
|
@@ -68,6 +70,10 @@
|
|
|
68
70
|
pnpm add @aiquants/period-slider
|
|
69
71
|
```
|
|
70
72
|
|
|
73
|
+
0.9.0 から上げる場合は、同梱の `CHANGELOG.md` の「利用側の契約が変わる点」を先に読んでください (使用不可のステッパーの属性、矢印の要素、レール方向の予約、セレクタのルート幅、公開エクスポート、ドラッグのポインター捕捉、ノギスのコールバックの重複抑止)。
|
|
74
|
+
|
|
75
|
+
`jsdom` でこのコンポーネントを描画するテストは、`jsdom` が実装していないブラウザ API のシムが要ります (`ResizeObserver`、`window.matchMedia`、`Element.prototype.setPointerCapture` / `releasePointerCapture` / `hasPointerCapture`)。`createPortal` で別文書 (`<iframe>` やポップアウトのウィンドウ) へ描く場合は、`Element.prototype` が文書ごとに別であるため、その文書の `Element` へも同じシムを載せてください (スライダー側は操作のリスナーもホイールの登録も、自分が描かれている文書の `window` へ張ります)。
|
|
76
|
+
|
|
71
77
|
## 使用方法
|
|
72
78
|
|
|
73
79
|
### スタイル読み込み
|
|
@@ -88,7 +94,7 @@ import "@aiquants/period-slider/styles/period-slider.standalone.css"
|
|
|
88
94
|
| `styles/period-slider.standalone.css` | テーマ変数・ユーティリティを同梱した自己完結スタイル | ホストに Tailwind ビルドが無い場合 |
|
|
89
95
|
|
|
90
96
|
> [!IMPORTANT]
|
|
91
|
-
> A を選ぶ場合、ホスト側の Tailwind エントリ CSS に次の
|
|
97
|
+
> A を選ぶ場合、ホスト側の Tailwind エントリ CSS に次の 3 行が必須です。
|
|
92
98
|
>
|
|
93
99
|
> ```css
|
|
94
100
|
> @import "tailwindcss";
|
|
@@ -96,7 +102,7 @@ import "@aiquants/period-slider/styles/period-slider.standalone.css"
|
|
|
96
102
|
> @custom-variant dark (&:where(.dark, .dark *));
|
|
97
103
|
> ```
|
|
98
104
|
>
|
|
99
|
-
> - `@source`: Tailwind CSS v4 は既定で `node_modules` を走査しないため、これが無いとパッケージが出力するユーティリティクラス (`
|
|
105
|
+
> - `@source`: Tailwind CSS v4 は既定で `node_modules` を走査しないため、これが無いとパッケージが出力するユーティリティクラス (`grid`, `rounded-full`, `not-aria-disabled:hover:*`, `dark:*`, `forced-colors:*` 等の状態・バリアント付きのものを含む) が一切生成されず、コンポーネントが未装飾のテキストとして描画されます。
|
|
100
106
|
> - `@custom-variant dark`: Tailwind CSS v4 の `dark:` は既定で `@media (prefers-color-scheme: dark)` にコンパイルされます。これが無いと `.dark` クラスでは切り替わらず、手書きクラスで配色を持つスライダー本体だけが暗転し、`dark:` ユーティリティで配色を持つ 3 セレクタ (`YearSelector`, `MonthSelector`, `DateSelector`) が明色のまま取り残されます。
|
|
101
107
|
>
|
|
102
108
|
> B のスタンドアロン CSS は自己完結のため `@source` 指定は不要ですが、ホストの Tailwind ビルドと混在させないでください (ユーティリティ層が二重定義になります)。
|
|
@@ -162,7 +168,7 @@ export function FastRangeExample() {
|
|
|
162
168
|
})
|
|
163
169
|
|
|
164
170
|
return (
|
|
165
|
-
<div className="flex items-center gap-
|
|
171
|
+
<div className="flex items-center gap-8">
|
|
166
172
|
<MonthSelector {...startSelectorProps} />
|
|
167
173
|
<PeriodSlider {...sliderProps} className="flex-1" />
|
|
168
174
|
<MonthSelector {...endSelectorProps} />
|
|
@@ -304,7 +310,7 @@ export function VernierPointExample() {
|
|
|
304
310
|
- ミクロ側の接続バー (`period-slider-connect-micro`) は描きません。幅を持たない選択を帯で表すと「満タンの期間」に見え、掴める帯まで生えてしまうためです。マクロ窓の帯は従来どおり残ります。
|
|
305
311
|
- `aria-valuemin` / `aria-valuemax` はミクロレールの両端 (マクロ窓で切り出した範囲) で、`aria-valuenow` は選択時点そのものです。期間形態のように相手のつまみで塞がれることはありません。
|
|
306
312
|
- キーボードは `mode="point"` と同じく左右対称です。`←` `→` で ±1 ミクロ単位、`PageUp` / `PageDown` で ±5、`Home` / `End` でレールの両端へ届きます。動けない押下はコールバックを発火しません。
|
|
307
|
-
- ステッパーは ±1
|
|
313
|
+
- ステッパーは ±1 ミクロ単位で、レールの端に着いた側だけが使用不可 (`aria-disabled="true"`、フォーカスは保持) になります。
|
|
308
314
|
- マクロ窓を掴んで動かすと時点も同じ暦差分だけ平行移動し、窓の端を動かして時点が窓の外に出る場合は窓の内側へ収まります。
|
|
309
315
|
- `microIsDiscrete` / `microAllowedDates` は期間形態と同じく併用でき、キーボードもステッパーも候補集合の上だけを歩きます。
|
|
310
316
|
|
|
@@ -313,13 +319,7 @@ export function VernierPointExample() {
|
|
|
313
319
|
`isVertical={true}` を指定することで、縦向き (下部が最小日付、上部が最大日付) のスライダーとして表示できます。
|
|
314
320
|
|
|
315
321
|
> [!NOTE]
|
|
316
|
-
>
|
|
317
|
-
>
|
|
318
|
-
> ```css
|
|
319
|
-
> .period-slider-track[data-orientation="vertical"] {
|
|
320
|
-
> height: 24rem;
|
|
321
|
-
> }
|
|
322
|
-
> ```
|
|
322
|
+
> ルート要素はグリッドで、トラックの長さはルート要素の高さ − 104px (ステッパーの当たり判定の予約 19px + ボタン 22px + 間隔 11px を上下で)、`showStepper={false}` では高さ − 44px (丸つまみの当たり判定のはみ出しをルートが確保する分を上下で) です。ホストが高さを与えなければトラックは 0px に潰れるため、`className` で高さを与えてください。ブロックレベルのルート要素は親の幅いっぱいに広がるため、幅は `w-fit` などで内容へ合わせます (下の例のように `flex` の子にすれば内容幅になります)。
|
|
323
323
|
|
|
324
324
|
```tsx
|
|
325
325
|
import { PeriodSlider } from "@aiquants/period-slider"
|
|
@@ -337,6 +337,7 @@ export function VerticalExample() {
|
|
|
337
337
|
mode="range"
|
|
338
338
|
unit="month"
|
|
339
339
|
isVertical={true}
|
|
340
|
+
className="h-60"
|
|
340
341
|
minDate={new Date(2024, 0, 1)}
|
|
341
342
|
maxDate={new Date(2024, 11, 31)}
|
|
342
343
|
range={range}
|
|
@@ -418,6 +419,35 @@ export function CustomLabelExample() {
|
|
|
418
419
|
}
|
|
419
420
|
```
|
|
420
421
|
|
|
422
|
+
### ポインター操作の約束
|
|
423
|
+
|
|
424
|
+
- **1 つの操作が押下から解放まで値の持ち主です**: 掴んでいる間は、2 本目の指の押下も `Shift` + ホイールも矢印キーもステッパーも値を動かしません (ホイールはページのスクロールのままです)。ネイティブの `range` 入力と同じく、先に押した指のものです。
|
|
425
|
+
- **取り消されたポインターは中断された位置を残します**: OS のジェスチャーや第 3 のタッチで `pointercancel` が届いても、ドラッグ開始前の値へは戻しません。途上の値は既に `onChange*` で渡っているためです。
|
|
426
|
+
- **押すだけで動きます**: トラックを押して指を動かさずに離すと、最寄りの対象がその位置へ寄ります (ノギスのマクロ窓・ミクロ選択も同じ)。ドラッグを要しない単一ポインターの経路です (WCAG 2.2 SC 2.5.7)。
|
|
427
|
+
- **使用不可の ◀▶ / ステッパーは押下をホストへ通しません**: 境界に着いたボタンは `aria-disabled="true"` でフォーカスを保ったまま、押下を捕捉フェーズで飲み込みます (`preventDefault` + `stopPropagation`)。`mousedown` / `mouseup` / `click` は React のルートコンテナより下のもの (ボタン自身と、その間にあるホストの要素) へ 1 つも届かず、押下がフォーカスを奪うこともありません。クリック可能なカード・イベント委譲・外側押下による閉じ処理・クリック計測の中へ置いても、淡く塗られた矢印からホストのハンドラが発火することはありません。ネイティブの `disabled` と同じく `pointerdown` / `pointerup` は配送されます。
|
|
428
|
+
|
|
429
|
+
### 配置の注意 (範囲領域と当たり判定)
|
|
430
|
+
|
|
431
|
+
- **範囲領域はホストの押下を奪いません**: `Shift` + ホイールを受ける範囲領域 (ルート要素の箱に加えて、レールの上下のレーンと描かれたラベルの帯。レール方向にもラベルの外縁まで届きます) は何も描かず、ヒットテストにも一切答えません。レール方向の伸びは要素の箱ではなく持ち主判定の中だけにあるため、余裕のないスクロールコンテナへスクロールのはみ出しを足すこともありません。帯がホストの要素に重なっても、押下・ホバー・コンテキストメニューは何も変わりません。帯を空けるかどうかは、ラベルが読めるかどうかという見た目の判断です (レーンはレールの上下 22px、ノギスは 28px。ラベルの帯の厚みは描かれるラベルの寸法と傾きで変わり、日単位で接近した対では 90px を超えます)。
|
|
432
|
+
- **範囲領域の持ち主は幾何で決まります**: スライダーを 2 つ近づけて範囲領域が重なっても、動くのはトラック中心線が近い方だけ (同距離なら先にマウントした方だけ) で、互いを動かすことはありません。描かれていないスライダー — `visibility: hidden` の下、`display: none` の下、畳んだアコーディオン (`max-height: 0; overflow: hidden` や `contain: paint`) の中 — はどの点も持たないため、そこに見えているホストの要素から操作を奪うこともありません。切り取りは CSS の規則どおり包含ブロックの連鎖でだけ効きます (`position: fixed` のスライダーは、`transform` などで包含ブロックを作らない祖先の `overflow` には切り取られず、浮いて描かれているとおり自分の領域を持ちます)。祖先の `clip-path` と `mask` が消した部分だけは扱いません (算出値から復元できないため、その方法で隠したスライダーは自分の点を持ち続けます)。逆に、スライダーの上へ重ねたホストの層 (ドロップダウンなど) の上でも `Shift` + ホイールはスライダーを動かします。ホストの層を優先させたい場合の手立ては 3 つあります。(a) ルート要素のインライン `--ps-label-reach-before` / `--ps-label-reach-after` / `--ps-label-reach-main` を読んで帯の厚みだけ避ける (この 3 つは `--ps-` 名前空間で唯一、**読み取り専用の出力として名前と意味を保つ**もので、ホストが読んでかまいません。上書きの口ではありません。ラベルが描かれていない側は変数自体が出ないため `var(--ps-label-reach-after, 0px)` の形で読みます)、(b) `labelPosition` で帯を反対側へ移す、(c) `tooltipStyle="hover"` でラベルを描かせず、領域をレール周りのレーン (22px / ノギス 28px) へ縮める。いずれもスライダーの機能は落ちません。
|
|
433
|
+
- **ドラッグ中はトラックがインライン変数を持ちます**: 押している間、トラック要素 (`[data-testid="period-slider-track"]`) は `--ps-drag-*` (位置とラベルの配置) を、指を離した直後の収め戻しの間は `data-drag-snap="true"` と `--ps-drag-snap-duration` を持ちます。いずれも内部のもので、上書き口ではありません。配布スタイルシートは位置と配置の 24 個をトラック自身へ `initial` として宣言するため、ホストが同名の変数を宣言してもスライダーの描画には届きません。`--ps-drag-snap-duration` には宣言を置きません — この変数が無い間は収め戻しの宣言そのものが算出時に無効となるため、既定時間で勝手に動き出すことがないからです (コンポーネントは属性と一緒に必ずインラインで書きます)。
|
|
434
|
+
- **当たり判定のはみ出し**: スライダーの当たり判定がレール方向へ伸びる分は、ステッパーの表示・非表示のどちらでもルート要素が自分の箱の中へ確保するため、**レール方向には離隔が要りません**。残るのはセレクタの ◀▶ の四方 11px と、スライダーのレールの交差軸方向 (ステッパーを表示していれば 11px、`showStepper={false}` なら 18px。ルートの箱の厚みがボタンの箱 22px からレールの 8px へ薄くなる分だけ、丸つまみの 44px の当たり判定が外へ残ります) です。
|
|
435
|
+
|
|
436
|
+
| 境界 | 空ける量 (ステッパー表示 / 非表示) |
|
|
437
|
+
| :--- | ---: |
|
|
438
|
+
| セレクタの矢印 ⇄ 文字などの非操作要素 | 11px |
|
|
439
|
+
| セレクタ ⇄ セレクタ (縦横とも) | 22px |
|
|
440
|
+
| セレクタ ⇄ スライダー (レール方向に並べる) | 11px |
|
|
441
|
+
| セレクタ ⇄ スライダー (レールの交差軸方向に並べる) | 22px / 29px |
|
|
442
|
+
| スライダー ⇄ スライダー (レール方向) | 0px |
|
|
443
|
+
| スライダー ⇄ スライダー (交差軸方向) | 22px / 36px |
|
|
444
|
+
| スライダー ⇄ 文字などの非操作要素 (交差軸方向) | 11px / 18px |
|
|
445
|
+
|
|
446
|
+
空けないと、はみ出した当たり判定が隣の文字や部品の押下を受けます。押せるステッパーの当たり判定は `--aqps-z-handle-front` + 1 (既定 41) の層に載るため、`z-index` が 41 未満のホストの層に重なると、ステッパーの上でその層の押下を奪います。
|
|
447
|
+
- **ルート要素のレイアウトはコンポーネントが持つ**: `PeriodSlider` のルート要素はグリッド (`grid` / `gap` / `place-items`)、セレクタのルート要素は内容幅の `inline-flex` です。`className` には寸法と余白 (`flex-1`、`h-60`、`w-fit` など) だけを与えてください。
|
|
448
|
+
- **縦向きのスライダー**: トラックの長さはルート要素の高さから決まるため、高さを与えてください (与えないとトラックは 0px に潰れます)。幅は `w-fit` などで内容へ合わせます。
|
|
449
|
+
- **セレクタだけを使う場合もスタイルシートを読み込む**: 44px の当たり判定は、配布スタイルシートがパッケージ自身の要素 (`.period-slider` と 1 単位移動ボタン) に宣言する内部変数を読みます。読み込まないと押せる範囲はボタンの箱 (22px) だけになります。
|
|
450
|
+
|
|
421
451
|
### PeriodSlider Props
|
|
422
452
|
|
|
423
453
|
#### 全モード共通 Props
|
|
@@ -433,16 +463,16 @@ export function CustomLabelExample() {
|
|
|
433
463
|
| `labelPosition` | `"top" \| "bottom"` | `"top"` | 日付ラベルの表示位置 (スライダーの上側または下側) |
|
|
434
464
|
| `autoSlantLabels` | `boolean` | `true` | 近接時にラベルを斜め〜90° に自動傾斜させて重なりを防止 (Range の 1 対とノギスの 2 対へ対ごとに適用。垂直レイアウトでは適用されない) |
|
|
435
465
|
| `tooltipStyle` | `"always" \| "hover" \| "balloon"` | `"always"` | ツールチップの表示スタイル (`"always"`: 常時, `"hover"`: ポインター操作時, `"balloon"`: 吹き出し型)。`"balloon"` の宣言は `!important` 付きでユーティリティ層に勝つが、ノギスのツールチップだけは段の配色 (マクロ青 / ミクロ赤) を保ち、角丸・余白・文字サイズ・高さのみ吹き出し型になる |
|
|
436
|
-
| `isVertical` | `boolean` | `false` |
|
|
466
|
+
| `isVertical` | `boolean` | `false` | 垂直スライダー表示の有効化。**ホストが `className` で高さを与える必要があります** (トラックの長さはルート要素の高さ − 104px、`showStepper={false}` では高さ − 44px で、高さが無いと 0px に潰れて何も見えません) |
|
|
437
467
|
| `hideConnectBar` | `boolean` | `false` | 範囲選択バー (ハイライト) を非表示にし、独立 2 点選択 UI として利用 |
|
|
438
468
|
| `showTicks` | `boolean` | `false` | 離散モード時のトラック上の目盛線の表示有無 |
|
|
439
|
-
| `showStepper` | `boolean` | `true` |
|
|
469
|
+
| `showStepper` | `boolean` | `true` | ステッパーボタンの表示有無 (水平時は左右、垂直時は上下を指す矢印) |
|
|
440
470
|
| `formatLabel` | `(date: Date) => string` | `undefined` | 日付ラベル・ツールチップのカスタム表示文字列生成関数。`locale` より優先される |
|
|
441
471
|
| `locale` | `string` | `undefined` | 組み込み日付表記のロケール (BCP 47 言語タグ)。未指定はロケール非依存の ISO 8601 (`2025` / `2025-01` / `2025-01-15`)、指定時は `Intl.DateTimeFormat` 書式。空文字列・不正タグ・非文字列は `RangeError` |
|
|
442
472
|
| `disabled` | `boolean` | `false` | スライダーの無効化・非活性表示 |
|
|
443
473
|
| `debounceMs` | `number` | `0` | 変更コールバック呼び出しのデバウンス時間 (ミリ秒)。`0` は即時発火 |
|
|
444
474
|
| `colorScheme` | `PeriodSliderColorScheme` | `"blue-rose"` | カラーテーマプリセット (`"blue-rose"`, `"indigo-amber"`, `"teal-emerald"`, `"violet-fuchsia"`, `"slate-sky"`, `"monochrome"`) |
|
|
445
|
-
| `className` | `string` | `""` | 最外層コンテナ要素の追加 CSS
|
|
475
|
+
| `className` | `string` | `""` | 最外層コンテナ要素の追加 CSS クラス。ルート要素のレイアウト (`grid` / `gap` / `place-items`) はコンポーネントが持つため、寸法と余白だけを与える |
|
|
446
476
|
| `style` | `React.CSSProperties` | `undefined` | 最外層コンテナ要素のインラインスタイル。`--aqps-` カスタムプロパティを 1 台単位で注入する正式な経路 (「CSS カスタムプロパティ (スタイリング API)」を参照) |
|
|
447
477
|
|
|
448
478
|
#### Range モード専用 Props (`mode="range"`)
|
|
@@ -517,8 +547,8 @@ export function CustomLabelExample() {
|
|
|
517
547
|
| `pointAriaLabel` | `string` | `"Selected date"` (vernier 時点形態では `"Micro selected date"`) | 単一選択つまみのアクセシブル名 (`mode="point"`、およびノギスのミクロ時点形態) |
|
|
518
548
|
| `macroLowerAriaLabel` | `string` | `"Macro range start"` | マクロ下限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
519
549
|
| `macroUpperAriaLabel` | `string` | `"Macro range end"` | マクロ上限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
520
|
-
| `decreaseAriaLabel` | `string` | `"Decrease"` | 値を `minDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (
|
|
521
|
-
| `increaseAriaLabel` | `string` | `"Increase"` | 値を `maxDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (
|
|
550
|
+
| `decreaseAriaLabel` | `string` | `"Decrease"` | 値を `minDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (水平時は左端の左向き矢印、垂直時は下端の下向き矢印) |
|
|
551
|
+
| `increaseAriaLabel` | `string` | `"Increase"` | 値を `maxDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (水平時は右端の右向き矢印、垂直時は上端の上向き矢印) |
|
|
522
552
|
| `formatAriaValueText` | `(date: Date, unit: PeriodSliderUnit) => string` | `undefined` | `aria-valuetext` の読み上げ文字列生成関数。未指定時は可視ラベルと同一の文字列 (ISO 8601、`locale` 指定時は `Intl.DateTimeFormat` 書式)。ノギスでは可視ラベルと同じく、マクロ側に `macroUnit` 正規化済み、ミクロ側に `microUnit` 正規化済みの `Date` が渡される |
|
|
523
553
|
|
|
524
554
|
ステッパーの 2 つの名称は配置ではなく値への作用で定義されています。同じボタンが水平レイアウトでは左、垂直レイアウトでは下に立つため、位置で命名すると意味が反転するからです。
|
|
@@ -541,13 +571,16 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
541
571
|
|
|
542
572
|
| フック | 対象 |
|
|
543
573
|
| :--- | :--- |
|
|
544
|
-
| `[data-mode="range" \| "point" \| "vernier"]` | ルート要素。`data-unit` / `data-orientation` / `data-label-position` / `data-color-scheme` / `data-disabled`
|
|
574
|
+
| `[data-mode="range" \| "point" \| "vernier"]` | ルート要素。`data-unit` / `data-orientation` / `data-label-position` / `data-color-scheme` / `data-disabled` を併せ持つ。インライン `style` に `--ps-label-reach-before` / `--ps-label-reach-after` / `--ps-label-reach-main` (範囲領域の厚みとレール方向の伸びに使う実測値) を持つことがある。上書きの口ではないが、ホストが自分の層を避けるために**読む**ことは想定しており、名前と意味は保つ (配置の注意を参照) |
|
|
545
575
|
| `[role="slider"]` | すべてのつまみ。`aria-label` (既定 `"Range start"` / `"Range end"` / `"Selected date"` / `"Macro range start"` / `"Macro range end"` / `"Micro range start"` / `"Micro range end"` / `"Micro selected date"`) で個々のつまみを識別でき、`data-active` / `data-front` が操作状態を表す。個数はモードと形態で決まり、`range` は 2、`point` は 1、ノギスの期間形態は 4、ノギスの時点形態は 3 |
|
|
546
576
|
| `[data-testid="period-slider-knob"]` | `range` / `point` モードのつまみ本体 (円形ノブ)。つまみの位置・寸法の測定に用いる |
|
|
547
577
|
| `[data-handle-type="macro-low" \| "macro-high" \| "micro-low" \| "micro-high" \| "micro-point"]` | ノギスモードのつまみのみに付与 (`role="slider"` との併用)。`micro-low` / `micro-high` はミクロが期間の形態、`micro-point` はミクロが時点の形態でのみ現れ、両者が同時に存在することはない。配置位置は `data-vernier-pos` (`top` / `bottom` / `left` / `right`) が持ち、配色を決める `data-handle-type` と直交する |
|
|
548
578
|
| `[data-testid="period-slider-track"]` | トラック (`data-vernier-orientation` でノギスのレール配置を判別) |
|
|
579
|
+
| `[data-range-area]` | 範囲領域 (ルート要素の最初の子)。`Shift` + ホイールを受ける矩形そのもので、何も描かず `pointer-events: none` のためヒットテストにも答えない |
|
|
580
|
+
| `button[aria-label]` 内の `svg[data-arrow="left" \| "right" \| "up" \| "down"]` | ステッパー (アクセシブル名は `decreaseAriaLabel` / `increaseAriaLabel`、`type="button"`) とその矢印の向き。矢印は色を持たず、ボタンの文字色 (`currentColor`) で塗られる (パッケージのスタイルシートも、ボタンや祖先のクラスも矢印を選ばない)。ホバーの文字色は不透明で、押せる矢印をホバーで使用不可の淡色へ落とさない。境界で動けない間はボタンが `aria-disabled="true"` を持ち、フォーカスを保ちタブ順にも残ったまま押下を受け付けない。ネイティブの `disabled` は `disabled` Props でスライダー全体を無効にしたときだけ付く |
|
|
549
581
|
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 (ミクロが時点の形態では `period-slider-connect-micro` を描かない) |
|
|
550
|
-
| `[data-testid="period-slider-tick"]` |
|
|
582
|
+
| `[data-testid="period-slider-tick"]` | 目盛線と離散レールの候補点。ノギスモードでは `data-tick-scale="macro" \| "micro"` が併記され上下段を判別できる。塗りはパッケージのスタイルシートが 1 か所で持つ (レールの境界線と同じインク) |
|
|
583
|
+
| `[data-testid="period-slider-hairline"]` | ノギスの読み取りの針 (`showHairline` が真のときだけ描かれる)。線の中心がつまみの中心 = 値そのものに揃う |
|
|
551
584
|
| `[data-testid="period-slider-hover-guide"]` | ポインターオーバーレイ (点と追従ラベルを束ねる器)。`range` / `point` のみで、ノギスモードでは描かれない |
|
|
552
585
|
| `[data-testid="period-slider-hover-dot"]` | オーバーレイの点 (ポインター位置そのものを示す。重複時も表示され続ける) |
|
|
553
586
|
| `[data-testid="period-slider-hover-tooltip"]` | オーバーレイの追従ラベル。指している値がつまみの確定値と一致する間は `data-duplicate="true"` が付いて `visibility: hidden` になる |
|
|
@@ -573,7 +606,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
573
606
|
| `PeriodSlider` (`vernier`) | 期間系の Props だけを渡し `microRange` / `defaultMicroRange` が共に未指定 | `RangeError: PeriodSlider: vernier range mode requires a micro selection; supply microRange (controlled) or defaultMicroRange (uncontrolled)` |
|
|
574
607
|
| `PeriodSlider` (`vernier`) | 指定された `microRange` / `defaultMicroRange` が 2 要素タプル以外・Invalid Date・逆転 | `RangeError: PeriodSlider: <プロパティ名> ...` |
|
|
575
608
|
| `PeriodSlider` (`vernier`) | 指定された `microValue` / `defaultMicroValue` が Invalid Date | `RangeError: PeriodSlider: <プロパティ名> must be a valid Date (received: ...)` |
|
|
576
|
-
| `PeriodSlider`
|
|
609
|
+
| `PeriodSlider` | 指定された `range` / `defaultRange` / `value` / `defaultValue` が `unit` の解像度で `[minDate, maxDate]` の外 | `RangeError: PeriodSlider: <プロパティ名> must lie within [minDate, maxDate] (...)` |
|
|
610
|
+
| `PeriodSlider` (`vernier`) | 指定されたミクロ選択が `microUnit` の解像度で `[minDate, maxDate]` の外 | `RangeError: PeriodSlider: <プロパティ名> must lie within [minDate, maxDate] (...)` (`macroRange` は定義域をはみ出してよい。レールが定義域と積を取り、通知はクランプ済みの値を配るため) |
|
|
577
611
|
| `PeriodSlider` | `allowedDates` の全要素が `[minDate, maxDate]` 外 | `RangeError: getSortedAllowedDates: every allowedDates entry falls outside [minDate, maxDate] (...)` |
|
|
578
612
|
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSliderRange` / `useVernierSliderPoint` | 境界・初期値の欠落、Invalid Date、逆転 | `RangeError: <フック名>: ...` |
|
|
579
613
|
| `PeriodSlider` | `locale` が空文字列・構造として不正な BCP 47 タグ・非文字列 | `RangeError: PeriodSlider: locale must be a valid BCP 47 language tag (received: ...)` |
|
|
@@ -584,6 +618,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
584
618
|
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date または `Date` でない (添字付きで報告)、Date / 年 Props の不正値 | ``RangeError: MonthSelector: `allowedMonths[1]` must be a valid Date, received ....`` 等 |
|
|
585
619
|
| `DateSelector` | Date / 年 Props の不正値、解決後の範囲が空、バリアントが要求する境界の欠落、`variant="split-dropdown"` への `allowedDates` 指定 | `RangeError` |
|
|
586
620
|
|
|
621
|
+
**定義域の内包は、値が載るレールの解像度で判定します。** レールが描くのは単位まるごと (年・月・日) であるため、`minDate` が期間の途中を指す場合 (`unit="month"` に `2026-09-15`、`unit="day"` に時刻を持つ `new Date()` など) は、その期間まるごと (`2026-09-01`) がレールの先頭として描かれ、`Home` キー・ステッパー・ドラッグ・フックはいずれもその日付を確定値として配ります。したがってその日付をそのまま制御 Props (`range` / `value` / `microRange` など) へ戻しても受理されます。1 単位でも外れた日付は従来どおり `RangeError` です。
|
|
622
|
+
|
|
587
623
|
`DateSelector` は構成そのものの矛盾を優先して報告します。`variant="split-dropdown"` と `allowedDates` の併用は、`value` / `initialDate` の欠落よりも先に判定されます。
|
|
588
624
|
|
|
589
625
|
### カラーテーマ & ダークモード
|
|
@@ -647,7 +683,7 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
647
683
|
|
|
648
684
|
#### 配色 (`colorScheme` プリセットが与える 11 変数)
|
|
649
685
|
|
|
650
|
-
既定値は `colorScheme="blue-rose"` (既定プリセット) のもので、プリセットを変えると 11
|
|
686
|
+
既定値は `colorScheme="blue-rose"` (既定プリセット) のもので、プリセットを変えると 11 個すべてが入れ替わります。公開エクスポート `COLOR_SCHEME_PALETTES` から取得できるのは、このうち基調色と明色の 5 つ (`macro` / `macroLight` / `micro` / `microLight` / `accent`) だけです。光彩の 3 つと文字色の 2 つは `ColorSchemePalette` が持たず、スタイルシート側 (`[data-color-scheme=…]`) だけが値を持ちます。`--aqps-macro-color` / `--aqps-micro-color` を上書きする場合は、対になる `--aqps-*-on-color` も同時に上書きしてコントラスト比 4.5:1 を再確認してください。
|
|
651
687
|
|
|
652
688
|
| 変数 | 制御対象 | 既定値 |
|
|
653
689
|
| :--- | :--- | :--- |
|
|
@@ -700,8 +736,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
700
736
|
適用範囲の限界は次のとおりです (いずれも詳細度が高い既存規則が勝つため、意図した優先順位です)。
|
|
701
737
|
|
|
702
738
|
- **ノギスのラベルは配色 2 変数を無視します**: マクロ青・ミクロ赤というセマンティック配色 (`--aqps-macro-color` / `--aqps-micro-color`) が `--aqps-label-bg` / `--aqps-label-fg` に勝ちます。文字寸法・余白・角丸の 3 変数はノギスのラベルにも効きます。
|
|
703
|
-
- **`tooltipStyle="balloon"` は見た目 5 項目を固定します**:
|
|
704
|
-
-
|
|
739
|
+
- **`tooltipStyle="balloon"` は見た目 5 項目を固定します**: 吹き出し様式は背景・文字色・文字寸法・余白・角丸を自前の値で宣言するため、対応する変数は効きません (文字色は明るい塗りの上で 9.93:1 を確保する暗色です)。`--aqps-label-rail-gap` は効きます。
|
|
740
|
+
- **ラベルの高さは文字寸法に追従します**: 箱の高さは `--aqps-label-font-size` と同じ比率 (行送りと同一の $4/3$) で書かれているため、文字寸法をどう変えても行箱とボーダーボックスが一致し、文字が箱の外へ出ません (既定の `0.75rem` では 16px)。箱をさらに大きくしたい場合は `--aqps-label-padding` の上下方向を増やしてください (`box-sizing: border-box` のため、上下余白と枠線の合計が行箱を超えた分だけ高さが伸びます)。衝突回避の幾何はラベルの実測ボーダーボックスを見ているため、いずれの場合も離隔は破綻しません。
|
|
705
741
|
|
|
706
742
|
##### 丸つまみとラベルの離隔は変数になっていません
|
|
707
743
|
|
|
@@ -719,6 +755,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
719
755
|
|
|
720
756
|
3 つのセレクタはいずれも `value` (制御) または `initialDate` (非制御) で選択値を受け取り、両脇の ◀▶ ステッパーボタンで 1 単位ずつ移動します。
|
|
721
757
|
|
|
758
|
+
◀▶ は押せる間だけ、ポインターを載せると矢印の色が背景から際立ち (ライトでは濃く、ダークでは明るく) 淡い面が現れ、キーボードフォーカスで青いリングが付きます。押せる範囲は矢印を中心とする 44px 四方で、隣のセレクトボックスや日付入力の縁で止まります。境界に着いて動けない ◀▶ はフォーカスを保ち、タブ順にも残ったまま使用不可 (`aria-disabled="true"`) になり、押しても何も発行しません (キーボードで押し続けて境界に着いても、フォーカスが文書へ落ちません)。ネイティブの `disabled` が付くのは `disabled` Props でセレクタ全体を無効にしたときだけで、そのときは全てのバリアントで ◀▶ の両方がセレクトや日付入力と共にタブ順から外れます。
|
|
759
|
+
|
|
722
760
|
> [!NOTE]
|
|
723
761
|
> `variant="date"` のネイティブ入力 (`<input type="date">` / `<input type="month">`) は、同じ値を示す `variant="dropdown"` と並んだときに別物に見えないよう、同じ書体・字送り・面で描かれます。中央寄せだけはユーティリティでは届きません — Tailwind preflight が `::-webkit-datetime-edit` を `inline-flex` にするため `text-align` が余白を配らないからです。そこで同梱スタイルシートの公開クラス `.period-slider-native-date-field` が、編集領域を全幅化して中央へ寄せ、カレンダー起動子を絶対配置で桁送りから外します。自前のマークアップで同じ揃えが必要な場合はこのクラスを付けてください。preflight を適用しないホストでは編集領域が flex にならず、これらの宣言は無害に無視されます。
|
|
724
762
|
|
|
@@ -733,7 +771,7 @@ export function SelectorsExample() {
|
|
|
733
771
|
const [currentDate, setCurrentDate] = useState<Date>(new Date(2024, 5, 15))
|
|
734
772
|
|
|
735
773
|
return (
|
|
736
|
-
<div className="flex flex-col gap-
|
|
774
|
+
<div className="flex flex-col gap-6">
|
|
737
775
|
{/* 年セレクタ (境界必須) */}
|
|
738
776
|
<YearSelector
|
|
739
777
|
value={currentDate}
|
|
@@ -776,7 +814,7 @@ export function SelectorsExample() {
|
|
|
776
814
|
| `minDate` | `Date` | `undefined` | 選択可能な最小日付 (年のみ使用)。`minYear` と併用時は厳しい方を採用 |
|
|
777
815
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付 (年のみ使用)。`maxYear` と併用時は厳しい方を採用 |
|
|
778
816
|
| `onChange` | `(date: Date, year: number) => void` | `undefined` | 年変更時コールバック。`date` は該当年の 1 月 1 日ローカル 0 時 |
|
|
779
|
-
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange`
|
|
817
|
+
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
780
818
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
781
819
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
782
820
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
@@ -786,7 +824,7 @@ export function SelectorsExample() {
|
|
|
786
824
|
| `locale` | `string` | `undefined` | 選択肢テキストのロケール (BCP 47 言語タグ)。未指定は 4 桁ゼロ埋めの年、指定時は `Intl.DateTimeFormat` 書式。空文字列・不正タグ・非文字列は `RangeError` |
|
|
787
825
|
| `unit` | `"year" \| "month" \| "day"` | `undefined` | **不活性 Props**。フックの `SelectorProps` をスプレッドするための受け口で、描画・挙動には一切影響しない |
|
|
788
826
|
|
|
789
|
-
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1 件加えてそのまま表示します。ステッパーは移動先の年が境界内にある場合だけ有効です (境界の 1
|
|
827
|
+
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1 件加えてそのまま表示します。ステッパーは移動先の年が境界内にある場合だけ有効です (境界の 1 つ外側では戻る側だけが有効、それより外では両方とも使用不可 (`aria-disabled="true"`、フォーカスは保持))。境界外の年が `onChange` へ渡ることはありません。
|
|
790
828
|
|
|
791
829
|
#### `MonthSelector` Props
|
|
792
830
|
|
|
@@ -804,7 +842,7 @@ export function SelectorsExample() {
|
|
|
804
842
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付 (月頭に切り捨て)。`maxYear` と併用時は厳しい方を採用 |
|
|
805
843
|
| `onChange` | `(date: Date, yyyymm: number) => void` | `undefined` | 選択可能な月が選ばれた時のコールバック。`date` は該当月 1 日ローカル 0 時、`yyyymm` は `年 * 100 + 月` の整数 |
|
|
806
844
|
| `isWarning` | `boolean` | `false` | 警告枠スタイル (アンバー) の適用フラグ。`variant` を問わず有効 |
|
|
807
|
-
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange`
|
|
845
|
+
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
808
846
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
809
847
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
810
848
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
@@ -819,7 +857,7 @@ export function SelectorsExample() {
|
|
|
819
857
|
- 選択可能集合は `allowedMonths` (離散) または [`minDate` / `minYear`, `maxDate` / `maxYear`] (連続) が決定します。両方を指定した場合は積 (境界内の許容月のみ) になります。
|
|
820
858
|
- `variant="dropdown"`: `allowedMonths` を指定しない場合、下限と上限の双方が必須です。`allowedMonths` を指定した場合は境界を省略でき、選択肢は許容月だけを降順に並べます (存在しない月を選択肢に挟みません)。
|
|
821
859
|
- `variant="date"`: 境界は任意です。指定した場合は `<input type="month">` の `min` / `max` 属性へ反映されます (`allowedMonths` の最古 / 最新は `min` / `max` に写しません — 宣言した境界だけが属性になります)。
|
|
822
|
-
- ステッパーは連続指定時に ±1 ヶ月、離散指定時に隣接する許容月へ移動し (四半期おきの集合なら 3 ヶ月飛ぶ)
|
|
860
|
+
- ステッパーは連続指定時に ±1 ヶ月、離散指定時に隣接する許容月へ移動し (四半期おきの集合なら 3 ヶ月飛ぶ)、集合の端では使用不可 (`aria-disabled="true"`) になります。
|
|
823
861
|
- 選択可能集合外の直接入力 (`input` / `select` の `change`) は丸められず破棄され、`onChange` は発火しません。
|
|
824
862
|
- 境界外・集合外の `value` / `initialDate` は `RangeError` になりません (集合外の表示は下記 DOM 契約の責務です)。
|
|
825
863
|
|
|
@@ -847,7 +885,7 @@ const allowedMonths = useMemo(() => baseMonths.map((yyyymm) => new Date(Math.tru
|
|
|
847
885
|
| `minDate` | `Date` | `undefined` | 選択可能な最小日付。`minYear` と併用時は厳しい方を採用 |
|
|
848
886
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付。`maxYear` と併用時は厳しい方を採用 |
|
|
849
887
|
| `onChange` | `(date: Date) => void` | `undefined` | 選択日付変更時コールバック。選択可能集合内の日付でのみ発火し、ローカル 0 時に正規化された `Date` を渡す |
|
|
850
|
-
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange`
|
|
888
|
+
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
851
889
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
852
890
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
853
891
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
@@ -869,10 +907,10 @@ const allowedMonths = useMemo(() => baseMonths.map((yyyymm) => new Date(Math.tru
|
|
|
869
907
|
- `variant="dropdown"`: `allowedDates` を指定しない場合、下限と上限の双方が必須です。境界を与えると `minDate` 〜 `maxDate` の全日が選択肢として展開されるため、広い範囲では `variant="date"` の利用を推奨します (例: 3 年間で 1,095 個の `<option>`)。
|
|
870
908
|
- `variant="split-dropdown"`: 下限と上限の双方が必須で、`allowedDates` との併用は `RangeError` になります。存在しない日付になる年・月へ切り替えた場合 (1 月 31 日を選択中に 2 月へ変更等)、月末日へ丸めず選択を破棄し、`onChange` を発火しません。選択肢のテキストは既定でゼロ埋めの数値 (`2024` / `01` / `15`) で、`locale` または `formatYearOption` / `formatMonthOption` / `formatDayOption` で変更できます。
|
|
871
909
|
- `variant="date"`: 境界は任意です。指定した場合は `<input>` の `min` / `max` 属性へ反映されます。
|
|
872
|
-
-
|
|
910
|
+
- ステッパーは離散指定時に隣接する選択可能日へ移動し、集合の端では使用不可 (`aria-disabled="true"`) になります。
|
|
873
911
|
- 選択可能集合外の日付は丸められず破棄され、`onChange` は発火しません。
|
|
874
912
|
|
|
875
|
-
DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を持ち、現在値が選択可能集合の外にある場合は `data-out-of-range="true"`
|
|
913
|
+
DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を持ち、現在値が選択可能集合の外にある場合は `data-out-of-range="true"` が付与されます。`variant="dropdown"` / `variant="split-dropdown"` ではさらに、各 `<select>` の先頭に現在値を表示する選択不可のプレースホルダ `<option value="">` が描画され (このとき `select.value === ""`)、`variant="date"` では `<input type="date">` が保持値をそのまま表示します。
|
|
876
914
|
|
|
877
915
|
### React フック
|
|
878
916
|
|
package/dist/DateSelector.d.ts
CHANGED
|
@@ -11,9 +11,9 @@ import { default as React } from 'react';
|
|
|
11
11
|
* 部位別フォーマッタを通じた利用側の選択。
|
|
12
12
|
*/
|
|
13
13
|
export interface DateSelectorProps {
|
|
14
|
-
/** Controlled selected date; required unless `initialDate` is supplied; must be a valid Date /
|
|
14
|
+
/** Controlled selected date; required unless `initialDate` is supplied; must be a valid Date / 選択日付 (外部制御用・`initialDate` 未指定時は必須・Invalid Date 不可) */
|
|
15
15
|
value?: Date;
|
|
16
|
-
/** Initial selected date; required unless `value` is supplied; must be a valid Date /
|
|
16
|
+
/** Initial selected date; required unless `value` is supplied; must be a valid Date / 初期選択日付 (非制御用・`value` 未指定時は必須・Invalid Date 不可) */
|
|
17
17
|
initialDate?: Date;
|
|
18
18
|
/** Callback triggered when a selectable date is chosen / 選択可能な日付が選ばれた時のコールバック */
|
|
19
19
|
onChange?(date: Date): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAC9B,qJAAqJ;IACrJ,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,uIAAuI;IACvI,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,iFAAiF;IACjF,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gHAAgH;IAChH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,gHAAgH;IAChH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,4GAA4G;IAC5G,YAAY,CAAC,EAAE,IAAI,EAAE,CAAA;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAAA;IAChD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oGAAoG;IACpG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sGAAsG;IACtG,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0PAA0P;IAC1P,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gKAAgK;IAChK,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3C,oMAAoM;IACpM,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7C,gMAAgM;IAChM,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAC5C;AAklBD;;;GAGG;AACH,eAAO,MAAM,YAAY,oCA5Wa,iBAAiB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoYzE,CAAA"}
|
package/dist/MonthSelector.d.ts
CHANGED
|
@@ -11,9 +11,9 @@ import { default as React } from 'react';
|
|
|
11
11
|
* 通じた利用側の選択。
|
|
12
12
|
*/
|
|
13
13
|
export interface MonthSelectorProps {
|
|
14
|
-
/** Controlled selected date; required unless `initialDate` is supplied /
|
|
14
|
+
/** Controlled selected date; required unless `initialDate` is supplied / 選択日付 (外部制御用・`initialDate` 未指定時は必須) */
|
|
15
15
|
value?: Date;
|
|
16
|
-
/** Initial selected date; required unless `value` is supplied /
|
|
16
|
+
/** Initial selected date; required unless `value` is supplied / 選択日付 (非制御用・`value` 未指定時は必須) */
|
|
17
17
|
initialDate?: Date;
|
|
18
18
|
/** Callback triggered when a selectable month is chosen / 選択可能な月が選ばれた時のコールバック */
|
|
19
19
|
onChange?(date: Date, yyyymm: number): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;
|
|
1
|
+
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,+GAA+G;IAC/G,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,+FAA+F;IAC/F,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,iFAAiF;IACjF,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7B,oQAAoQ;IACpQ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sQAAsQ;IACtQ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+IAA+I;IAC/I,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,+IAA+I;IAC/I,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,oKAAoK;IACpK,aAAa,CAAC,EAAE,IAAI,EAAE,CAAA;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,oPAAoP;IACpP,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAiYD;;;;GAIG;AACH,eAAO,MAAM,aAAa,oCAlNa,kBAAkB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6O3E,CAAA"}
|