@aiquants/period-slider 0.8.0 → 0.10.0
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 +73 -0
- package/README.md +85 -40
- 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 +203 -15
- 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 +4 -3
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1964 -1683
- 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 +15 -11
- package/dist/usePeriodSlider.d.ts.map +1 -1
- package/package.json +2 -1
- package/src/DateSelector.tsx +12 -28
- package/src/MonthSelector.tsx +13 -26
- package/src/PeriodSlider.tsx +1545 -572
- package/src/StepperButton.tsx +251 -0
- package/src/YearSelector.tsx +9 -23
- package/src/dragPresentation.ts +273 -0
- package/src/index.ts +8 -4
- package/src/rangeAreaWheel.ts +285 -0
- package/src/styles/period-slider.css +332 -108
- package/src/usePeriodSlider.ts +243 -90
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to `@aiquants/period-slider` are documented here.
|
|
4
|
+
|
|
5
|
+
## Unreleased
|
|
6
|
+
|
|
7
|
+
範囲領域 (range area) の `Shift` + ホイール、ステッパーの矢印言語、ドラッグの連続描画。統治文書はリポジトリの
|
|
8
|
+
`docs/plans/2026.09.17 [AI] range-area-shift-wheel-and-stepper-arrow-language-implementation-plan.md` と
|
|
9
|
+
`docs/plans/2026.09.18 [AI] continuous-drag-presentation-implementation-plan.md` (どちらも公開物には同梱しません)。
|
|
10
|
+
|
|
11
|
+
### 利用側の契約が変わる点 (0.9.0 からの移行)
|
|
12
|
+
|
|
13
|
+
- **境界に着いたステッパー / セレクタの ◀▶ はネイティブの `disabled` を持ちません**。`aria-disabled="true"` で
|
|
14
|
+
使用不可を伝え、フォーカスとタブ順を保ちます (キーボードで押し続けた利用者がフォーカスを失わないため)。
|
|
15
|
+
- 利用側の表明は `toBeDisabled()` から `toHaveAttribute("aria-disabled", "true")` + 「クリックで何も発火しない」へ
|
|
16
|
+
移してください。押下は捕捉フェーズで飲み込むため、`mousedown` / `mouseup` / `click` は React のルートコンテナ
|
|
17
|
+
より下のもの (ボタン自身・ホストの祖先) へ 1 つも届かず、押下がフォーカスを奪うこともありません。
|
|
18
|
+
ネイティブの `disabled` と同じく `pointerdown` / `pointerup` は配送されます。
|
|
19
|
+
- **矢印は文字グリフではなく `svg[data-arrow="left" | "right" | "up" | "down"]` です**。テキストで `◀` / `▶` を
|
|
20
|
+
探しているロケータは当たりません。
|
|
21
|
+
- **ルート要素がレール方向に当たり判定の予約を持ちます** (`px-[19px]` / `py-[19px]`、`showStepper={false}` では
|
|
22
|
+
`px-[calc(var(--ps-target-size)/2)]`)。同じ幅を与えたときのレールは 38px (ステッパー非表示時は 44px) 短くなります。
|
|
23
|
+
縦向きのトラック長は「高さ − 104px」、`showStepper={false}` では「高さ − 44px」です。
|
|
24
|
+
- **セレクタのルートから外側の余白 (`mx-1` / `my-auto`) と固定幅 (`w-32` / `w-38`) が無くなりました**。離隔はホストが
|
|
25
|
+
持ちます (必要量の表は README の「配置の注意」)。ルートは内容幅になり、既定の書式では `YearSelector` が 128px から
|
|
26
|
+
138px へ、`MonthSelector` と `DateSelector` が 152px から 178px へ変わります。2 つのセレクタを縦に積んで幅が
|
|
27
|
+
揃うことに依存しているレイアウトは、上げ直しの際に整列を確かめてください。
|
|
28
|
+
- **公開エクスポートから `getActiveDragHandle` が消え、`resolveDraggedEdge` が入りました**。交差の判定は値空間の
|
|
29
|
+
比較ではなく、描かれているつまみの比率で行います。
|
|
30
|
+
- **ドラッグは掴んだ要素へポインターを捕捉します** (`setPointerCapture`)。`jsdom` はこの API を実装していないため、
|
|
31
|
+
利用側の `jsdom` テストは `ResizeObserver` と同じくシムが要ります (`Element.prototype.setPointerCapture` /
|
|
32
|
+
`releasePointerCapture` / `hasPointerCapture`)。
|
|
33
|
+
- **ノギスの `onChangeMacroRange` / `onChangeMicroRange` は、選択が動いていない操作では鳴りません**。判定基準は
|
|
34
|
+
確定している選択そのもので、平レールの `onChangeRange` / `onChangePoint` と同じ規則です (押しただけで動かさない
|
|
35
|
+
操作や、マクロ窓だけを動かした操作でミクロ側が鳴ることはありません)。
|
|
36
|
+
|
|
37
|
+
### 追加
|
|
38
|
+
|
|
39
|
+
- 範囲領域のどこでも (インジケーターの真上でなくても) `Shift` + ホイールで選択が 1 単位ずつ平行移動します。
|
|
40
|
+
持ち主は幾何で決まり (トラック中心線が最も近いスライダー、同距離ならマウント順で先のもの)、描かれていない
|
|
41
|
+
スライダー (`visibility: hidden` / `display: none` / 切り取る祖先の中) はどの点も持ちません。
|
|
42
|
+
- ドラッグ中、掴んだ部品はポインターそのものの位置へ描かれ、指を離すと確定位置へ収まります
|
|
43
|
+
(`data-drag-snap="true"` と `--ps-drag-snap-duration`)。公開 Props は増えません。
|
|
44
|
+
- トラックを押して指を動かさずに離すと、最寄りの対象がその位置へ寄ります (WCAG 2.2 SC 2.5.7)。
|
|
45
|
+
- 1 つの操作が押下から解放まで値の持ち主です。掴んでいる間、2 本目のポインター・ホイール・矢印キー・ステッパーは
|
|
46
|
+
値を動かしません。
|
|
47
|
+
- ノギスの読み取りの針が `data-testid="period-slider-hairline"` を持ちます。
|
|
48
|
+
|
|
49
|
+
### 見た目が変わる点
|
|
50
|
+
|
|
51
|
+
- **目盛のインクがレールの境界線と同じになりました** (ライト `#64748b`、ダーク `#90a1b9`)。ノギスの目盛線も離散
|
|
52
|
+
レールの候補点も、載っているレールの塗りに対し 3:1 以上になります (SC 1.4.11。以前は 1.20:1 と 1.53:1)。
|
|
53
|
+
候補点は自分のユーティリティで塗らなくなり、目盛と同じ 1 つのインクを受けます。
|
|
54
|
+
- **強制カラー (`forced-colors: active`) で目盛と針が残ります**。以前はどちらも背景色だけで描かれていたため、
|
|
55
|
+
UA の置き換えでページ・レールと同じ色になって消えていました。
|
|
56
|
+
- **読み取りの針が線の中心を値へ合わせます** (以前は箱の縁を合わせており、目盛との間に 0.5px のずれが残っていました)。
|
|
57
|
+
|
|
58
|
+
### 修正
|
|
59
|
+
|
|
60
|
+
- **ノギスの半円つまみが強制カラーで消えなくなりました**。UA は SVG の `fill` / `stroke` を置き換えない
|
|
61
|
+
(算出 `forced-color-adjust` が `preserve-parent-color` になる) ため、以前は author の色がそのまま残り、
|
|
62
|
+
`colorScheme="monochrome"` のミクロつまみは強制カラーの暗色背景に対し 1.19:1 で見えませんでした。
|
|
63
|
+
縁を `CanvasText`、面を `Canvas` (掴んでいる間は `Highlight`) で塗り直します。
|
|
64
|
+
- **定義域の内包を、値が載るレールの解像度で判定します**。`unit="month"` に `2026-09-15` のような期間途中の
|
|
65
|
+
`minDate` を渡すと、レールの先頭は `2026-09-01` であり、`Home` キー・ステッパー・ドラッグ・フックはいずれも
|
|
66
|
+
その日付を確定値として配ります。以前はその値をそのまま制御 Props (`range` / `value` / `microRange` 等) へ
|
|
67
|
+
戻すと `RangeError` で利用側の木が落ちました。フック 4 種の窓内包も同じ解像度になり、`microUnit="day"` で
|
|
68
|
+
`maxDate` と同じ値 (`new Date()` の形) を初期ミクロ選択に渡す構成も通ります。1 単位でも外れた値は従来どおり
|
|
69
|
+
`RangeError` です。
|
|
70
|
+
- **別文書へ `createPortal` したスライダー (ポップアウトのパネル、同一オリジンの `<iframe>`) が操作を受け取ります**。
|
|
71
|
+
ポインター操作の 4 つのリスナーは、モジュールを読み込んだ文書ではなくスライダーが描かれている文書の `window` へ
|
|
72
|
+
張ります (以前は最初の押下で掴みが永久に生き続け、ホイール・矢印キー・ステッパーを締め出したままでした)。
|
|
73
|
+
ホイールのヒットテストとステッパーの例外も realm に束縛される `instanceof` をやめ、`Node.contains` で判定します。
|
package/README.md
CHANGED
|
@@ -39,25 +39,30 @@
|
|
|
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 ノギスハンドル含む)。
|
|
63
|
+
- **`Shift` + ホイールによる平行移動**: スライダーの範囲領域 (レールの行・つまみとラベルが描かれる帯 — レール方向にもラベルの外縁まで — ・ステッパー) のどこでも `Shift` を押しながらホイールを回すと、選択がステッパーと同じ ±1 単位だけ平行移動します。インジケーターの真上である必要はありません。`Shift` 無しの素のホイールはページのスクロールのままで、ページのスクロールを奪うのは `Shift` 付きのホイールが使えるデルタを運んでいるときだけです (選択が端に着いていて結果的に何も動かない場合も、操作は範囲領域へ向けられているため奪います)。縦向きレールではレールの正方向が上のため符号が反転します。ノギスではポインターがトラック中心線のどちら側にあるかで段 (マクロレールならマクロ窓、ミクロレールならミクロ選択) が決まり、ステッパーの上ではクリックと同じミクロ選択が動きます。
|
|
64
|
+
- **レールが描く位置だけを名乗り、そこだけを確定させる**: 離散ミクロレール (`microIsDiscrete`) は候補集合しか描かないため、つまみの位置・読み上げ値・ラベル・そして確定値がすべて同じ 1 規則 (候補があれば最近傍候補、無ければ窓へのクランプ) を読みます。つまみが描かれている場所と利用側が受け取る値が食い違いません。
|
|
65
|
+
- **マクロ窓の両境界は対**: ノギスのミクロレールは、マクロつまみが名乗る期間をちょうど覆います。`macroRange` に期間の途中を指す日付を渡しても、開始側は先頭マクロ期間の先頭へ (`getMacroWindowStartDate`)、終了側は末尾マクロ期間の末日へ (`getMacroWindowEndDate`) 揃います (例: `2026-09-15`〜`2026-10-15` は `2026-09-01`〜`2026-10-31`)。丸めた窓が `[minDate, maxDate]` をはみ出す場合は定義域で切り落とされ、この交差は `resolveMacroWindow` が一手に引き受けます — レール・フックの収め込み・ミクロセレクタが同じ窓を読むため、どの経路も定義域外のミクロ日付を確定させません。
|
|
61
66
|
|
|
62
67
|
## インストール
|
|
63
68
|
|
|
@@ -65,6 +70,10 @@
|
|
|
65
70
|
pnpm add @aiquants/period-slider
|
|
66
71
|
```
|
|
67
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
|
+
|
|
68
77
|
## 使用方法
|
|
69
78
|
|
|
70
79
|
### スタイル読み込み
|
|
@@ -85,7 +94,7 @@ import "@aiquants/period-slider/styles/period-slider.standalone.css"
|
|
|
85
94
|
| `styles/period-slider.standalone.css` | テーマ変数・ユーティリティを同梱した自己完結スタイル | ホストに Tailwind ビルドが無い場合 |
|
|
86
95
|
|
|
87
96
|
> [!IMPORTANT]
|
|
88
|
-
> A を選ぶ場合、ホスト側の Tailwind エントリ CSS に次の
|
|
97
|
+
> A を選ぶ場合、ホスト側の Tailwind エントリ CSS に次の 3 行が必須です。
|
|
89
98
|
>
|
|
90
99
|
> ```css
|
|
91
100
|
> @import "tailwindcss";
|
|
@@ -93,7 +102,7 @@ import "@aiquants/period-slider/styles/period-slider.standalone.css"
|
|
|
93
102
|
> @custom-variant dark (&:where(.dark, .dark *));
|
|
94
103
|
> ```
|
|
95
104
|
>
|
|
96
|
-
> - `@source`: Tailwind CSS v4 は既定で `node_modules` を走査しないため、これが無いとパッケージが出力するユーティリティクラス (`
|
|
105
|
+
> - `@source`: Tailwind CSS v4 は既定で `node_modules` を走査しないため、これが無いとパッケージが出力するユーティリティクラス (`grid`, `rounded-full`, `not-aria-disabled:hover:*`, `dark:*`, `forced-colors:*` 等の状態・バリアント付きのものを含む) が一切生成されず、コンポーネントが未装飾のテキストとして描画されます。
|
|
97
106
|
> - `@custom-variant dark`: Tailwind CSS v4 の `dark:` は既定で `@media (prefers-color-scheme: dark)` にコンパイルされます。これが無いと `.dark` クラスでは切り替わらず、手書きクラスで配色を持つスライダー本体だけが暗転し、`dark:` ユーティリティで配色を持つ 3 セレクタ (`YearSelector`, `MonthSelector`, `DateSelector`) が明色のまま取り残されます。
|
|
98
107
|
>
|
|
99
108
|
> B のスタンドアロン CSS は自己完結のため `@source` 指定は不要ですが、ホストの Tailwind ビルドと混在させないでください (ユーティリティ層が二重定義になります)。
|
|
@@ -159,7 +168,7 @@ export function FastRangeExample() {
|
|
|
159
168
|
})
|
|
160
169
|
|
|
161
170
|
return (
|
|
162
|
-
<div className="flex items-center gap-
|
|
171
|
+
<div className="flex items-center gap-8">
|
|
163
172
|
<MonthSelector {...startSelectorProps} />
|
|
164
173
|
<PeriodSlider {...sliderProps} className="flex-1" />
|
|
165
174
|
<MonthSelector {...endSelectorProps} />
|
|
@@ -301,7 +310,7 @@ export function VernierPointExample() {
|
|
|
301
310
|
- ミクロ側の接続バー (`period-slider-connect-micro`) は描きません。幅を持たない選択を帯で表すと「満タンの期間」に見え、掴める帯まで生えてしまうためです。マクロ窓の帯は従来どおり残ります。
|
|
302
311
|
- `aria-valuemin` / `aria-valuemax` はミクロレールの両端 (マクロ窓で切り出した範囲) で、`aria-valuenow` は選択時点そのものです。期間形態のように相手のつまみで塞がれることはありません。
|
|
303
312
|
- キーボードは `mode="point"` と同じく左右対称です。`←` `→` で ±1 ミクロ単位、`PageUp` / `PageDown` で ±5、`Home` / `End` でレールの両端へ届きます。動けない押下はコールバックを発火しません。
|
|
304
|
-
- ステッパーは ±1
|
|
313
|
+
- ステッパーは ±1 ミクロ単位で、レールの端に着いた側だけが使用不可 (`aria-disabled="true"`、フォーカスは保持) になります。
|
|
305
314
|
- マクロ窓を掴んで動かすと時点も同じ暦差分だけ平行移動し、窓の端を動かして時点が窓の外に出る場合は窓の内側へ収まります。
|
|
306
315
|
- `microIsDiscrete` / `microAllowedDates` は期間形態と同じく併用でき、キーボードもステッパーも候補集合の上だけを歩きます。
|
|
307
316
|
|
|
@@ -310,13 +319,7 @@ export function VernierPointExample() {
|
|
|
310
319
|
`isVertical={true}` を指定することで、縦向き (下部が最小日付、上部が最大日付) のスライダーとして表示できます。
|
|
311
320
|
|
|
312
321
|
> [!NOTE]
|
|
313
|
-
>
|
|
314
|
-
>
|
|
315
|
-
> ```css
|
|
316
|
-
> .period-slider-track[data-orientation="vertical"] {
|
|
317
|
-
> height: 24rem;
|
|
318
|
-
> }
|
|
319
|
-
> ```
|
|
322
|
+
> ルート要素はグリッドで、トラックの長さはルート要素の高さ − 104px (ステッパーの当たり判定の予約 19px + ボタン 22px + 間隔 11px を上下で)、`showStepper={false}` では高さ − 44px (丸つまみの当たり判定のはみ出しをルートが確保する分を上下で) です。ホストが高さを与えなければトラックは 0px に潰れるため、`className` で高さを与えてください。ブロックレベルのルート要素は親の幅いっぱいに広がるため、幅は `w-fit` などで内容へ合わせます (下の例のように `flex` の子にすれば内容幅になります)。
|
|
320
323
|
|
|
321
324
|
```tsx
|
|
322
325
|
import { PeriodSlider } from "@aiquants/period-slider"
|
|
@@ -334,6 +337,7 @@ export function VerticalExample() {
|
|
|
334
337
|
mode="range"
|
|
335
338
|
unit="month"
|
|
336
339
|
isVertical={true}
|
|
340
|
+
className="h-60"
|
|
337
341
|
minDate={new Date(2024, 0, 1)}
|
|
338
342
|
maxDate={new Date(2024, 11, 31)}
|
|
339
343
|
range={range}
|
|
@@ -415,6 +419,35 @@ export function CustomLabelExample() {
|
|
|
415
419
|
}
|
|
416
420
|
```
|
|
417
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
|
+
|
|
418
451
|
### PeriodSlider Props
|
|
419
452
|
|
|
420
453
|
#### 全モード共通 Props
|
|
@@ -430,16 +463,16 @@ export function CustomLabelExample() {
|
|
|
430
463
|
| `labelPosition` | `"top" \| "bottom"` | `"top"` | 日付ラベルの表示位置 (スライダーの上側または下側) |
|
|
431
464
|
| `autoSlantLabels` | `boolean` | `true` | 近接時にラベルを斜め〜90° に自動傾斜させて重なりを防止 (Range の 1 対とノギスの 2 対へ対ごとに適用。垂直レイアウトでは適用されない) |
|
|
432
465
|
| `tooltipStyle` | `"always" \| "hover" \| "balloon"` | `"always"` | ツールチップの表示スタイル (`"always"`: 常時, `"hover"`: ポインター操作時, `"balloon"`: 吹き出し型)。`"balloon"` の宣言は `!important` 付きでユーティリティ層に勝つが、ノギスのツールチップだけは段の配色 (マクロ青 / ミクロ赤) を保ち、角丸・余白・文字サイズ・高さのみ吹き出し型になる |
|
|
433
|
-
| `isVertical` | `boolean` | `false` |
|
|
466
|
+
| `isVertical` | `boolean` | `false` | 垂直スライダー表示の有効化。**ホストが `className` で高さを与える必要があります** (トラックの長さはルート要素の高さ − 104px、`showStepper={false}` では高さ − 44px で、高さが無いと 0px に潰れて何も見えません) |
|
|
434
467
|
| `hideConnectBar` | `boolean` | `false` | 範囲選択バー (ハイライト) を非表示にし、独立 2 点選択 UI として利用 |
|
|
435
468
|
| `showTicks` | `boolean` | `false` | 離散モード時のトラック上の目盛線の表示有無 |
|
|
436
|
-
| `showStepper` | `boolean` | `true` |
|
|
469
|
+
| `showStepper` | `boolean` | `true` | ステッパーボタンの表示有無 (水平時は左右、垂直時は上下を指す矢印) |
|
|
437
470
|
| `formatLabel` | `(date: Date) => string` | `undefined` | 日付ラベル・ツールチップのカスタム表示文字列生成関数。`locale` より優先される |
|
|
438
471
|
| `locale` | `string` | `undefined` | 組み込み日付表記のロケール (BCP 47 言語タグ)。未指定はロケール非依存の ISO 8601 (`2025` / `2025-01` / `2025-01-15`)、指定時は `Intl.DateTimeFormat` 書式。空文字列・不正タグ・非文字列は `RangeError` |
|
|
439
472
|
| `disabled` | `boolean` | `false` | スライダーの無効化・非活性表示 |
|
|
440
473
|
| `debounceMs` | `number` | `0` | 変更コールバック呼び出しのデバウンス時間 (ミリ秒)。`0` は即時発火 |
|
|
441
474
|
| `colorScheme` | `PeriodSliderColorScheme` | `"blue-rose"` | カラーテーマプリセット (`"blue-rose"`, `"indigo-amber"`, `"teal-emerald"`, `"violet-fuchsia"`, `"slate-sky"`, `"monochrome"`) |
|
|
442
|
-
| `className` | `string` | `""` | 最外層コンテナ要素の追加 CSS
|
|
475
|
+
| `className` | `string` | `""` | 最外層コンテナ要素の追加 CSS クラス。ルート要素のレイアウト (`grid` / `gap` / `place-items`) はコンポーネントが持つため、寸法と余白だけを与える |
|
|
443
476
|
| `style` | `React.CSSProperties` | `undefined` | 最外層コンテナ要素のインラインスタイル。`--aqps-` カスタムプロパティを 1 台単位で注入する正式な経路 (「CSS カスタムプロパティ (スタイリング API)」を参照) |
|
|
444
477
|
|
|
445
478
|
#### Range モード専用 Props (`mode="range"`)
|
|
@@ -473,7 +506,7 @@ export function CustomLabelExample() {
|
|
|
473
506
|
| `macroUnit` | `"year" \| "month" \| "day"` | `unit` | マクロ側時間解像度単位 (異単位構成用)。`macroUnit` で `minDate` と `maxDate` が同一値に丸められる場合は `RangeError` |
|
|
474
507
|
| `microUnit` | `"year" \| "month" \| "day"` | `unit` | ミクロ側時間解像度単位 (異単位構成用) |
|
|
475
508
|
| `macroIsDiscrete` | `boolean` | `false` | マクロ側の離散スナップ有効化フラグ。`false` の間は `macroAllowedDates` が参照されない |
|
|
476
|
-
| `microIsDiscrete` | `boolean` | `false` | ミクロ側の離散スナップ有効化フラグ。`false` の間は `microAllowedDates`
|
|
509
|
+
| `microIsDiscrete` | `boolean` | `false` | ミクロ側の離散スナップ有効化フラグ。`false` の間は `microAllowedDates` が参照されない。`true` かつ現在のマクロ窓が候補を 1 つ以上含む間、ミクロレールは候補集合しか描かないため、位置・`aria-valuenow` / `aria-valuetext`・ラベル・**確定値**のすべてが最近傍候補へ解決される (ドラッグ・キーボード・ホイール・ステッパー・フックの収め込みで同一規則)。窓が候補を 1 つも含まない場合は窓内の連続値として振る舞う |
|
|
477
510
|
| `macroAllowedDates` | `Date[]` | `allowedDates` | マクロ側の離散スナップ対象日付配列。`macroIsDiscrete={true}` との併用が必須 |
|
|
478
511
|
| `microAllowedDates` | `Date[]` | `allowedDates` | ミクロ側の離散スナップ対象日付配列。`microIsDiscrete={true}` との併用が必須。候補はマクロ窓で切り出され、窓の外の日付へはキーボード・ポインターのいずれからも到達しない。窓内に候補が 1 件も残らない場合、ミクロレールは窓内の連続値として振る舞う |
|
|
479
512
|
| `formatMacroLabel` | `(date: Date) => string` | `formatLabel` | マクロ側ラベル・ツールチップのカスタム表示文字列生成関数。引数はつまみ位置・`aria-valuenow` と同一の符号値から復元した `macroUnit` 正規化済み `Date` であり、`macroRange` の生の値ではない (`macroUnit="month"` なら常に月初、`"year"` なら常に元日、`"day"` は暦日そのままで時刻が 0 時) |
|
|
@@ -514,8 +547,8 @@ export function CustomLabelExample() {
|
|
|
514
547
|
| `pointAriaLabel` | `string` | `"Selected date"` (vernier 時点形態では `"Micro selected date"`) | 単一選択つまみのアクセシブル名 (`mode="point"`、およびノギスのミクロ時点形態) |
|
|
515
548
|
| `macroLowerAriaLabel` | `string` | `"Macro range start"` | マクロ下限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
516
549
|
| `macroUpperAriaLabel` | `string` | `"Macro range end"` | マクロ上限つまみのアクセシブル名 (`mode="vernier"` のみ) |
|
|
517
|
-
| `decreaseAriaLabel` | `string` | `"Decrease"` | 値を `minDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (
|
|
518
|
-
| `increaseAriaLabel` | `string` | `"Increase"` | 値を `maxDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (
|
|
550
|
+
| `decreaseAriaLabel` | `string` | `"Decrease"` | 値を `minDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (水平時は左端の左向き矢印、垂直時は下端の下向き矢印) |
|
|
551
|
+
| `increaseAriaLabel` | `string` | `"Increase"` | 値を `maxDate` 方向へ 1 単位動かすステッパーボタンのアクセシブル名 (水平時は右端の右向き矢印、垂直時は上端の上向き矢印) |
|
|
519
552
|
| `formatAriaValueText` | `(date: Date, unit: PeriodSliderUnit) => string` | `undefined` | `aria-valuetext` の読み上げ文字列生成関数。未指定時は可視ラベルと同一の文字列 (ISO 8601、`locale` 指定時は `Intl.DateTimeFormat` 書式)。ノギスでは可視ラベルと同じく、マクロ側に `macroUnit` 正規化済み、ミクロ側に `microUnit` 正規化済みの `Date` が渡される |
|
|
520
553
|
|
|
521
554
|
ステッパーの 2 つの名称は配置ではなく値への作用で定義されています。同じボタンが水平レイアウトでは左、垂直レイアウトでは下に立つため、位置で命名すると意味が反転するからです。
|
|
@@ -538,13 +571,16 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
538
571
|
|
|
539
572
|
| フック | 対象 |
|
|
540
573
|
| :--- | :--- |
|
|
541
|
-
| `[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` (範囲領域の厚みとレール方向の伸びに使う実測値) を持つことがある。上書きの口ではないが、ホストが自分の層を避けるために**読む**ことは想定しており、名前と意味は保つ (配置の注意を参照) |
|
|
542
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 |
|
|
543
576
|
| `[data-testid="period-slider-knob"]` | `range` / `point` モードのつまみ本体 (円形ノブ)。つまみの位置・寸法の測定に用いる |
|
|
544
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` と直交する |
|
|
545
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 でスライダー全体を無効にしたときだけ付く |
|
|
546
581
|
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 (ミクロが時点の形態では `period-slider-connect-micro` を描かない) |
|
|
547
|
-
| `[data-testid="period-slider-tick"]` |
|
|
582
|
+
| `[data-testid="period-slider-tick"]` | 目盛線と離散レールの候補点。ノギスモードでは `data-tick-scale="macro" \| "micro"` が併記され上下段を判別できる。塗りはパッケージのスタイルシートが 1 か所で持つ (レールの境界線と同じインク) |
|
|
583
|
+
| `[data-testid="period-slider-hairline"]` | ノギスの読み取りの針 (`showHairline` が真のときだけ描かれる)。線の中心がつまみの中心 = 値そのものに揃う |
|
|
548
584
|
| `[data-testid="period-slider-hover-guide"]` | ポインターオーバーレイ (点と追従ラベルを束ねる器)。`range` / `point` のみで、ノギスモードでは描かれない |
|
|
549
585
|
| `[data-testid="period-slider-hover-dot"]` | オーバーレイの点 (ポインター位置そのものを示す。重複時も表示され続ける) |
|
|
550
586
|
| `[data-testid="period-slider-hover-tooltip"]` | オーバーレイの追従ラベル。指している値がつまみの確定値と一致する間は `data-duplicate="true"` が付いて `visibility: hidden` になる |
|
|
@@ -570,8 +606,10 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
570
606
|
| `PeriodSlider` (`vernier`) | 期間系の Props だけを渡し `microRange` / `defaultMicroRange` が共に未指定 | `RangeError: PeriodSlider: vernier range mode requires a micro selection; supply microRange (controlled) or defaultMicroRange (uncontrolled)` |
|
|
571
607
|
| `PeriodSlider` (`vernier`) | 指定された `microRange` / `defaultMicroRange` が 2 要素タプル以外・Invalid Date・逆転 | `RangeError: PeriodSlider: <プロパティ名> ...` |
|
|
572
608
|
| `PeriodSlider` (`vernier`) | 指定された `microValue` / `defaultMicroValue` が Invalid Date | `RangeError: PeriodSlider: <プロパティ名> must be a valid Date (received: ...)` |
|
|
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` は定義域をはみ出してよい。レールが定義域と積を取り、通知はクランプ済みの値を配るため) |
|
|
573
611
|
| `PeriodSlider` | `allowedDates` の全要素が `[minDate, maxDate]` 外 | `RangeError: getSortedAllowedDates: every allowedDates entry falls outside [minDate, maxDate] (...)` |
|
|
574
|
-
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `
|
|
612
|
+
| `usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSliderRange` / `useVernierSliderPoint` | 境界・初期値の欠落、Invalid Date、逆転 | `RangeError: <フック名>: ...` |
|
|
575
613
|
| `PeriodSlider` | `locale` が空文字列・構造として不正な BCP 47 タグ・非文字列 | `RangeError: PeriodSlider: locale must be a valid BCP 47 language tag (received: ...)` |
|
|
576
614
|
| `DateSelector` | 同上 | `RangeError: DateSelector: "locale" must be a valid BCP 47 language tag (received ...)` |
|
|
577
615
|
| `MonthSelector` / `YearSelector` | 同上 | ``RangeError: <コンポーネント名>: `locale` must be a valid BCP 47 language tag, received ....`` |
|
|
@@ -580,6 +618,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
580
618
|
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date または `Date` でない (添字付きで報告)、Date / 年 Props の不正値 | ``RangeError: MonthSelector: `allowedMonths[1]` must be a valid Date, received ....`` 等 |
|
|
581
619
|
| `DateSelector` | Date / 年 Props の不正値、解決後の範囲が空、バリアントが要求する境界の欠落、`variant="split-dropdown"` への `allowedDates` 指定 | `RangeError` |
|
|
582
620
|
|
|
621
|
+
**定義域の内包は、値が載るレールの解像度で判定します。** レールが描くのは単位まるごと (年・月・日) であるため、`minDate` が期間の途中を指す場合 (`unit="month"` に `2026-09-15`、`unit="day"` に時刻を持つ `new Date()` など) は、その期間まるごと (`2026-09-01`) がレールの先頭として描かれ、`Home` キー・ステッパー・ドラッグ・フックはいずれもその日付を確定値として配ります。したがってその日付をそのまま制御 Props (`range` / `value` / `microRange` など) へ戻しても受理されます。1 単位でも外れた日付は従来どおり `RangeError` です。
|
|
622
|
+
|
|
583
623
|
`DateSelector` は構成そのものの矛盾を優先して報告します。`variant="split-dropdown"` と `allowedDates` の併用は、`value` / `initialDate` の欠落よりも先に判定されます。
|
|
584
624
|
|
|
585
625
|
### カラーテーマ & ダークモード
|
|
@@ -696,8 +736,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
696
736
|
適用範囲の限界は次のとおりです (いずれも詳細度が高い既存規則が勝つため、意図した優先順位です)。
|
|
697
737
|
|
|
698
738
|
- **ノギスのラベルは配色 2 変数を無視します**: マクロ青・ミクロ赤というセマンティック配色 (`--aqps-macro-color` / `--aqps-micro-color`) が `--aqps-label-bg` / `--aqps-label-fg` に勝ちます。文字寸法・余白・角丸の 3 変数はノギスのラベルにも効きます。
|
|
699
|
-
- **`tooltipStyle="balloon"` は見た目 5 項目を固定します**:
|
|
700
|
-
-
|
|
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` のため、上下余白と枠線の合計が行箱を超えた分だけ高さが伸びます)。衝突回避の幾何はラベルの実測ボーダーボックスを見ているため、いずれの場合も離隔は破綻しません。
|
|
701
741
|
|
|
702
742
|
##### 丸つまみとラベルの離隔は変数になっていません
|
|
703
743
|
|
|
@@ -715,6 +755,11 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
715
755
|
|
|
716
756
|
3 つのセレクタはいずれも `value` (制御) または `initialDate` (非制御) で選択値を受け取り、両脇の ◀▶ ステッパーボタンで 1 単位ずつ移動します。
|
|
717
757
|
|
|
758
|
+
◀▶ は押せる間だけ、ポインターを載せると矢印の色が背景から際立ち (ライトでは濃く、ダークでは明るく) 淡い面が現れ、キーボードフォーカスで青いリングが付きます。押せる範囲は矢印を中心とする 44px 四方で、隣のセレクトボックスや日付入力の縁で止まります。境界に着いて動けない ◀▶ はフォーカスを保ち、タブ順にも残ったまま使用不可 (`aria-disabled="true"`) になり、押しても何も発行しません (キーボードで押し続けて境界に着いても、フォーカスが文書へ落ちません)。ネイティブの `disabled` が付くのは `disabled` Props でセレクタ全体を無効にしたときだけで、そのときは全てのバリアントで ◀▶ の両方がセレクトや日付入力と共にタブ順から外れます。
|
|
759
|
+
|
|
760
|
+
> [!NOTE]
|
|
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 にならず、これらの宣言は無害に無視されます。
|
|
762
|
+
|
|
718
763
|
```tsx
|
|
719
764
|
import { YearSelector, MonthSelector, DateSelector } from "@aiquants/period-slider"
|
|
720
765
|
import { useState } from "react"
|
|
@@ -726,7 +771,7 @@ export function SelectorsExample() {
|
|
|
726
771
|
const [currentDate, setCurrentDate] = useState<Date>(new Date(2024, 5, 15))
|
|
727
772
|
|
|
728
773
|
return (
|
|
729
|
-
<div className="flex flex-col gap-
|
|
774
|
+
<div className="flex flex-col gap-6">
|
|
730
775
|
{/* 年セレクタ (境界必須) */}
|
|
731
776
|
<YearSelector
|
|
732
777
|
value={currentDate}
|
|
@@ -769,7 +814,7 @@ export function SelectorsExample() {
|
|
|
769
814
|
| `minDate` | `Date` | `undefined` | 選択可能な最小日付 (年のみ使用)。`minYear` と併用時は厳しい方を採用 |
|
|
770
815
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付 (年のみ使用)。`maxYear` と併用時は厳しい方を採用 |
|
|
771
816
|
| `onChange` | `(date: Date, year: number) => void` | `undefined` | 年変更時コールバック。`date` は該当年の 1 月 1 日ローカル 0 時 |
|
|
772
|
-
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange`
|
|
817
|
+
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
773
818
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
774
819
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
775
820
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
@@ -779,7 +824,7 @@ export function SelectorsExample() {
|
|
|
779
824
|
| `locale` | `string` | `undefined` | 選択肢テキストのロケール (BCP 47 言語タグ)。未指定は 4 桁ゼロ埋めの年、指定時は `Intl.DateTimeFormat` 書式。空文字列・不正タグ・非文字列は `RangeError` |
|
|
780
825
|
| `unit` | `"year" \| "month" \| "day"` | `undefined` | **不活性 Props**。フックの `SelectorProps` をスプレッドするための受け口で、描画・挙動には一切影響しない |
|
|
781
826
|
|
|
782
|
-
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1 件加えてそのまま表示します。ステッパーは移動先の年が境界内にある場合だけ有効です (境界の 1
|
|
827
|
+
下限 (`minYear` または `minDate`) と上限 (`maxYear` または `maxDate`) は共に必須です。境界外の年を保持している間は、境界へ丸めず・`RangeError` も送出せず、その年を選択肢へ 1 件加えてそのまま表示します。ステッパーは移動先の年が境界内にある場合だけ有効です (境界の 1 つ外側では戻る側だけが有効、それより外では両方とも使用不可 (`aria-disabled="true"`、フォーカスは保持))。境界外の年が `onChange` へ渡ることはありません。
|
|
783
828
|
|
|
784
829
|
#### `MonthSelector` Props
|
|
785
830
|
|
|
@@ -797,7 +842,7 @@ export function SelectorsExample() {
|
|
|
797
842
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付 (月頭に切り捨て)。`maxYear` と併用時は厳しい方を採用 |
|
|
798
843
|
| `onChange` | `(date: Date, yyyymm: number) => void` | `undefined` | 選択可能な月が選ばれた時のコールバック。`date` は該当月 1 日ローカル 0 時、`yyyymm` は `年 * 100 + 月` の整数 |
|
|
799
844
|
| `isWarning` | `boolean` | `false` | 警告枠スタイル (アンバー) の適用フラグ。`variant` を問わず有効 |
|
|
800
|
-
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange`
|
|
845
|
+
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
801
846
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
802
847
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
803
848
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
@@ -812,7 +857,7 @@ export function SelectorsExample() {
|
|
|
812
857
|
- 選択可能集合は `allowedMonths` (離散) または [`minDate` / `minYear`, `maxDate` / `maxYear`] (連続) が決定します。両方を指定した場合は積 (境界内の許容月のみ) になります。
|
|
813
858
|
- `variant="dropdown"`: `allowedMonths` を指定しない場合、下限と上限の双方が必須です。`allowedMonths` を指定した場合は境界を省略でき、選択肢は許容月だけを降順に並べます (存在しない月を選択肢に挟みません)。
|
|
814
859
|
- `variant="date"`: 境界は任意です。指定した場合は `<input type="month">` の `min` / `max` 属性へ反映されます (`allowedMonths` の最古 / 最新は `min` / `max` に写しません — 宣言した境界だけが属性になります)。
|
|
815
|
-
- ステッパーは連続指定時に ±1 ヶ月、離散指定時に隣接する許容月へ移動し (四半期おきの集合なら 3 ヶ月飛ぶ)
|
|
860
|
+
- ステッパーは連続指定時に ±1 ヶ月、離散指定時に隣接する許容月へ移動し (四半期おきの集合なら 3 ヶ月飛ぶ)、集合の端では使用不可 (`aria-disabled="true"`) になります。
|
|
816
861
|
- 選択可能集合外の直接入力 (`input` / `select` の `change`) は丸められず破棄され、`onChange` は発火しません。
|
|
817
862
|
- 境界外・集合外の `value` / `initialDate` は `RangeError` になりません (集合外の表示は下記 DOM 契約の責務です)。
|
|
818
863
|
|
|
@@ -840,7 +885,7 @@ const allowedMonths = useMemo(() => baseMonths.map((yyyymm) => new Date(Math.tru
|
|
|
840
885
|
| `minDate` | `Date` | `undefined` | 選択可能な最小日付。`minYear` と併用時は厳しい方を採用 |
|
|
841
886
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付。`maxYear` と併用時は厳しい方を採用 |
|
|
842
887
|
| `onChange` | `(date: Date) => void` | `undefined` | 選択日付変更時コールバック。選択可能集合内の日付でのみ発火し、ローカル 0 時に正規化された `Date` を渡す |
|
|
843
|
-
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange`
|
|
888
|
+
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
844
889
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
845
890
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
846
891
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
@@ -862,14 +907,14 @@ const allowedMonths = useMemo(() => baseMonths.map((yyyymm) => new Date(Math.tru
|
|
|
862
907
|
- `variant="dropdown"`: `allowedDates` を指定しない場合、下限と上限の双方が必須です。境界を与えると `minDate` 〜 `maxDate` の全日が選択肢として展開されるため、広い範囲では `variant="date"` の利用を推奨します (例: 3 年間で 1,095 個の `<option>`)。
|
|
863
908
|
- `variant="split-dropdown"`: 下限と上限の双方が必須で、`allowedDates` との併用は `RangeError` になります。存在しない日付になる年・月へ切り替えた場合 (1 月 31 日を選択中に 2 月へ変更等)、月末日へ丸めず選択を破棄し、`onChange` を発火しません。選択肢のテキストは既定でゼロ埋めの数値 (`2024` / `01` / `15`) で、`locale` または `formatYearOption` / `formatMonthOption` / `formatDayOption` で変更できます。
|
|
864
909
|
- `variant="date"`: 境界は任意です。指定した場合は `<input>` の `min` / `max` 属性へ反映されます。
|
|
865
|
-
-
|
|
910
|
+
- ステッパーは離散指定時に隣接する選択可能日へ移動し、集合の端では使用不可 (`aria-disabled="true"`) になります。
|
|
866
911
|
- 選択可能集合外の日付は丸められず破棄され、`onChange` は発火しません。
|
|
867
912
|
|
|
868
913
|
DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を持ち、現在値が選択可能集合の外にある場合は `data-out-of-range="true"` が付与され、各 `<select>` の先頭に現在値を表示する選択不可のプレースホルダ `<option value="">` が描画されます (このとき `select.value === ""`)。
|
|
869
914
|
|
|
870
915
|
### React フック
|
|
871
916
|
|
|
872
|
-
4 つのフックはいずれもステート、更新関数、および `PeriodSlider` / セレクタへそのままスプレッドできる Props を返します。境界・初期値は必須で、欠落・Invalid Date・逆転はすべて `RangeError` です。ノギスは選択形態ごとに 1 つずつ用意されており、`
|
|
917
|
+
4 つのフックはいずれもステート、更新関数、および `PeriodSlider` / セレクタへそのままスプレッドできる Props を返します。境界・初期値は必須で、欠落・Invalid Date・逆転はすべて `RangeError` です。ノギスは選択形態ごとに 1 つずつ用意されており、`useVernierSliderRange` がミクロ期間、`useVernierSliderPoint` がミクロ時点を受け持ちます。
|
|
873
918
|
|
|
874
919
|
`setRange` / `setValue` / `setMacroRange` / `setMicroRange` / `setMicroValue` はステートを置き換えるだけでコールバックを発火しません。それ以外の更新関数 (`setLowerDate`, `shiftRange`, `resetRange`, `setMicroUpperDate`, `setMicroDate`, `shiftMacroRange`, `shiftMicroValue`, `resetVernier` 等) は対応する `onChange*` を発火します。
|
|
875
920
|
|
|
@@ -932,7 +977,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
932
977
|
| `selectorProps` | `SelectorProps` | セレクタ用 Props |
|
|
933
978
|
| `sliderProps` | `PeriodSliderPointProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
934
979
|
|
|
935
|
-
#### `
|
|
980
|
+
#### `useVernierSliderRange(options)`
|
|
936
981
|
|
|
937
982
|
| オプション | 型 | 既定値 | 説明 |
|
|
938
983
|
| :--- | :--- | :--- | :--- |
|
|
@@ -940,7 +985,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
940
985
|
| `minDate` | `Date` | (必須) | 全期間マクロの下限日付 |
|
|
941
986
|
| `maxDate` | `Date` | (必須) | 全期間マクロの上限日付 (`minDate` より厳密に後) |
|
|
942
987
|
| `initialMacroRange` | `[Date, Date]` | (必須) | 初期マクロ表示窓 [開始, 終了] |
|
|
943
|
-
| `initialMicroRange` | `[Date, Date]` | (必須) | 初期ミクロ選択期間 [開始, 終了] |
|
|
988
|
+
| `initialMicroRange` | `[Date, Date]` | (必須) | 初期ミクロ選択期間 [開始, 終了] (初期マクロ窓と `[minDate, maxDate]` の交差の内側) |
|
|
944
989
|
| `macroUnit` | `PeriodSliderUnit` | `unit` | マクロ側時間解像度単位 |
|
|
945
990
|
| `microUnit` | `PeriodSliderUnit` | `unit` | ミクロ側時間解像度単位 |
|
|
946
991
|
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | `undefined` | マクロ窓変更時コールバック |
|
|
@@ -957,8 +1002,8 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
957
1002
|
| `setMacroUpperDate` | `(date: Date) => void` | マクロ終了日更新関数。`maxDate` より後は `maxDate` へ収め、マクロ下限を下回った場合は下限も追従 |
|
|
958
1003
|
| `setMicroLowerDate` | `(date: Date) => void` | ミクロ開始日更新関数。マクロ窓の下限より前は窓下限へ収め、ミクロ上限を超えた場合は上限も追従 |
|
|
959
1004
|
| `setMicroUpperDate` | `(date: Date) => void` | ミクロ終了日更新関数。マクロ窓の上限より後は窓上限へ収め、ミクロ下限を下回った場合は下限も追従 |
|
|
960
|
-
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない) |
|
|
961
|
-
| `shiftMicroRange` | `(delta: number) => void` | ミクロ選択期間を `delta`
|
|
1005
|
+
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない)。`macroIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`macroAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、候補集合を外れるシフトも同じく全体中止 |
|
|
1006
|
+
| `shiftMicroRange` | `(delta: number) => void` | ミクロ選択期間を `delta` ミクロ単位シフト。実効マクロ窓 (マクロ窓と `[minDate, maxDate]` の交差) からはみ出すシフトは全体を中止する (クランプしない)。`microIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`microAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、候補集合を外れるシフトも同じく全体中止。現在のマクロ窓に候補が 1 つも無い場合は連続として扱う |
|
|
962
1007
|
| `resetVernier` | `() => void` | マクロ・ミクロ双方を初期値へ復帰 |
|
|
963
1008
|
| `macroStartSelectorProps` | `SelectorProps` | マクロ開始日セレクタ用 Props |
|
|
964
1009
|
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
|
@@ -968,7 +1013,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
968
1013
|
|
|
969
1014
|
#### `useVernierSliderPoint(options)`
|
|
970
1015
|
|
|
971
|
-
マクロ窓はそのままに、ミクロレールが単一の時点を指すノギス用フックです。オプションと返却値は `
|
|
1016
|
+
マクロ窓はそのままに、ミクロレールが単一の時点を指すノギス用フックです。オプションと返却値は `useVernierSliderRange` と対になっており、ミクロ側だけがタプルからスカラーへ置き換わります。
|
|
972
1017
|
|
|
973
1018
|
| オプション | 型 | 既定値 | 説明 |
|
|
974
1019
|
| :--- | :--- | :--- | :--- |
|
|
@@ -976,7 +1021,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
976
1021
|
| `minDate` | `Date` | (必須) | 全期間マクロの下限日付 |
|
|
977
1022
|
| `maxDate` | `Date` | (必須) | 全期間マクロの上限日付 (`minDate` より厳密に後) |
|
|
978
1023
|
| `initialMacroRange` | `[Date, Date]` | (必須) | 初期マクロ表示窓 [開始, 終了] |
|
|
979
|
-
| `initialMicroValue` | `Date` | (必須) | 初期ミクロ選択時点 (
|
|
1024
|
+
| `initialMicroValue` | `Date` | (必須) | 初期ミクロ選択時点 (初期マクロ窓と `[minDate, maxDate]` の交差の内側) |
|
|
980
1025
|
| `macroUnit` | `PeriodSliderUnit` | `unit` | マクロ側時間解像度単位 |
|
|
981
1026
|
| `microUnit` | `PeriodSliderUnit` | `unit` | ミクロ側時間解像度単位 |
|
|
982
1027
|
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | `undefined` | マクロ窓変更時コールバック |
|
|
@@ -992,8 +1037,8 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
992
1037
|
| `setMacroLowerDate` | `(date: Date) => void` | マクロ開始日更新関数。`minDate` より前は `minDate` へ収め、マクロ上限を超えた場合は上限も追従 |
|
|
993
1038
|
| `setMacroUpperDate` | `(date: Date) => void` | マクロ終了日更新関数。`maxDate` より後は `maxDate` へ収め、マクロ下限を下回った場合は下限も追従 |
|
|
994
1039
|
| `setMicroDate` | `(date: Date) => void` | ミクロ時点更新関数。マクロ窓の外はマクロ窓の境界へ収める |
|
|
995
|
-
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない) |
|
|
996
|
-
| `shiftMicroValue` | `(delta: number) => void` | ミクロ時点を `delta`
|
|
1040
|
+
| `shiftMacroRange` | `(delta: number) => void` | マクロ窓を `delta` マクロ単位シフト。窓幅を保つため、片側でも `[minDate, maxDate]` を越えるシフトは全体を中止する (クランプしない)。`macroIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`macroAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、候補集合を外れるシフトも同じく全体中止 |
|
|
1041
|
+
| `shiftMicroValue` | `(delta: number) => void` | ミクロ時点を `delta` ミクロ単位シフトし、実効マクロ窓 (マクロ窓と `[minDate, maxDate]` の交差) へクランプする。時点には保つべき幅が無いため、`shiftMicroRange` と違い端で中止せず端へ着ける。`microIsDiscrete={true}` のときはスライダー本体と同じ候補集合 (`microAllowedDates`、未指定なら `allowedDates`) の上を `delta` 個分歩き、現在のマクロ窓に候補が 1 つも無い場合は連続スライダーと同じ 1 単位シフトへ退化する (送出しない) |
|
|
997
1042
|
| `resetVernier` | `() => void` | マクロ窓・ミクロ時点の双方を初期値へ復帰 |
|
|
998
1043
|
| `macroStartSelectorProps` | `SelectorProps` | マクロ開始日セレクタ用 Props |
|
|
999
1044
|
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
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"}
|