@aiquants/period-slider 0.20.1 → 0.22.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 +84 -0
- package/README.md +24 -10
- package/dist/DateSelector.d.ts +12 -1
- package/dist/DateSelector.d.ts.map +1 -1
- package/dist/MonthSelector.d.ts +11 -0
- package/dist/MonthSelector.d.ts.map +1 -1
- package/dist/PeriodSlider.d.ts +40 -4
- package/dist/PeriodSlider.d.ts.map +1 -1
- package/dist/StepperButton.d.ts +27 -2
- package/dist/StepperButton.d.ts.map +1 -1
- package/dist/VirtualDateDropdown.d.ts +2 -2
- package/dist/YearSelector.d.ts +11 -0
- package/dist/YearSelector.d.ts.map +1 -1
- package/dist/dragPresentation.d.ts +11 -3
- package/dist/dragPresentation.d.ts.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +2 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2701 -2495
- package/dist/labelRoom.d.ts +101 -0
- package/dist/labelRoom.d.ts.map +1 -0
- package/dist/labels.d.ts +17 -15
- package/dist/labels.d.ts.map +1 -1
- package/dist/styles/period-slider.css +1 -1
- package/dist/styles/period-slider.standalone.css +1 -1
- package/package.json +10 -8
- package/src/DateSelector.tsx +20 -8
- package/src/MonthSelector.tsx +20 -6
- package/src/PeriodSlider.tsx +629 -46
- package/src/StepperButton.tsx +114 -17
- package/src/VirtualDateDropdown.tsx +3 -3
- package/src/YearSelector.tsx +19 -7
- package/src/dragPresentation.ts +11 -3
- package/src/index.ts +2 -0
- package/src/labelRoom.ts +236 -0
- package/src/labels.ts +26 -22
- package/src/styles/period-slider.css +82 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,90 @@ All notable changes to `@aiquants/period-slider` are documented here.
|
|
|
4
4
|
見出しは版番号です。次の公開に入る変更は、その版番号と作成日の見出し (`## 0.14.0 (2026-09-24)` の形) の下へ書きます。
|
|
5
5
|
本書は 0.10.0 で起こしたため、0.7.0 以前の項はありません (0.8.0 と 0.9.0 は公開済みの差分から起こした要約です)。
|
|
6
6
|
|
|
7
|
+
## 0.22.0 (2026-11-03)
|
|
8
|
+
|
|
9
|
+
横向きのスライダーで近づいた対のラベルを傾けたとき、傾けたラベルがレールの周りの余白に収まらなければ、レールの反対側へ倒すようにしました。
|
|
10
|
+
あわせて、余白の境をホストが名指す `labelCeiling` / `labelFloor`、倒れたラベルとつまみを結ぶ `showLabelLeaderLines`、3 セレクタの ◀▶ を三角形 2 つの絵で描く `stepGlyph` を足しました。
|
|
11
|
+
**追加のマイナー版です。** 既存の Props と関数の引数は変わりません (`calculateLabelSlant` の結果の `LabelSlantResult` に `isFlipped` が加わります)。
|
|
12
|
+
ラベルが余白からはみ出していた置き方では、下の「修正」の点で描かれ方が変わります。
|
|
13
|
+
|
|
14
|
+
### 追加
|
|
15
|
+
|
|
16
|
+
- **`PeriodSlider` の `labelCeiling` / `labelFloor` (`Element | null`)**: 傾けたラベルを、`labelCeiling` の要素の下端より上へ、`labelFloor` の要素の上端より下へ描きません。
|
|
17
|
+
画面の端とラベルを切る祖先に加える境で、スライダーの上にツールバーなどの操作の行がある場合に渡します。要素そのもの (`ref.current`、または ref のコールバックで状態へ受けた要素) を渡し、
|
|
18
|
+
文書に繋がっていない要素は何も区切りません。要素・`null`・`undefined` 以外 (ref オブジェクト・セレクタ文字列など) は描画時の `RangeError` です。
|
|
19
|
+
- **`PeriodSlider` の `showLabelLeaderLines` (`boolean`、既定 `false`)**: レールの反対側へ倒れたラベルへ、つまみの中心から細い引き出し線を引きます。
|
|
20
|
+
線は各ツールチップの直後の兄弟の `span[data-label-leader="true"]` (`aria-hidden="true"`) で、ラベルが自分の側に立つ間は長さ 0 で何も描きません。
|
|
21
|
+
色はラベルの地と同じで (ノギスはマクロとミクロの色)、強制カラーでは `CanvasText` で描きます。
|
|
22
|
+
- **倒れた対のツールチップ 2 枚は `data-flipped="true"` を持ちます** (横向きの Range とノギスの対だけ)。
|
|
23
|
+
- **`calculateLabelSlant` の設定に `room`・`drawnScale`・`flipClearancePx` を、結果に `isFlipped` を足し、型 `LabelRoom` を書き出しました。**
|
|
24
|
+
`room` はレール中心線から上下の余白 (`topPx` / `bottomPx`、無制限は `Infinity`)、`drawnScale` は強調中にラベルを描く倍率、`flipClearancePx` は反対側に立つときの内縁の離隔です。
|
|
25
|
+
`room` を渡さなければ今までと同じ配置です。不正な値は無制限や等倍へ読み替えず `RangeError` です。
|
|
26
|
+
- **`YearSelector` / `MonthSelector` / `DateSelector` の `stepGlyph` (`StepGlyph`: `"single" | "double"`、既定 `"single"`)**: `"double"` で ◀▶ の矢印を三角形 2 つを重ねた絵 (`<<` / `>>`) で描きます。
|
|
27
|
+
`stepper` で窓や期間ごとに大きく送るボタンを、1 日・1 か月ずつ送るボタンと見分ける用途です。
|
|
28
|
+
描く絵だけが変わり、箱の大きさ・押せる範囲・ホバー・フォーカス・使用不可 (`aria-disabled`) の見た目とアクセシブル名 (`labels`) は既定の絵と同じです。
|
|
29
|
+
絵は `aria-hidden` のままで、矢印の `svg` は `data-glyph="single" | "double"` を持ちます (スライダーのステッパーは常に `single`)。`"single"` / `"double"` 以外 (`null`・`""`・大文字違いを含む) は描画時の `RangeError` です。
|
|
30
|
+
|
|
31
|
+
### 修正
|
|
32
|
+
|
|
33
|
+
- **近づいた対のラベルが、傾けたせいで画面や切る箱の上端 (`labelPosition="bottom"` では下端) を越えて描かれなくなりました。**
|
|
34
|
+
傾けたラベルは直立のものよりレールから遠くまで届くため、0.21.0 までは、画面の上端の近くや `overflow: hidden` の低い箱の中に置いたスライダーで、近づいた 2 枚が縦に近く立ち上がって見切れていました。
|
|
35
|
+
横向きのスライダーは、ラベルを描いてよい余白 (画面の端・`overflow` や `contain` でラベルを切る祖先・`labelCeiling` / `labelFloor` のうち最も近いもの) を測り、
|
|
36
|
+
傾けた対が自分の側に収まればこれまでどおり描き、収まらなければ同じ角度でレールの反対側へ倒します。どちらにも収まらなければ余白の広い側に立ち、その余白に収まる角度まで下げます (縦までは立てません)。
|
|
37
|
+
強調中 (掴んでいる間) の 1.15 倍の大きさも余白に数え、ノギスで倒れた対は、もう一方のレールのラベルの外へ積みます。
|
|
38
|
+
余白は、対が傾いている間は描くたびに、傾いた対がある間と掴んでいる間はスクロール・画面の大きさの変化・`labelCeiling` / `labelFloor` の要素の大きさの変化のたびに (1 フレームに 1 度)、
|
|
39
|
+
そして掴んだ瞬間に測り直します。縦向きのスライダーと `tooltipStyle="hover"` のラベルは測らず、これまでどおりに描きます。
|
|
40
|
+
|
|
41
|
+
### 移行
|
|
42
|
+
|
|
43
|
+
- 余白が足りない置き方 (画面の上端の近く・低い切る箱の中) でラベルの位置や角度を測っていたテストは、倒れた配置 (`data-flipped="true"`、回転の向きと縦の移動が反対) を期待してください。
|
|
44
|
+
- スライダーの上にツールバーなどの操作の行を置くホストは、その行の要素を `labelCeiling` に渡すと、傾けたラベルがその行に重なりません。
|
|
45
|
+
|
|
46
|
+
### 文書
|
|
47
|
+
|
|
48
|
+
- README に、余白への収め方、`labelCeiling` / `labelFloor` / `showLabelLeaderLines` / `stepGlyph`、`data-flipped`・引き出し線・`data-glyph` の DOM の契約、新しい送出条件を書き足しました。
|
|
49
|
+
|
|
50
|
+
## 0.21.0 (2026-10-30)
|
|
51
|
+
|
|
52
|
+
つまみとラベルの飾りの層が、文書のスクロールの範囲を広げなくなりました。`@aiquants/virtualscroll` の下限を 3.22.1 へ上げるため、
|
|
53
|
+
**0.x の破壊的変更を含むマイナー版です** (下の「移行」を参照。本パッケージの Props と公開 API の宣言は変わりません)。
|
|
54
|
+
|
|
55
|
+
### 変更 (破壊的)
|
|
56
|
+
|
|
57
|
+
- **`@aiquants/virtualscroll` は 3.22.1 以上が必要です** (`^3.8.0` から `^3.22.1`)。公開時の peer 範囲は `^3.22.1` へ展開されます。
|
|
58
|
+
本パッケージが使うのは `DateSelector variant="dropdown"` のポップアップの `VirtualScroll` とラベルの表だけで、3.22.1 で単体テストと E2E を通しています。
|
|
59
|
+
3.8.0 から上げると、ポップアップの中では次が変わります (そのほかは virtualscroll の CHANGELOG を参照)。
|
|
60
|
+
- **スクロールバーは、名前と値を持つ `role="scrollbar"` の溝 1 つと、その外に並ぶ矢印のボタン 2 つになります** (virtualscroll 3.20.0)。
|
|
61
|
+
つまみは描くだけの要素で、`role="slider"` を持ちません。溝の名前はエンジンキー `verticalScrollBar` (`Vertical` / `縦方向`) です。
|
|
62
|
+
- **ラベルの語彙は 31 キー (エンジン 9 + 固有 22) になります**。`PeriodSliderLabels`・`PeriodSliderLabelOverrides`・`PERIOD_SLIDER_LABEL_KEYS` のエンジンの部分は、
|
|
63
|
+
インストールされた virtualscroll の `VIRTUAL_SCROLL_LABEL_KEYS` から導くため、3.8.0 の 7 キーに `verticalScrollBar` と `horizontalScrollBar` が加わります
|
|
64
|
+
(3.10.0 で加わったつまみの名前の 2 キー `verticalScrollThumb` / `horizontalScrollThumb` は、3.20.0 で外れました)。
|
|
65
|
+
- **使えない矢印のボタンの字は、バーの幅から作る SVG の三角形になります** (3.14.0。これまでは文字の `▲` / `▼`)。
|
|
66
|
+
|
|
67
|
+
### 修正
|
|
68
|
+
|
|
69
|
+
- **つまみとラベルが掴んだ瞬間に光らせる飾りの層 (`::before` / `::after`) が、祖先と文書のスクロールの範囲に数えられなくなりました。**
|
|
70
|
+
層は見えない間 (`opacity: 0`) も箱を持ち、`::after` は載り先の 2 倍の大きさで四方へ半分ずつはみ出し、掴んでいる間はキーフレームの終わり (斜めに 120% 先、`::before` は 3.2 倍) に留まります。
|
|
71
|
+
0.20.1 までは、ラベルが画面の右端や下端の近くにあると見えない層の分だけ文書が横や縦へ送れ、横のホイールやタッチパッドの操作で画面全体がずれました
|
|
72
|
+
(ラベルを文書の右端に接させると静止時に 30px、掴んでいる間は約 200px。縦向きの下のつまみは掴んでいる間に約 100px)。
|
|
73
|
+
配布スタイルシートは `.period-slider-knob` と `.period-slider-tooltip` へ `contain: layout` を宣言し、層のはみ出しを描画だけのはみ出しにします。描画は切らないため、光の見た目は変わりません。
|
|
74
|
+
この送りを防ぐためにスライダーの祖先へ `overflow-x: clip` などを指定していたホストは、ほかに切る理由が無ければ指定を外せます。
|
|
75
|
+
掴んでいる間に 1.15 倍で描かれるラベルは描かれた内容なので、スクロールの範囲に数えられます (ラベルを文書の端に接させると、掴んでいる間だけラベルの大きさの 7.5%、幅 65px のラベルで約 5px)。
|
|
76
|
+
|
|
77
|
+
### 移行
|
|
78
|
+
|
|
79
|
+
- `@aiquants/virtualscroll` を 3.22.1 以上へ上げてください (`pnpm add @aiquants/virtualscroll@^3.22.1`)。`VirtualScroll` を自分でも使うホストは、virtualscroll の CHANGELOG の 3.8.1〜3.22.1 も読んでください。
|
|
80
|
+
- `PeriodSliderLabels` を全キーそろえて組み立てるホスト (独自の言語のカタログなど) は、`verticalScrollBar` と `horizontalScrollBar` を足してください。
|
|
81
|
+
`labels` へ `verticalScrollThumb` / `horizontalScrollThumb` を渡していたホスト (virtualscroll 3.10.0〜3.19.x で動かしていた場合) は外してください。未知のキーは描画時の `RangeError` です。
|
|
82
|
+
- 日付のドロップダウンのポップアップのスクロールバーを `[role="slider"]` / `getByRole("slider")` で引いていたテストは、値と名前を `[role="scrollbar"]` / `getByRole("scrollbar")` から読んでください。
|
|
83
|
+
矢印のボタンは `role="scrollbar"` の要素の兄弟で、`closest('[role="scrollbar"]')` では辿れません。ページの `getByRole("slider")` は、ポップアップを開いている間もスライダーのつまみだけに当たります。
|
|
84
|
+
|
|
85
|
+
### 文書
|
|
86
|
+
|
|
87
|
+
- README の「配置の注意」に、文書のスクロールの範囲に数えられるもの (ルート要素の箱、ラベル、交差軸へ伸びる当たり判定と範囲領域のレーン、掴んでいる間のラベルの拡大) を書き足しました。
|
|
88
|
+
- README は、ポップアップのスクロールバーを virtualscroll 3.20.0 以後の形 (名前と値を持つ `role="scrollbar"` の溝 1 つ・その外の矢印のボタン 2 つ・見た目だけのつまみ) で述べ、
|
|
89
|
+
溝の名前のキー (`verticalScrollBar`) を、`locale` と `labels` が決める名前の一覧に加えました。
|
|
90
|
+
|
|
7
91
|
## 0.20.1 (2026-10-03)
|
|
8
92
|
|
|
9
93
|
4 つのフックの `duringRender(action)` は、`action` が何も記録しない描画に印を付けなくなり、そうした描画では React がホストの子の描画を省くようにしました (Props と公開 API は変わりません)。
|
package/README.md
CHANGED
|
@@ -37,6 +37,7 @@
|
|
|
37
37
|
- `autoSlantLabels`: 2 つのラベルが近接した際に Smootherstep 補間により 0° 〜 90° に滑らかに自動傾斜し、テキストの重なりを数学的に完全防止。回転時もラベル下端がトラック中心から常に 10px (つまみ上端から 2px) の統一された高さを維持。角度は 2 つの値が一致する位置まで連続で、その位置で 90° に達します。
|
|
38
38
|
- 傾斜は Range の 1 対と、ノギスのマクロ対・ミクロ対の計 3 組へ**対ごとに独立して**適用されます (対ごとに比率も単位もラベル幅も違うため、計算を共有しません)。マクロ対とミクロ対で角度が異なるのは正常です。
|
|
39
39
|
- 垂直レイアウト (`isVertical={true}`、垂直ノギスを含む) では傾斜しません。傾斜幾何が X 軸方向にしか分離しないためで、垂直向けの衝突回避は未整備の保留領域です。
|
|
40
|
+
- **余白が足りないときはレールの反対側へ倒します**: 傾けたラベルは直立のものよりレールから遠くまで届きます。横向きのスライダーは、ラベルを描いてよい余白 (画面の端・`overflow` などでラベルを切る祖先・`labelCeiling` / `labelFloor` で名指す要素のうち最も近いもの) を測り、傾けた対が自分の側に収まらないときだけ、同じ角度のまま反対側に立てます。どちらにも収まらなければ余白の広い側に、収まる最大の角度で立てます (縦まで立てて欠けることはありません)。余白のあるページの配置は変わりません。ラベルの地は不透明で、倒れたラベルは下にあるレールの線を覆います (ノギスの上段のラベルが下段のレールに重なるのは仕様です)。`showLabelLeaderLines` を渡すと、つまみから倒れたラベルへ細い引き出し線を引きます。
|
|
40
41
|
- 衝突判定はラベルの実測幅 (`ResizeObserver` が返すボーダーボックス幅) のみを用います。単位や書式から推定した定数を使わないため、`formatLocale`・`formatLabel`・ホストのフォントを変えても判定はずれません。実測値が得られるまでラベルは傾斜せず直立します。
|
|
41
42
|
- 2 つのつまみが同じ値に重なったときは、同一文字列のラベルを 2 枚並べず 1 枚へ畳みます。冗長な側のラベルには `data-duplicate="true"` が付いて `visibility: hidden` になり (要素は残るため実測は継続)、残った 1 枚は 90° に傾いたままつまみの中心に立ちます (畳んでも角度は変えず、離す相手が居なくなった水平方向の押し退けだけを 0 にします)。畳まれたかどうかは傾斜の可否を動かしません。値が一致していても、上記のとおり実測が揃うまで・`autoSlantLabels={false}`・垂直レイアウトでは直立のままです。同じ機構がノギスのマクロ対・ミクロ対にも適用され (判定は各対の符号化値の厳密一致)、可視ラベルは掴んだ・打鍵した・`Tab` で到達したつまみへ追従します。
|
|
42
43
|
- トラック上をホバーしたときに出る追従ラベル (ポインターオーバーレイ) も、指している値がつまみの確定値と一致する間は同じ機構で隠します。つまみのラベルと一字一句同じ文字列が 4px ずれて二重に描かれるのを防ぐためで、判定はラベル併合と同じ符号化値の厳密一致です。ポインター位置そのものを示す点とガイドは表示したままです。
|
|
@@ -50,6 +51,7 @@
|
|
|
50
51
|
- `MonthSelector`: カレンダー入力 (`variant="date"`, 既定) / ドロップダウン (`variant="dropdown"`) 対応の月セレクタ。連続した境界のほか、実データに存在する月だけを選ばせる離散集合 (`allowedMonths`) に対応。
|
|
51
52
|
- `DateSelector`: 日付入力 (`variant="date"`, 既定)、日付範囲全体を仮想化したコンボボックス (`variant="dropdown"`、100 年分の日でも定数費用)、年月日の 3 分割セレクト (`variant="split-dropdown"`) に対応。離散集合 (`allowedDates`) にも対応。
|
|
52
53
|
- 3 セレクタの ◀▶ とスライダーのステッパーは同じ部品を共有し、押せる間だけホバーで強調され、44px の当たり判定とキーボードフォーカスのリングを持ちます。境界に着いたボタンはフォーカスを保ち、タブ順にも残ったまま使用不可 (`aria-disabled="true"`) になります。どのボタンも `type="button"` のため、ホストの `<form>` の中に置いても押下でフォームを送信しません。
|
|
54
|
+
- **◀▶ は 2 つ重ねた絵でも描けます (`stepGlyph`)**: `stepGlyph="double"` で矢印を三角形 2 つの絵 (`<<` / `>>`) にでき、窓や期間ごとに大きく送る所有者 (`stepper`) のボタンを 1 日・1 か月ずつ送るボタンと見分けられます。箱・押せる範囲・ホバー・フォーカス・使用不可の見た目は既定の 1 つの絵 (`"single"`) と同じで、絵は `aria-hidden` のまま、名前 (`labels`) とは別に選びます。
|
|
53
55
|
- **◀▶ を所有者へ引き渡せます (`stepper`)**: セレクタが示す値は期間の片端やノギスの窓の片端であることが多く、セレクタ自身の ◀▶ はその 1 つの値しか動かせません。`stepper` を渡すと ◀▶ の押下は向き付きで所有者へ届き (`onChange` は呼ばれません)、押せるかどうかも所有者が決めます。押下が期間・窓をどう動かすか (期間ごと・片端だけ・1 点へ、データの端で止めるか縮めるか、窓を据え置くか追従させるか) は 1 か所の規則 (`resolveSelectorSteps` / `resolveVernierSelectorSteps`) が決め、フックは `selectorStep` / `macroSelectorStep` / `microSelectorStep` を渡すだけでそれを配線します。
|
|
54
56
|
- **カラーテーマ・メリハリ対比 & ダークモード**:
|
|
55
57
|
- `colorScheme`: 6 系統のカラーパレット (`"blue-rose"` [既定], `"indigo-amber"`, `"teal-emerald"`, `"violet-fuchsia"`, `"slate-sky"`, `"monochrome"`) をサポート。
|
|
@@ -128,7 +130,7 @@ peer dependency の `@aiquants/virtualscroll` のスタイルシートは、本
|
|
|
128
130
|
|
|
129
131
|
- **`locale` と `formatLocale` は別の軸です**。`locale` は部品の名前の言語 (閉じた `"en"` / `"ja"`)、`formatLocale` は日付テキストの書式 (任意の BCP 47 タグ) です。`formatLocale="ja-JP"` を渡しても名前は英語のまま、`locale="ja"` を渡しても日付は ISO 8601 のままです。**言語ネゴシエーションは行いません**: `navigator.language` などからの対応付けはホストの責務です。
|
|
130
132
|
- **日付の書式を `locale` へ渡さないでください**。`"ja-JP"` のようなタグは `RangeError` で止まりますが、`"ja"` / `"en"` は日付書式の BCP 47 タグとしても正当である一方、`locale` の受理値そのものでもあるため拒否されません。その場合、日付テキストは ISO 8601 のまま (`2024-01`) で、`"ja"` では部品の名前だけが切り替わり (`Previous month` → `前月`)、アクセシブル名や Intl 書式の日付を照合するテストは原因を示さずに失敗します。日付の書式は常に `formatLocale` へ渡し、部品の名前を日本語にしたいときだけ `locale="ja"` を加えます。フックのオプションと `SelectorProps` も同じです。
|
|
131
|
-
- `PeriodSliderLocale` は `@aiquants/virtualscroll` の `VirtualScrollLocale`
|
|
133
|
+
- `PeriodSliderLocale` は `@aiquants/virtualscroll` の `VirtualScrollLocale` そのものです。エンジンのキー (`VIRTUAL_SCROLL_LABEL_KEYS` の全件) は `VIRTUAL_SCROLL_LABEL_CATALOGS` の値をそのまま再利用し、本パッケージでは書き直しません。
|
|
132
134
|
|
|
133
135
|
```tsx
|
|
134
136
|
// 名前は日本語、日付は ja-JP の Intl 書式 (2 つの軸を両方指定)
|
|
@@ -142,7 +144,7 @@ const labels = { rangeStart: "調査開始月", rangeEnd: "調査完了月", pre
|
|
|
142
144
|
|
|
143
145
|
#### カタログ (`PERIOD_SLIDER_LABEL_CATALOGS`)
|
|
144
146
|
|
|
145
|
-
|
|
147
|
+
`@aiquants/virtualscroll` のエンジンキー (`VIRTUAL_SCROLL_LABEL_KEYS`) の全件と固有 22 キーです。`PERIOD_SLIDER_LABEL_KEYS` はエンジンキーをエンジンの順に並べ、その後に固有 22 キーを表の順で続けた閉じたキー集合です。表のエンジンキーは対応するどのエンジン版にもあるキーで、インストールされたエンジンの `VIRTUAL_SCROLL_LABEL_KEYS` がそれ以外のキーを持てば、そのキーも同じく上書きでき、検証はエンジン自身が行い、`DateSelector variant="dropdown"` の内蔵 VirtualScroll へ転送されます。
|
|
146
148
|
|
|
147
149
|
| キー | 読む部品 / 面 | `en` | `ja` |
|
|
148
150
|
| :--- | :--- | :--- | :--- |
|
|
@@ -186,7 +188,7 @@ const labels = { rangeStart: "調査開始月", rangeEnd: "調査完了月", pre
|
|
|
186
188
|
- `overrides` が `undefined` ならカタログそのもの (同一参照) を返します。
|
|
187
189
|
- それ以外は素のオブジェクト (プロトタイプが `Object.prototype` か `null`) だけを受け付け、**自身のプロパティだけ**を読みます。配列・クラスインスタンス・他オブジェクト継承・`null`・非オブジェクトは `RangeError` です。
|
|
188
190
|
- 未知キーは `RangeError` です (`lowerAriaLabel` のような `*AriaLabel` の名前も、`labels` のキーではないため未知キーです)。値が `undefined` のキーはカタログ値のままです。
|
|
189
|
-
- 与えた値は空白以外の文字を含む文字列でなければ `RangeError`
|
|
191
|
+
- 与えた値は空白以外の文字を含む文字列でなければ `RangeError` です。エンジンキーの検証は `resolveVirtualScrollLabels` 自身が行います。メッセージ中の拒否値は例外を投げない記述 (文字列は JSON、`null` は `null`、それ以外は `typeof`) で示されます。
|
|
190
192
|
- 結果は凍結された新しいオブジェクトです。入力は変更しません。
|
|
191
193
|
|
|
192
194
|
部品は解決結果を値で安定化します。`labels={{ ... }}` をインラインで書いても、文字列が同じ間はメモ比較器が再描画を起こさず、内蔵 VirtualScroll へ渡すエンジンラベルの同一性も保たれます。
|
|
@@ -272,7 +274,7 @@ type PeriodOptionFormatter = (date: Date, unit: PeriodSliderUnit, scope: PeriodO
|
|
|
272
274
|
|
|
273
275
|
**フォーマッタが届かない先** (いずれも別の関数が別の経路で作ります):
|
|
274
276
|
|
|
275
|
-
- すべての `aria-label` (◀▶・セレクト・コンボボックス・ポップアップの `listbox
|
|
277
|
+
- すべての `aria-label` (◀▶・セレクト・コンボボックス・ポップアップの `listbox`、ポップアップのスクロールバーの溝と矢印ボタン 2 つ)。これらは UI クローム言語の `locale` と `labels` が決めます ([Localization](#localization-ui-クローム言語-locale-と-labels))。溝の名前 (`verticalScrollBar`) と矢印ボタンの名前 (`scrollUp` / `scrollDown`) は内蔵の `@aiquants/virtualscroll` へ転送されます。どちらもタブ順には入らず (矢印ボタンは常に `disabled`)、支援技術がポップアップ内を辿ったときに現れます。
|
|
276
278
|
- すべての機械可読値: `<option value>`、`variant="dropdown"` の `data-value`、`<input type="date">` / `<input type="month">` の `value` / `min` / `max`。
|
|
277
279
|
- `onChange` が渡す引数。表示を変えても発行される `Date` は 1 ミリ秒も動きません。
|
|
278
280
|
|
|
@@ -790,11 +792,11 @@ export function FiscalQuarterLabelExample() {
|
|
|
790
792
|
- **押すだけで動きます**: トラックを押して指を動かさずに離すと、最寄りの対象がその位置へ寄ります (ノギスのマクロ窓・ミクロ選択も同じ)。ドラッグを要しない単一ポインターの経路です (WCAG 2.2 SC 2.5.7)。
|
|
791
793
|
- **使用不可の ◀▶ / ステッパーは押下をホストへ通しません**: 境界に着いたボタンは `aria-disabled="true"` でフォーカスを保ったまま、押下を捕捉フェーズで飲み込みます (`preventDefault` + `stopPropagation`)。`mousedown` / `mouseup` / `click` は React のルートコンテナより下のもの (ボタン自身と、その間にあるホストの要素) へ 1 つも届かず、押下がフォーカスを奪うこともありません。クリック可能なカード・イベント委譲・外側押下による閉じ処理・クリック計測の中へ置いても、淡く塗られた矢印からホストのハンドラが発火することはありません。ネイティブの `disabled` と同じく `pointerdown` / `pointerup` は配送されます。
|
|
792
794
|
|
|
793
|
-
### 配置の注意 (
|
|
795
|
+
### 配置の注意 (範囲領域・当たり判定・スクロールの範囲)
|
|
794
796
|
|
|
795
797
|
- **範囲領域はホストの押下を奪いません**: `Shift` + ホイールを受ける範囲領域 (ルート要素の箱に加えて、レールの上下のレーンと描かれたラベルの帯。レール方向にもラベルの外縁まで届きます) は何も描かず、ヒットテストにも一切答えません。レール方向の伸びは要素の箱ではなく持ち主判定の中だけにあるため、余裕のないスクロールコンテナへスクロールのはみ出しを足すこともありません。帯がホストの要素に重なっても、押下・ホバー・コンテキストメニューは何も変わりません。帯を空けるかどうかは、ラベルが読めるかどうかという見た目の判断です (レーンはレールの上下 22px、ノギスは 28px。ラベルの帯の厚みは描かれるラベルの寸法と傾きで変わり、日単位で接近した対では 90px を超えます)。
|
|
796
798
|
- **範囲領域の持ち主は幾何で決まります**: スライダーを 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) へ縮める。いずれもスライダーの機能は落ちません。
|
|
797
|
-
- **ドラッグ中はトラックがインライン変数を持ちます**: 押している間、トラック要素 (`[data-testid="period-slider-track"]`) は `--ps-drag-*` (
|
|
799
|
+
- **ドラッグ中はトラックがインライン変数を持ちます**: 押している間、トラック要素 (`[data-testid="period-slider-track"]`) は `--ps-drag-*` (位置と、ラベルの配置・引き出し線の長さと向き) を、指を離した直後の収め戻しの間は `data-drag-snap="true"` と `--ps-drag-snap-duration` を持ちます。いずれも内部のもので、上書き口ではありません。配布スタイルシートは位置と配置の 36 個をトラック自身へ `initial` として宣言するため、ホストが同名の変数を宣言してもスライダーの描画には届きません。`--ps-drag-snap-duration` には宣言を置きません — この変数が無い間は収め戻しの宣言そのものが算出時に無効となるため、既定時間で勝手に動き出すことがないからです (コンポーネントは属性と一緒に必ずインラインで書きます)。
|
|
798
800
|
- **当たり判定のはみ出し**: スライダーの当たり判定がレール方向へ伸びる分は、ステッパーの表示・非表示のどちらでもルート要素が自分の箱の中へ確保するため、**レール方向には離隔が要りません**。残るのはセレクタの ◀▶ の四方 11px と、スライダーのレールの交差軸方向 (ステッパーを表示していれば 11px、`showStepper={false}` なら 18px。ルートの箱の厚みがボタンの箱 22px からレールの 8px へ薄くなる分だけ、丸つまみの 44px の当たり判定が外へ残ります) です。
|
|
799
801
|
|
|
800
802
|
| 境界 | 空ける量 (ステッパー表示 / 非表示) |
|
|
@@ -808,6 +810,7 @@ export function FiscalQuarterLabelExample() {
|
|
|
808
810
|
| スライダー ⇄ 文字などの非操作要素 (交差軸方向) | 11px / 18px |
|
|
809
811
|
|
|
810
812
|
空けないと、はみ出した当たり判定が隣の文字や部品の押下を受けます。押せるステッパーの当たり判定は `--aqps-z-handle-front` + 1 (既定 41) の層に載るため、`z-index` が 41 未満のホストの層に重なると、ステッパーの上でその層の押下を奪います。
|
|
813
|
+
- **文書のスクロールの範囲に数えられるのは描かれた占有だけです**: つまみとラベルが掴んだ瞬間に光らせる飾りの層 (`::before` / `::after`) は、見えない間も掴んでいる間も、祖先と文書のスクロールの範囲に数えられません (配布スタイルシートがつまみとラベルへレイアウトの封じ込め `contain: layout` を宣言し、層を描画だけのはみ出しにします)。スライダーを画面の端に寄せても、祖先へ `overflow` を指定する必要はありません。数えられるのは、ルート要素の箱 (レール方向の当たり判定の予約を含む)、ラベル、交差軸へ伸びる当たり判定と範囲領域のレーン (上の表の交差軸と同じ、ステッパー表示時 11px / 非表示時 18px) です。掴んでいる間のラベルは 1.15 倍に拡大して描かれるため、ラベルが文書の端に接していると、掴んでいる間だけラベルの大きさの 7.5% (右端では幅、下に出したラベルの下端では高さ) だけ文書が送れます (幅 65px のラベルで約 5px)。
|
|
811
814
|
- **ルート要素のレイアウトはコンポーネントが持つ**: `PeriodSlider` のルート要素はグリッド (`grid` / `gap` / `place-items`)、セレクタのルート要素は内容幅の `inline-flex` です。`className` には寸法と余白 (`flex-1`、`h-60`、`w-fit` など) だけを与えてください。
|
|
812
815
|
- **縦向きのスライダー**: トラックの長さはルート要素の高さから決まるため、高さを与えてください (与えないとトラックは 0px に潰れます)。幅は `w-fit` などで内容へ合わせます。
|
|
813
816
|
- **セレクタだけを使う場合もスタイルシートを読み込む**: 44px の当たり判定は、配布スタイルシートがパッケージ自身の要素 (`.period-slider` と 1 単位移動ボタン) に宣言する内部変数を読みます。読み込まないと押せる範囲はボタンの箱 (22px) だけになります。
|
|
@@ -826,6 +829,9 @@ export function FiscalQuarterLabelExample() {
|
|
|
826
829
|
| `allowedDates` | `Date[]` | `undefined` | 離散スナップ対象日付配列 (指定時はこの日付のみにスナップ)。`[minDate, maxDate]` 外の要素は除外され、全要素が範囲外なら `RangeError`。省略は `undefined` だけで、`[]` はレールを連続のまま保つ。配列でない指定値 (`null`・単独の Date など) は `RangeError` (`PeriodSlider: allowedDates must be an array of Dates (received: null)`、ノギスの行が継いだときは `PeriodSlider: allowedDates (inherited by the micro row) must be an array of Dates (received: null)`)。どちらの `RangeError` も一覧を読む所で送出する。range / point は `unit` で読み、ノギスは自分の一覧を省略した離散の行 (`macroIsDiscrete` / `microIsDiscrete`) だけがその行の単位で読む (継ぐ行が無ければ読まず、検証もしない) |
|
|
827
830
|
| `snapMode` | `"index" \| "time"` | `"index"` | 離散スナップ時の配置方式 (`"index"`: 配列インデックス均等, `"time"`: 実時間比例)。実時間軸やチャートと位置を揃える場合は `"time"` を明示指定 |
|
|
828
831
|
| `labelPosition` | `"top" \| "bottom"` | `"top"` | 日付ラベルの表示位置 (スライダーの上側または下側) |
|
|
832
|
+
| `labelCeiling` | `Element \| null` | `undefined` | 横向きのスライダーの傾けたラベルを、その要素の下端より上へ描かない (画面の端とラベルを切る祖先に加える境。上にツールバーなどの操作の行がある場合に渡す)。要素そのもの (`ref.current`、または ref のコールバックで状態へ受けた要素) を渡す。文書に無い要素は何も区切らない。要素・`null`・`undefined` 以外 (ref オブジェクトを含む) は `RangeError` |
|
|
833
|
+
| `labelFloor` | `Element \| null` | `undefined` | 横向きのスライダーの傾けたラベルを、その要素の上端より下へ描かない。値の規則は `labelCeiling` と同じ |
|
|
834
|
+
| `showLabelLeaderLines` | `boolean` | `false` | 余白が足りずレールの反対側に立つラベルへ、つまみから細い引き出し線を引く (自分の側に立つ間は描かない) |
|
|
829
835
|
| `autoSlantLabels` | `boolean` | `true` | 近接時にラベルを斜め〜90° に自動傾斜させて重なりを防止 (Range の 1 対とノギスの 2 対へ対ごとに適用。垂直レイアウトでは適用されない) |
|
|
830
836
|
| `tooltipStyle` | `"always" \| "hover" \| "balloon"` | `"always"` | ツールチップの表示スタイル (`"always"`: 常時, `"hover"`: ポインター操作時, `"balloon"`: 吹き出し型)。`"balloon"` の宣言は `!important` 付きでユーティリティ層に勝つが、ノギスのツールチップだけは段の配色 (マクロ青 / ミクロ赤) を保ち、角丸・余白・文字サイズ・高さのみ吹き出し型になる |
|
|
831
837
|
| `isVertical` | `boolean` | `false` | 垂直スライダー表示の有効化。**ホストが `className` で高さを与える必要があります** (トラックの長さはルート要素の高さ − 104px、`showStepper={false}` では高さ − 44px で、高さが無いと 0px に潰れて何も見えません) |
|
|
@@ -951,7 +957,7 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
951
957
|
| `[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` と直交する |
|
|
952
958
|
| `[data-testid="period-slider-track"]` | トラック (`data-vernier-orientation` でノギスのレール配置を判別) |
|
|
953
959
|
| `[data-range-area]` | 範囲領域 (ルート要素の最初の子)。`Shift` + ホイールを受ける矩形そのもので、何も描かず `pointer-events: none` のためヒットテストにも答えない |
|
|
954
|
-
| `button[aria-label]` 内の `svg[data-arrow="left" \| "right" \| "up" \| "down"]` | ステッパー (アクセシブル名は `labels` の `decrease` / `increase`、`type="button"`)
|
|
960
|
+
| `button[aria-label]` 内の `svg[data-arrow="left" \| "right" \| "up" \| "down"]` | ステッパー (アクセシブル名は `labels` の `decrease` / `increase`、`type="button"`) とその矢印の向き。描く絵は `data-glyph="single" \| "double"` (スライダーは常に `single`、セレクタは `stepGlyph`)。矢印は色を持たず、ボタンの文字色 (`currentColor`) で塗られる (パッケージのスタイルシートも、ボタンや祖先のクラスも矢印を選ばない)。ホバーの文字色は不透明で、押せる矢印をホバーで使用不可の淡色へ落とさない。境界で動けない間はボタンが `aria-disabled="true"` を持ち、フォーカスを保ちタブ順にも残ったまま押下を受け付けない。ネイティブの `disabled` は `disabled` Props でスライダー全体を無効にしたときだけ付く |
|
|
955
961
|
| `[data-testid="period-slider-connect"]` | 接続バー。ノギスでは `period-slider-connect-macro` / `period-slider-connect-micro` の 2 本 (ミクロが時点の形態では `period-slider-connect-micro` を描かない) |
|
|
956
962
|
| `[data-testid="period-slider-tick"]` | 目盛線と離散レールの候補点。ノギスモードでは `data-tick-scale="macro" \| "micro"` が併記され上下段を判別できる。塗りはパッケージのスタイルシートが 1 か所で持つ (レールの境界線と同じインク) |
|
|
957
963
|
| `[data-testid="period-slider-hairline"]` | ノギスの読み取りの針 (`showHairline` が真のときだけ描かれる)。線の中心がつまみの中心 = 値そのものに揃う |
|
|
@@ -960,6 +966,8 @@ DOM 要素の特定は CSS クラス名ではなく `data-*` 属性で行いま
|
|
|
960
966
|
| `[data-testid="period-slider-hover-tooltip"]` | オーバーレイの追従ラベル。指している値がつまみの確定値と一致する間は `data-duplicate="true"` が付いて `visibility: hidden` になる |
|
|
961
967
|
| `[data-tooltip-style="always" \| "hover" \| "balloon"]` | すべてのツールチップ (Range は 2 枚、Point は 1 枚、ノギスはミクロ期間形態が 4 枚・ミクロ時点形態が 3 枚)。`tooltipStyle="hover"` ではツールチップ要素自体が描かれない。`range` / `point` のツールチップは `data-label-position` / `data-front` を併せ持つ (ノギスではこの 2 つは親つまみ側にある) |
|
|
962
968
|
| `[data-slanted="true"]` | 近接傾斜中のツールチップ。Range の 2 枚とノギスのミクロ期間形態の 4 枚が対象 (Point モードと、ノギスのミクロ時点形態のミクロラベルには付かない。いずれも離す相手が居ないため)。ノギスは対ごとに独立して傾くため、マクロ対とミクロ対で有無が違うのは正常。垂直レイアウトでは付かない |
|
|
969
|
+
| `[data-flipped="true"]` | 余白が足りず、`labelPosition` (ノギスはそのレールの側) の反対側に立つ対のツールチップ 2 枚。横向きの Range とノギスの対だけに付く |
|
|
970
|
+
| `[data-label-leader="true"]` | 引き出し線 (`aria-hidden="true"`)。`showLabelLeaderLines` が真で、対が傾斜を解ける間 (横向きの Range と横向きのノギスの対、`autoSlantLabels` 有効時) だけ、各ツールチップの直後の兄弟に置かれる。ラベルが自分の側に立つ間は長さ 0 で何も描かない |
|
|
963
971
|
| `[data-duplicate="true"]` | 同じ値が二重に描かれる側を隠す唯一の印。対象は 2 種類で、いずれも符号化値 (`aria-valuenow`) の厳密一致が条件。(1) 同じ値に重なった対のうち冗長な側のつまみラベル 1 枚 — 対は Range の下限 / 上限、ノギスのマクロ下限 / 上限、ノギスのミクロ期間形態のミクロ下限 / 上限の 3 つで、Point モードとノギスのミクロ時点形態には付かない。(2) 指している値がつまみの確定値と一致したときのオーバーレイの追従ラベル — こちらは Point モードでも付く (`tooltipStyle="hover"` ではつまみのラベルが描かれず二重にならないため付かない) |
|
|
964
972
|
| `[data-handle-type="macro-low"] [data-tooltip-style]` | 個々のノギスラベル。ノギスのツールチップは親つまみ経由で特定する。水平レール (`macro-top` / `macro-bottom`) かつ `autoSlantLabels` 有効時はインライン `style` に `--ps-tooltip-tx` / `--ps-tooltip-ty` / `--ps-tooltip-rot` の 3 つを持ち (`--ps-tooltip-ty` はレール基準からの生のピクセル差分)、垂直レール (`macro-left` / `macro-right`)、`autoSlantLabels={false}`、およびミクロ時点形態のミクロラベルでは `style` 属性を持たない (時点には離す相手が居ないため傾斜計算そのものを行わない) |
|
|
965
973
|
|
|
@@ -1084,6 +1092,7 @@ yearStartMonth=9 2,2,2,3,3,3,4,4,4,1,1,1
|
|
|
1084
1092
|
| `PeriodSlider` | `minDate` が未指定または Invalid Date | `RangeError: PeriodSlider: minDate is required and must be a valid Date (received: ...)` |
|
|
1085
1093
|
| `PeriodSlider` | `maxDate` が未指定または Invalid Date | `RangeError: PeriodSlider: maxDate is required and must be a valid Date (received: ...)` |
|
|
1086
1094
|
| `PeriodSlider` | `maxDate <= minDate` | `RangeError: PeriodSlider: maxDate must be strictly later than minDate (...)` |
|
|
1095
|
+
| `PeriodSlider` | `labelCeiling` / `labelFloor` が要素・`null`・`undefined` 以外 (ref オブジェクト・セレクタ文字列など。全モードで描画のたびに判定) | `RangeError: PeriodSlider: labelCeiling must be an Element or null (received: ...)`。ref オブジェクトには `; pass the element itself (ref.current), not the ref object` が続く |
|
|
1087
1096
|
| `PeriodSlider` | `minDate` の単位の始まりが Date の表現範囲の外 (平レールは `unit`、`vernier` は `macroUnit`・`microUnit`・`unit` の順に判定し、最初に外れた単位を名乗る。ノギスも共有の平坦な値を `unit` で作るため)。`new Date(-8.64e15)` は月と年ではどの時間帯でも、日では UTC 以外で該当し、年の始まりは `yearStartMonth` と共に動く | `RangeError: PeriodSlider: minDate must fall in a day that starts inside the Date range (received: -271821-04-20T00:00:00.000Z); minDate is required, so pass the earliest date to offer instead of a sentinel for "no bound"` |
|
|
1088
1097
|
| `PeriodSlider` (`vernier`) | `macroRange` の未指定・2 要素タプル以外・Invalid Date・逆転 | `RangeError: PeriodSlider: macroRange is required and must be a [start, end] Date tuple (...)` / `... macroRange[0] must be a valid Date (...)` / `... macroRange must not be inverted (...)` |
|
|
1089
1098
|
| `PeriodSlider` (`vernier`) | ミクロ選択 Props を 1 つも指定していない | `RangeError: PeriodSlider: vernier mode requires a micro selection; supply microRange / defaultMicroRange for a period, or microValue / defaultMicroValue for a point` |
|
|
@@ -1110,11 +1119,13 @@ yearStartMonth=9 2,2,2,3,3,3,4,4,4,1,1,1
|
|
|
1110
1119
|
| `resolveMacroWindow` | 宣言外の `macroUnit` / `microUnit` (この順に最初に判定)、`macroRange` が 2 要素タプルでない・Invalid Date を含む・逆転、`minDate` / `maxDate` が Invalid Date・逆転、不正な `yearStartMonth`、`maxDate` の `microUnit` の始まりが Date の表現範囲の外 (`maxDate` へクランプした窓の端は `microUnit` で畳むため)、`macroRange[0]` の `macroUnit` または `microUnit` の始まりが Date の表現範囲の外 (窓の開始はこの 2 つの単位で畳むため)。`minDate` は判定しない (`minDate` へクランプするのは、範囲に入るミクロ単位の始まりである窓の端より後にあるときだけのため) | `RangeError: resolveMacroWindow: maxDate must fall in a month that starts inside the Date range (received: ...)` / `... macroRange[0] must fall in a month that starts inside the Date range (received: ...)` 等 (すべて自身の名を名乗る) |
|
|
1111
1120
|
| `resolveSelectorSteps` | オプションがオブジェクトでない、未知の `unit` / `stepUnit` (`null` を含む) / `shows`、`unit` そのものでも月の選択に対する `"year"` でもない `stepUnit`、不正な `yearStartMonth`、`unit` の解像度で逆転した・有効な Date 2 つでない `selection`、不正または逆転した境界、`allowedDates` が配列でない・不正な要素 (疎配列の穴を含む)、整っていない `rules`、単位の始まりが Date の表現範囲の外にある日付 | `RangeError: resolveSelectorSteps: selection must not be inverted at month resolution (...)` / `... stepUnit must be "day" for a day selection, ...` 等 |
|
|
1112
1121
|
| `resolveVernierSelectorSteps` | 未知の `row` / `shows` / 単位、不正な `yearStartMonth`、不正または厳密に順序づいていない境界、`macroUnit` または `microUnit` の始まりが Date の表現範囲の外にある `minDate` (`macroUnit` を先に判定。`maxDate` は厳密に後にあるため判定しない)、有効な Date 2 つで順序どおりでない `macroRange` / `microSelection` (`macroRange` は同じマクロ単位の中の時刻の逆転も)、候補が配列でない・不正な要素 (疎配列の穴を含む)・全要素が定義域の外、整っていない `rules`、単位の始まりが Date の表現範囲の外にある `macroRange` (`macroUnit`)・`microSelection` (`microUnit`)・候補 (その行の単位) | `RangeError: resolveVernierSelectorSteps: minDate must fall in a month that starts inside the Date range (received: ...)` / `... every microAllowedDates entry falls outside [minDate, maxDate] (...)` 等 |
|
|
1122
|
+
| `calculateLabelSlant` | `config.room` の `topPx` / `bottomPx` が数でない・`NaN`・負 (無制限は `Infinity`)、`config.drawnScale` が正の有限数でない、`config.flipClearancePx` が負・有限でない (この順に、トラックとラベルの未実測による直立の短絡より先に判定) | `RangeError: calculateLabelSlant: config.room.topPx must be a number of pixels, zero or more (Infinity for unbounded) (received: ...)` / `... config.drawnScale must be a positive finite number (received: ...)` / `... config.flipClearancePx must be a finite number of pixels, zero or more (received: ...)` |
|
|
1113
1123
|
| 4 部品すべて | `formatLocale` が空文字列・構造として不正な BCP 47 タグ・非文字列 | `RangeError: <コンポーネント名>: formatLocale must be a valid BCP 47 language tag (received: ...)` |
|
|
1114
1124
|
| 4 部品すべて | `locale` が `"en"` / `"ja"` 以外 (`"ja-JP"`・`"EN"`・`""`・`null` 等) | `RangeError: [period-slider] locale is the UI language, not a BCP 47 tag (date formatting reads formatLocale): [virtualscroll] locale must be one of "en", "ja"; got ...` (`cause` はエンジンの `RangeError`) |
|
|
1115
|
-
| 4 部品すべて | `labels` が `null`・非オブジェクト・素のオブジェクトでない・未知キー (`*AriaLabel` の名前を含む)・空白や非文字列の値 | `RangeError: [period-slider] labels ...` (
|
|
1125
|
+
| 4 部品すべて | `labels` が `null`・非オブジェクト・素のオブジェクトでない・未知キー (`*AriaLabel` の名前を含む)・空白や非文字列の値 | `RangeError: [period-slider] labels ...` (エンジンキーの値は `RangeError: [virtualscroll] labels.<キー> must be a non-blank string; ...`) |
|
|
1116
1126
|
| `YearSelector` / `MonthSelector` / `DateSelector` | `value` と `initialDate` が共に未指定 | `RangeError: <コンポーネント名>: either value (controlled) or initialDate (uncontrolled) is required; ...` |
|
|
1117
1127
|
| `YearSelector` / `MonthSelector` / `DateSelector` | `stepper` がオブジェクトでない、`onStep` が関数でない、`canStepPrevious` / `canStepNext` が真偽値でない、または `value` を渡さずに `stepper` を渡した | `RangeError: MonthSelector: stepper.onStep must be a function (received: "next")` / `RangeError: DateSelector: stepper.canStepNext must be a boolean (received: undefined)` / `... stepper requires the controlled value; ...` |
|
|
1128
|
+
| `YearSelector` / `MonthSelector` / `DateSelector` | `stepGlyph` が `"single"` / `"double"` 以外 (`null`・`""`・大文字違いを含む。省略は `"single"`) | `RangeError: YearSelector: stepGlyph must be "single" or "double" (received: "triple")` |
|
|
1118
1129
|
| `YearSelector` | 境界の欠落・矛盾、Date / 年 Props の不正値、`allowedYears` の要素が Invalid Date または `Date` でない (`undefined`・疎配列の穴を含む。添字付きで報告) | `RangeError` |
|
|
1119
1130
|
| `YearSelector` | Date Props (`value` / `initialDate` / `minDate` / `maxDate` / `allowedYears` の要素) を含む年、または年 Props (`minYear` / `maxYear`) の年の始まり (`yearStartMonth` の月の 1 日) が Date の表現範囲の外 (`new Date(-8.64e15)` はどのタイムゾーンでも該当) | `RangeError: YearSelector: minDate must fall in a year that starts inside the Date range (received: ...); ...` / `... maxYear must name a year that starts inside the Date range (received: 275760); under yearStartMonth 9 that year starts on month 10, day 1` |
|
|
1120
1131
|
| `MonthSelector` | 境界の矛盾、`allowedMonths` を伴わない `variant="dropdown"` での境界の欠落、`allowedMonths` の要素が Invalid Date または `Date` でない (`undefined`・疎配列の穴を含む。添字付きで報告)、Date / 年 Props の不正値 | `RangeError: MonthSelector: allowedMonths[1] must be a valid Date (received: ...)` 等 |
|
|
@@ -1336,6 +1347,7 @@ export function SelectorsExample() {
|
|
|
1336
1347
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付 (年のみ使用)。`maxYear` と併用時は厳しい方を採用 |
|
|
1337
1348
|
| `onChange` | `(date: Date, year: number) => void` | `undefined` | 年変更時コールバック。`date` は該当年の先頭月 1 日ローカル 0 時 (`yearStartMonth` が `0` なら 1 月 1 日)、`year` はその年の番号。`stepper` を渡している間、◀▶ はこれを呼ばない |
|
|
1338
1349
|
| `stepper` | `SelectorStepper` | `undefined` | ◀▶ の引き受け。押下は `stepper.onStep("previous" \| "next")` だけを呼び、押せるかどうかは `canStepPrevious` / `canStepNext` そのもの。セレクタは自分の値を動かさないため、制御の `value` が必須 ([セレクタの矢印を所有者が引き受ける](#セレクタの矢印を所有者が引き受ける-stepper-と-1-歩の規則)) |
|
|
1350
|
+
| `stepGlyph` | `StepGlyph` (`"single" \| "double"`) | `"single"` | ◀▶ の矢印の絵。`"single"` は三角形 1 つ (`<` / `>`)、`"double"` は三角形 2 つを重ねた絵 (`<<` / `>>`)。`stepper` で窓や期間ごとに大きく送るボタンを見分ける用途。描く絵だけが変わり、箱・押せる範囲・ホバー・フォーカス・使用不可 (`aria-disabled`) の見た目・アクセシブル名 (`labels`) は変わらない (絵は `aria-hidden`)。それ以外の値 (`null`・`""` を含む) は `RangeError` |
|
|
1339
1351
|
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とコンボボックス・セレクト・入力をネイティブに無効化する (タブ順から外れ、ポップアップも開かない) |
|
|
1340
1352
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
1341
1353
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
@@ -1372,6 +1384,7 @@ DOM 契約: 保持年が集合外の間、ルート要素に `data-out-of-range=
|
|
|
1372
1384
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付 (月頭に切り捨て)。`maxYear` と併用時は厳しい方を採用 |
|
|
1373
1385
|
| `onChange` | `(date: Date, yyyymm: number) => void` | `undefined` | 選択可能な月が選ばれた時のコールバック。`date` は該当月 1 日ローカル 0 時、`yyyymm` は `年 * 100 + 月` の整数。`stepper` を渡している間、◀▶ はこれを呼ばない |
|
|
1374
1386
|
| `stepper` | `SelectorStepper` | `undefined` | ◀▶ の引き受け。押下は `stepper.onStep("previous" \| "next")` だけを呼び、押せるかどうかは `canStepPrevious` / `canStepNext` そのもの。セレクタは自分の値を動かさないため、制御の `value` が必須 ([セレクタの矢印を所有者が引き受ける](#セレクタの矢印を所有者が引き受ける-stepper-と-1-歩の規則)) |
|
|
1387
|
+
| `stepGlyph` | `StepGlyph` (`"single" \| "double"`) | `"single"` | ◀▶ の矢印の絵。`"single"` は三角形 1 つ (`<` / `>`)、`"double"` は三角形 2 つを重ねた絵 (`<<` / `>>`)。`stepper` で窓や期間ごとに大きく送るボタンを見分ける用途。描く絵だけが変わり、箱・押せる範囲・ホバー・フォーカス・使用不可 (`aria-disabled`) の見た目・アクセシブル名 (`labels`) は変わらない (絵は `aria-hidden`)。それ以外の値 (`null`・`""` を含む) は `RangeError` |
|
|
1375
1388
|
| `isWarning` | `boolean` | `false` | 警告枠スタイル (アンバー) の適用フラグ。`variant` を問わず有効 |
|
|
1376
1389
|
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
1377
1390
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
@@ -1419,12 +1432,13 @@ const allowedMonths = useMemo(() => baseMonths.map((yyyymm) => new Date(Math.tru
|
|
|
1419
1432
|
| `maxDate` | `Date` | `undefined` | 選択可能な最大日付。`maxYear` と併用時は厳しい方を採用 |
|
|
1420
1433
|
| `onChange` | `(date: Date) => void` | `undefined` | 選択日付変更時コールバック。選択可能集合内の日付でのみ発火し、ローカル 0 時に正規化された `Date` を渡す。`stepper` を渡している間、◀▶ はこれを呼ばない |
|
|
1421
1434
|
| `stepper` | `SelectorStepper` | `undefined` | ◀▶ の引き受け。押下は `stepper.onStep("previous" \| "next")` だけを呼び、押せるかどうかは `canStepPrevious` / `canStepNext` そのもの。セレクタは自分の値を動かさないため、制御の `value` が必須 ([セレクタの矢印を所有者が引き受ける](#セレクタの矢印を所有者が引き受ける-stepper-と-1-歩の規則)) |
|
|
1435
|
+
| `stepGlyph` | `StepGlyph` (`"single" \| "double"`) | `"single"` | ◀▶ の矢印の絵。`"single"` は三角形 1 つ (`<` / `>`)、`"double"` は三角形 2 つを重ねた絵 (`<<` / `>>`)。`stepper` で窓や期間ごとに大きく送るボタンを見分ける用途。描く絵だけが変わり、箱・押せる範囲・ホバー・フォーカス・使用不可 (`aria-disabled`) の見た目・アクセシブル名 (`labels`) は変わらない (絵は `aria-hidden`)。それ以外の値 (`null`・`""` を含む) は `RangeError` |
|
|
1422
1436
|
| `disabled` | `boolean` | `false` | 無効化フラグ。`true` の間は `onChange` を発火せず、◀▶ とセレクトボックス・入力をネイティブに無効化する (タブ順から外れる) |
|
|
1423
1437
|
| `className` | `string` | `""` | ルート要素の追加 CSS クラス |
|
|
1424
1438
|
| `style` | `React.CSSProperties` | `undefined` | ルート要素のインラインスタイル |
|
|
1425
1439
|
| `children` | `React.ReactNode` | `undefined` | ルート要素末尾へ追加描画する子要素 |
|
|
1426
1440
|
| `locale` | `PeriodSliderLocale` | `undefined` (= `"en"`) | UI クローム言語。アクセシブル名 (`previousDay` / `nextDay` / `dateSelect`、`variant="split-dropdown"` では `splitYear` / `splitMonth` / `splitDay`) と、`variant="dropdown"` のポップアップに埋め込まれた `@aiquants/virtualscroll` のスクロールクロームの言語を選ぶ |
|
|
1427
|
-
| `labels` | `PeriodSliderLabelOverrides` | `undefined` | カタログへのキー単位の上書き。読むのは `previousDay` / `nextDay` / `dateSelect` / `splitYear` / `splitMonth` / `splitDay` と、`variant="dropdown"`
|
|
1441
|
+
| `labels` | `PeriodSliderLabelOverrides` | `undefined` | カタログへのキー単位の上書き。読むのは `previousDay` / `nextDay` / `dateSelect` / `splitYear` / `splitMonth` / `splitDay` と、`variant="dropdown"` ではエンジンキー全件 (`VIRTUAL_SCROLL_LABEL_KEYS`。内蔵 VirtualScroll へ転送) |
|
|
1428
1442
|
| `formatLocale` | `string` | `undefined` | 選択肢テキストのロケール (BCP 47 言語タグ)。未指定は ISO 8601 (`variant="dropdown"` は `YYYY-MM-DD`、`variant="split-dropdown"` は `2024` / `01` / `15`)、指定時は `Intl.DateTimeFormat` 書式。`<input type="date">` の値・コンボボックスの `data-value`・`<option value>` は常に `yyyy-MM-dd` または生の数値。空文字列・不正タグ・非文字列は `RangeError` |
|
|
1429
1443
|
| `formatOption` | `PeriodOptionFormatter` | `undefined` | 選択肢・プレースホルダ・畳んだ表示のテキスト生成関数 (`formatLocale` より優先)。`(date, unit, scope) => string` で、`unit` と `scope` はコンポーネントが与える。ネイティブ入力を使う `variant="date"` では履行できないため**呼び出しも行わない**。返り値は機械可読値・`aria-label`・`onChange` の引数には届かない。参照比較で再描画を判定するため、利用側でメモ化する |
|
|
1430
1444
|
| `unit` | — | — | **このコンポーネントが宣言していない名前です**。フックの `SelectorProps` をそのままスプレッドできるよう、受け取っても読まれず捨てられます (コンポーネントは必要な Props だけを名前で取り出すため、DOM へも届きません)。型にも宣言が無いので、JSX へ直接書くとコンパイルエラーになります (スプレッドは余剰プロパティ検査を受けないため通ります) |
|
|
@@ -1449,7 +1463,7 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
1449
1463
|
- 操作要素は `<input type="text" readonly role="combobox">` で、`value` には人間が読むテキスト (`formatOption` 指定時はその返り値、未指定なら `formatLocale` 書式)、`data-value` には常に `yyyy-MM-dd` の機械可読値を持ちます。この `value` は選択中の行のテキストと必ず一致します (同じ関数値へ同じ形の引数を渡すため)。`aria-expanded` / `aria-haspopup="listbox"` / `aria-controls` (ポップアップが描かれている間) / `aria-activedescendant` (アクティブ行が DOM に在る間。スクロールで窓の外へ出ると外れ、戻ると同じ確定で付き、Activity などで隠れている間は持たない) を持ち、`data-testid="period-slider-date-combobox"` で引けます。集合外の保持値は行にならず、操作要素の表示テキストとしてだけ現れます。
|
|
1450
1464
|
- 開く位置は保持値の行、保持値が集合の外にあるときは**その値に最も近い行** (同距離では早い側の日付) です。先頭行から開かないため、100 年の定義域でも戻る操作が数行で済みます。開いた行は `data-active="true"` と `aria-activedescendant` が指しますが、集合外の保持値では `aria-selected="true"` の行は 1 つもありません (アクティブ行は「これから選ぶ候補」であり、選択済みではないため)。操作要素の表示テキストと `data-out-of-range="true"` はどちらも動きません。
|
|
1451
1465
|
- ポップアップは `document.body` へポータルされ (`data-testid="period-slider-date-popup"`)、開いた時点の操作要素の位置から解決した配色モードを `data-color-mode="light|dark"` として持ち、操作要素の下に開き、余地が無ければ上へ反転して視野内へ収まります。中の `role="listbox"` (アクセシブル名は `labels.dateSelect`、操作要素と同じ名前) が `role="option"` の行を持ち、各行は `aria-selected` / `aria-posinset` / `aria-setsize` (集合全体の件数) / `data-active` (キーボードの現在位置) を持ち、`data-testid="period-slider-date-option"` で引けます。DOM に存在する行は可視窓の分だけで、集合全体の件数は `aria-setsize` から読みます。所有側 (`Activity`・`Suspense`) が隠れている間、ポップアップは画面に出ません (隠す確定でインラインの `display: none !important` を持ち、閉じて外れます)。隠れている間に操作要素へ届いた打鍵と押下は何もしません (一覧を開かず、`onChange` も呼びません)。
|
|
1452
|
-
- ポップアップには `role="listbox"` のほかに `@aiquants/virtualscroll` のスクロールバーが同居します (`role="scrollbar"
|
|
1466
|
+
- ポップアップには `role="listbox"` のほかに `@aiquants/virtualscroll` のスクロールバーが同居します (値と名前を持つ `role="scrollbar"` の溝 1 つと、その外に並ぶ `aria-label` を持つ矢印ボタン 2 つ。つまみは見た目だけで、役割を持ちません)。矢印ボタンは常に `disabled` でタブ順にもキーボード操作にも現れませんが、アクセシビリティツリーには残ります。その名前は `locale` のカタログの `scrollUp` / `scrollDown` (`Scroll up` / `Scroll down`、`ja` では `上へスクロール` / `下へスクロール`) で、溝の名前は `verticalScrollBar` (`Vertical`、`ja` では `縦方向`) です。どれも `labels` の同じキーで上書きできます (本パッケージが内蔵 VirtualScroll へ `locale` とエンジンキー全件を転送します)。ポップアップに絞った `getByRole("button")` はこの 2 つに当たるため、行は `role="option"` か `data-testid` で引いてください。
|
|
1453
1467
|
- キーボード: `ArrowDown` / `ArrowUp` (閉じていれば開く、開いていれば 1 行移動)、`Home` / `End` (先頭 = 最新日 / 末尾 = 最古日)、`PageDown` / `PageUp` (1 窓 = 7 行)、`Enter` (閉じていれば開く、開いていればアクティブ行を確定)、`Escape` (閉じる・発火しない)、`Tab` (閉じる)、数字と `-` / `/` / `.` (先頭一致入力。**表示書式に関わらず**先発グレゴリオ暦の `yyyy` / `yyyyMM` / `yyyyMMdd` として解釈し、走査せずに当該日へ飛ぶ。`formatOption` が非数字のテキストを返していても変わらない)。行の押下でも DOM フォーカスは操作要素から離れません。
|
|
1454
1468
|
- 閉じる契機: 行の確定、`Escape`、`Tab`、操作要素からのフォーカス喪失、ポップアップ外の `pointerdown`、所有側が `<Activity mode="hidden">` で隠れたとき・`Suspense` がフォールバックを出したとき (表示し直しても閉じたまま)。
|
|
1455
1469
|
- `startTransition` で渡した境界・`allowedDates`・`formatLocale`・`formatOption` は、その描画が確定するまでポップアップに使われません。一覧の行 (スクロールで描き足す行も)・先頭一致入力・行の押下は、画面に描かれている一覧を読みます。開いたまま件数が縮み、アクティブ行が一覧の外に出るときは、件数を縮めた描画のうちに末尾の行へ移り、件数が戻っても移った行に留まります。開いている間に配置だけが変わる描画 (ページのスクロール・リサイズへの追従) は、描かれている行を描き直しません (`formatOption` を呼ぶのは新しく描く行だけです)。
|
package/dist/DateSelector.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
2
|
import { PeriodSliderLabelOverrides, PeriodSliderLocale } from './labels.js';
|
|
3
3
|
import { PeriodOptionFormatter } from './PeriodSlider.js';
|
|
4
|
+
import { StepGlyph } from './StepperButton.js';
|
|
4
5
|
import { SelectorStepper } from './selectorStep.js';
|
|
5
6
|
/**
|
|
6
7
|
* Props of the day-resolution selector.
|
|
@@ -27,6 +28,16 @@ export interface DateSelectorProps {
|
|
|
27
28
|
* セレクタは自分の値を動かさなくなるため、制御の `value` を要求する。
|
|
28
29
|
*/
|
|
29
30
|
stepper?: SelectorStepper | undefined;
|
|
31
|
+
/**
|
|
32
|
+
* How the ◀▶ draw their arrow (default "single"): "single" is one triangle, for a step of one unit; "double" is two triangles
|
|
33
|
+
* in a row, for a larger step such as a window or a whole period that a `stepper` owner takes. The box, the target, the hover,
|
|
34
|
+
* the focus ring and the unavailable look are the same for both, the arrow stays `aria-hidden`, and the accessible names still
|
|
35
|
+
* come from `labels`, so the glyph and the names are chosen independently. Anything else, `null` and `""` included, throws RangeError.
|
|
36
|
+
* ◀▶ の矢印の描き方 (既定 "single")。"single" は三角形 1 つで 1 単位の送り、"double" は三角形 2 つを並べたもので、`stepper` の所有者が
|
|
37
|
+
* 引き受ける窓や期間ごとの大きな送り。箱・当たり判定・ホバー・フォーカスリング・使用不可の見た目はどちらも同じで、矢印は `aria-hidden` のまま、
|
|
38
|
+
* アクセシブル名は引き続き `labels` から決まるため、字形と名前は別々に選べる。それ以外の値 (`null`・`""` を含む) は RangeError。
|
|
39
|
+
*/
|
|
40
|
+
stepGlyph?: StepGlyph;
|
|
30
41
|
/** Child elements / 子要素 */
|
|
31
42
|
children?: React.ReactNode;
|
|
32
43
|
/** Minimum selectable year; intersected with minDate when both are given / 選択可能範囲の最小年 (minDate 併用時は厳しい方を採用) */
|
|
@@ -55,7 +66,7 @@ export interface DateSelectorProps {
|
|
|
55
66
|
disabled?: boolean;
|
|
56
67
|
/** UI chrome language of the accessible names and of the dropdown's scroll chrome ("en" | "ja", default "en"); anything else throws RangeError / アクセシブル名とドロップダウンのスクロールクロームの UI クローム言語 ("en" | "ja"、既定 "en"。それ以外は RangeError) */
|
|
57
68
|
locale?: PeriodSliderLocale;
|
|
58
|
-
/** Per-key overrides over the `locale` catalog; this component reads `previousDay`, `nextDay`, `dateSelect`, `splitYear`, `splitMonth`, `splitDay` and, in variant="dropdown", the
|
|
69
|
+
/** Per-key overrides over the `locale` catalog; this component reads `previousDay`, `nextDay`, `dateSelect`, `splitYear`, `splitMonth`, `splitDay` and, in variant="dropdown", the engine keys (`VIRTUAL_SCROLL_LABEL_KEYS`) / `locale` カタログへのキー単位の上書き (本コンポーネントが読むのは `previousDay`・`nextDay`・`dateSelect`・`splitYear`・`splitMonth`・`splitDay`、variant="dropdown" ではエンジンキー全件も) */
|
|
59
70
|
labels?: PeriodSliderLabelOverrides;
|
|
60
71
|
/** BCP 47 language tag switching option text to Intl formatting; omitted keeps locale-independent ISO 8601, and the input value stays yyyy-MM-dd either way / 選択肢テキストを Intl 書式にする BCP 47 言語タグ (未指定時はロケール非依存の ISO 8601 表記・input の value は常に yyyy-MM-dd) */
|
|
61
72
|
formatLocale?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAA0B,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE3G,OAAO,EAA2E,KAAK,qBAAqB,EAA8C,MAAM,gBAAgB,CAAA;
|
|
1
|
+
{"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAA0B,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE3G,OAAO,EAA2E,KAAK,qBAAqB,EAA8C,MAAM,gBAAgB,CAAA;AAChL,OAAO,EAA2C,KAAK,SAAS,EAAiB,MAAM,iBAAiB,CAAA;AAExG,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAM5E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAC9B,qJAAqJ;IACrJ,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,4UAA4U;IAC5U,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,sKAAsK;IACtK,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACrC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,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,gbAAgb;IAChb,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;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,gOAAgO;IAChO,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,kXAAkX;IAClX,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,0PAA0P;IAC1P,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mUAAmU;IACnU,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACvC;AAqnBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,iBAAiB,EAAE,MAAM,iBAAiB,KAAG,OA4B5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,oCAjaa,iBAAiB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiaO,CAAA"}
|
package/dist/MonthSelector.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
2
|
import { PeriodSliderLabelOverrides, PeriodSliderLocale } from './labels.js';
|
|
3
3
|
import { PeriodOptionFormatter } from './PeriodSlider.js';
|
|
4
|
+
import { StepGlyph } from './StepperButton.js';
|
|
4
5
|
import { SelectorStepper } from './selectorStep.js';
|
|
5
6
|
/**
|
|
6
7
|
* Props of the month-resolution selector.
|
|
@@ -27,6 +28,16 @@ export interface MonthSelectorProps {
|
|
|
27
28
|
* セレクタは自分の値を動かさなくなるため、制御の `value` を要求する。
|
|
28
29
|
*/
|
|
29
30
|
stepper?: SelectorStepper | undefined;
|
|
31
|
+
/**
|
|
32
|
+
* How the ◀▶ draw their arrow (default "single"): "single" is one triangle, for a step of one unit; "double" is two triangles
|
|
33
|
+
* in a row, for a larger step such as a window or a whole period that a `stepper` owner takes. The box, the target, the hover,
|
|
34
|
+
* the focus ring and the unavailable look are the same for both, the arrow stays `aria-hidden`, and the accessible names still
|
|
35
|
+
* come from `labels`, so the glyph and the names are chosen independently. Anything else, `null` and `""` included, throws RangeError.
|
|
36
|
+
* ◀▶ の矢印の描き方 (既定 "single")。"single" は三角形 1 つで 1 単位の送り、"double" は三角形 2 つを並べたもので、`stepper` の所有者が
|
|
37
|
+
* 引き受ける窓や期間ごとの大きな送り。箱・当たり判定・ホバー・フォーカスリング・使用不可の見た目はどちらも同じで、矢印は `aria-hidden` のまま、
|
|
38
|
+
* アクセシブル名は引き続き `labels` から決まるため、字形と名前は別々に選べる。それ以外の値 (`null`・`""` を含む) は RangeError。
|
|
39
|
+
*/
|
|
40
|
+
stepGlyph?: StepGlyph;
|
|
30
41
|
/** Child elements / 子要素 */
|
|
31
42
|
children?: React.ReactNode;
|
|
32
43
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAA0B,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC3G,OAAO,EAAkG,KAAK,qBAAqB,EAAuB,MAAM,gBAAgB,CAAA;
|
|
1
|
+
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAA0B,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC3G,OAAO,EAAkG,KAAK,qBAAqB,EAAuB,MAAM,gBAAgB,CAAA;AAChL,OAAO,EAA2C,KAAK,SAAS,EAAiB,MAAM,iBAAiB,CAAA;AAExG,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAK5E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,+GAA+G;IAC/G,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,wSAAwS;IACxS,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,sKAAsK;IACtK,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACrC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,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,2TAA2T;IAC3T,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IAClC,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,0KAA0K;IAC1K,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,2MAA2M;IAC3M,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,oPAAoP;IACpP,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mUAAmU;IACnU,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACvC;AAgeD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM,kBAAkB,EAAE,MAAM,kBAAkB,KAAG,OA2B/F,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,oCAvPa,kBAAkB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuPQ,CAAA"}
|
package/dist/PeriodSlider.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { default as React, CSSProperties } from 'react';
|
|
2
|
+
import { LabelRoom } from './labelRoom.js';
|
|
2
3
|
import { PeriodSliderLabelOverrides, PeriodSliderLocale } from './labels.js';
|
|
3
4
|
import { DrawnValues } from './valueSet.js';
|
|
4
5
|
/**
|
|
@@ -118,6 +119,12 @@ export interface LabelSlantConfig {
|
|
|
118
119
|
maxAngleDeg?: number;
|
|
119
120
|
/** Clearance between the knob edge and the label edge in Y axis (pixels, default: 2) / つまみ外縁とラベル外縁の Y 軸クリアランス (ピクセル、既定: 2) */
|
|
120
121
|
anchorGapY?: number;
|
|
122
|
+
/** Room around the rail the drawn labels must stay within; absent leaves both sides unbounded, so the pair always stands on labelPosition. A side holding NaN or a negative number throws RangeError / 描いたラベルが収まるべきレールの周りの余白 (未指定は両側とも無制限で、対は常に labelPosition の側に立つ。NaN・負の数の側は RangeError) */
|
|
123
|
+
room?: LabelRoom;
|
|
124
|
+
/** Scale a label is drawn at about its centre while emphasised; the room check reads it so an emphasised label fits too (default: 1, a non-positive or non-finite number throws RangeError) / 強調中のラベルが中心を基準に描かれる倍率 (余白の判定が読み、強調されたラベルも収める。既定: 1、正の有限数でなければ RangeError) */
|
|
125
|
+
drawnScale?: number;
|
|
126
|
+
/** Distance from the rail centre line to the near edge of a label once it stands on the side opposite labelPosition, in pixels (default: the clearance of its own side, knob radius + anchorGapY; a negative or non-finite number throws RangeError) / labelPosition の反対側に立ったラベルの、レール中心線から内縁までの距離 (ピクセル。既定: 自分の側の離隔 (つまみの半径 + anchorGapY)。負・有限でない数は RangeError) */
|
|
127
|
+
flipClearancePx?: number;
|
|
121
128
|
}
|
|
122
129
|
/**
|
|
123
130
|
* Placement the anti-collision solver resolved for the two handle labels.
|
|
@@ -138,6 +145,8 @@ export interface LabelSlantResult {
|
|
|
138
145
|
highOffsetY: number;
|
|
139
146
|
/** True while the labels are rotated to avoid a collision / 衝突回避のため回転中か */
|
|
140
147
|
isSlanted: boolean;
|
|
148
|
+
/** True while the pair stands on the side opposite labelPosition, because its own side lacks the room the slanted pair needs / 傾けた対に要る余白が自分の側に無いため、対が labelPosition の反対側に立っているか */
|
|
149
|
+
isFlipped: boolean;
|
|
141
150
|
/** Normalized collision proximity between 0 (apart) and 1 (coincident) / 正規化した接近度 (0: 離間、1: 完全一致) */
|
|
142
151
|
proximity: number;
|
|
143
152
|
}
|
|
@@ -181,6 +190,12 @@ export interface BasePeriodSliderProps {
|
|
|
181
190
|
labelPosition?: PeriodSliderLabelPosition;
|
|
182
191
|
/** Whether to automatically slant labels when a pair comes close, in range mode and on both vernier rails (default: true) / Range モードとノギスの両レールで、対が接近した時に自動斜め表示するか (既定: true) */
|
|
183
192
|
autoSlantLabels?: boolean;
|
|
193
|
+
/** Element whose bottom edge the slanted labels of a horizontal slider are never drawn above, besides the viewport and every ancestor that clips them; null or omitted names none, an element not in the document bounds nothing, and anything else (a ref object included) throws RangeError / 横向きのスライダーの傾けたラベルを、その下端より上へ描かない要素 (画面の端とラベルを切る祖先に加える。null・省略は無し、文書に無い要素は何も区切らず、それ以外 (ref オブジェクトを含む) は RangeError) */
|
|
194
|
+
labelCeiling?: Element | null;
|
|
195
|
+
/** Element whose top edge the slanted labels of a horizontal slider are never drawn below, besides the viewport and every ancestor that clips them; null or omitted names none, an element not in the document bounds nothing, and anything else (a ref object included) throws RangeError / 横向きのスライダーの傾けたラベルを、その上端より下へ描かない要素 (画面の端とラベルを切る祖先に加える。null・省略は無し、文書に無い要素は何も区切らず、それ以外 (ref オブジェクトを含む) は RangeError) */
|
|
196
|
+
labelFloor?: Element | null;
|
|
197
|
+
/** Draws a line from each knob to its label while the label stands on the far side of the rail for lack of room (default: false) / 余白が足りずレールの反対側に立つラベルへ、つまみから引き出し線を引くか (既定: false) */
|
|
198
|
+
showLabelLeaderLines?: boolean;
|
|
184
199
|
/** Renders the slider along the vertical axis (default: false) / 垂直方向レイアウト (既定: false) */
|
|
185
200
|
isVertical?: boolean;
|
|
186
201
|
/** Hides the connect bar drawn between the two handles (default: false) / つまみ間の接続バー非表示 (既定: false) */
|
|
@@ -991,6 +1006,13 @@ export declare const calculateConnectDragValues: ({ posDiffPct, startLowVal, sta
|
|
|
991
1006
|
* キーボード操作時の移動先数値を算出します。
|
|
992
1007
|
*/
|
|
993
1008
|
export declare const calculateKeyboardActionValues: (key: string, handle: "low" | "high", lowVal: number, highVal: number, rangeMin: number, rangeMax: number, isPointMode: boolean, step: number) => [number, number] | null;
|
|
1009
|
+
/**
|
|
1010
|
+
* Scale the stylesheet draws the label of a grabbed knob at (`--ps-tooltip-scale` under `[data-active="true"]`); the room
|
|
1011
|
+
* check reads it so the pair still fits once one of its labels is grabbed, and a unit test pins it to the stylesheet.
|
|
1012
|
+
* 掴んだつまみのラベルをスタイルシートが描く倍率 (`[data-active="true"]` の `--ps-tooltip-scale`)。
|
|
1013
|
+
* 余白の判定がこれを読むため、対のどちらかを掴んでも収まったままになる。単体テストがスタイルシートとの一致を固定する。
|
|
1014
|
+
*/
|
|
1015
|
+
export declare const LABEL_EMPHASIS_SCALE = 1.15;
|
|
994
1016
|
/**
|
|
995
1017
|
* Half extents of the bounding box of a rectangle rotated by an angle, along its unrotated width and across it.
|
|
996
1018
|
* 角度だけ回転した矩形の外接矩形の半寸法 (回転前の幅方向と、その直交方向)。
|
|
@@ -1019,12 +1041,21 @@ export declare const resolveRotatedHalfExtents: (widthPx: number, heightPx: numb
|
|
|
1019
1041
|
* 回転後の半寸法は `resolveRotatedHalfExtents` から得る。範囲領域が描かれたラベルのレールからの到達距離を求める際も同じ関数を読むため、
|
|
1020
1042
|
* 回転したラベルの寸法について配置と範囲領域が食い違わない。
|
|
1021
1043
|
*
|
|
1044
|
+
* With `config.room`, a slanted pair that does not fit on its own side stands on the other side of the rail, or, when
|
|
1045
|
+
* neither side fits, on the side with more room beyond its labels' near edge at the largest angle that fits
|
|
1046
|
+
* (`fitSlantToRoom`). On the other side the near edge stands `config.flipClearancePx` from the rail centre line. An upright
|
|
1047
|
+
* pair is never moved: the room only decides where the rotation the ramp asks for may go.
|
|
1048
|
+
* `config.room` を渡すと、自分の側に収まらない傾けた対はレールの反対側に立ち、どちらにも収まらなければ、ラベルの内縁から先の
|
|
1049
|
+
* 余白が広い側に、収まる最大の角度で立つ (`fitSlantToRoom`)。反対側では内縁がレール中心線から `config.flipClearancePx` に立つ。
|
|
1050
|
+
* 直立の対は動かさない (余白が決めるのは、ランプが求める回転の行き先だけ)。
|
|
1051
|
+
*
|
|
1022
1052
|
* @param lowPct - Percent position of lower handle (0-100) / 下限つまみの位置 (0-100%)
|
|
1023
1053
|
* @param highPct - Percent position of upper handle (0-100) / 上限つまみの位置 (0-100%)
|
|
1024
1054
|
* @param trackWidthPx - Measured pixel width of the track; a non-positive value means "not measured yet" and yields the horizontal baseline / 実測トラック幅 (0 以下は未実測とみなし水平基準値を返す)
|
|
1025
1055
|
* @param labelPosition - "top" or "bottom" / ラベル表示位置
|
|
1026
1056
|
* @param config - Geometry of the rendered label; without config.estimatedWidthPx the labels stay upright / 描画済みラベルの幾何情報 (config.estimatedWidthPx が無い場合は直立を維持)
|
|
1027
1057
|
* @returns Rotation angles and offsets guaranteeing a non-overlapping label pair / ラベルが重ならないことを保証する回転角とオフセット
|
|
1058
|
+
* @throws {RangeError} When config.room holds a side that is NaN or negative, config.drawnScale is not a positive finite number, or config.flipClearancePx is negative or not finite / config.room の側が NaN・負、config.drawnScale が正の有限数でない、または config.flipClearancePx が負・有限でない場合
|
|
1028
1059
|
*/
|
|
1029
1060
|
export declare const calculateLabelSlant: (lowPct: number, highPct: number, trackWidthPx: number, labelPosition?: PeriodSliderLabelPosition, config?: LabelSlantConfig) => LabelSlantResult;
|
|
1030
1061
|
/**
|
|
@@ -1224,9 +1255,10 @@ export type RailSide = "before" | "after";
|
|
|
1224
1255
|
* One layer of labels standing on one side of the rail, in the terms the range area needs.
|
|
1225
1256
|
* Each layer names the rule its reach follows, so a layer never carries a quantity its rule does not read: a label the
|
|
1226
1257
|
* stylesheet stands beside the rail reaches by its own inline size, a label the placement solver rotated reaches by its
|
|
1227
|
-
* rotated half-extent
|
|
1258
|
+
* rotated half-extent beyond its centre, measured from the anchor line of the side it stands on.
|
|
1228
1259
|
* レールの片側に立つラベル層を、範囲領域が必要とする量で表したもの。層は到達距離の規則を自ら名乗るため、規則が読まない量を持つことはない
|
|
1229
|
-
* (
|
|
1260
|
+
* (スタイルシートがレールの横へ置くラベルは自身のインライン方向の寸法、配置解決が回したラベルは、立つ側の基準線から測った中心の先へ
|
|
1261
|
+
* 回転後の半寸法だけ届く)。
|
|
1230
1262
|
*/
|
|
1231
1263
|
export type RailSideLabelLayer = {
|
|
1232
1264
|
/** Side of the rail the layer stands on / 層が立つレールの側 */
|
|
@@ -1241,8 +1273,8 @@ export type RailSideLabelLayer = {
|
|
|
1241
1273
|
reach: "rotated";
|
|
1242
1274
|
/** Rotation the placement solver applied, in degrees / 配置解決が与えた回転角 (度) */
|
|
1243
1275
|
angleDeg: number;
|
|
1244
|
-
/**
|
|
1245
|
-
|
|
1276
|
+
/** Distance from the anchor line of the side the label stands on to its centre, in pixels / ラベルが立つ側の基準線から、ラベルの中心までの距離 (ピクセル) */
|
|
1277
|
+
centreFromAnchorPx: number;
|
|
1246
1278
|
/** Push the solver applied along the rail, in pixels / 配置解決がレール方向へ与えた押し出し量 (ピクセル) */
|
|
1247
1279
|
alongPushPx: number;
|
|
1248
1280
|
});
|
|
@@ -1273,6 +1305,10 @@ export interface LabelReach {
|
|
|
1273
1305
|
* TypeScript から CSS へ渡すのは実測した到達距離だけ。基準線とレーンの幅はスタイルシートが持つ長さに依存するため、
|
|
1274
1306
|
* 範囲領域の組み立ては CSS が行う。
|
|
1275
1307
|
*
|
|
1308
|
+
* Two layers may stand on the same side - a vernier pair that stands across the other rail joins that rail's own labels -
|
|
1309
|
+
* and the side reaches as far as the farther of them.
|
|
1310
|
+
* 同じ側に 2 つの層が立つことがあり (反対側へ倒れたノギスの対は、もう一方のレールのラベルと同じ側に立つ)、その側は遠い方まで届く。
|
|
1311
|
+
*
|
|
1276
1312
|
* The along-rail reach is returned as a number as well as a custom property, because the two tiers that need it
|
|
1277
1313
|
* read it in different units: the stylesheet composes the drawn lane from the property, and the wheel ownership rule
|
|
1278
1314
|
* inflates the measured rectangle by the same pixels rather than growing the element (an element grown past the root
|