@aiquants/period-slider 0.19.0 → 0.20.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +175 -3
- package/README.md +23 -6
- package/dist/VirtualDateDropdown.d.ts +10 -0
- package/dist/VirtualDateDropdown.d.ts.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.js +2789 -2298
- package/dist/renderScope.d.ts +531 -0
- package/dist/renderScope.d.ts.map +1 -0
- package/dist/selectorMemo.d.ts +12 -0
- package/dist/selectorMemo.d.ts.map +1 -1
- package/dist/useCommittedRef.d.ts +64 -79
- package/dist/useCommittedRef.d.ts.map +1 -1
- package/dist/usePeriodSlider.d.ts +56 -12
- package/dist/usePeriodSlider.d.ts.map +1 -1
- package/package.json +6 -6
- package/src/VirtualDateDropdown.tsx +75 -6
- package/src/renderScope.ts +821 -0
- package/src/selectorMemo.ts +12 -0
- package/src/useCommittedRef.ts +51 -163
- package/src/usePeriodSlider.ts +331 -107
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,178 @@ 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.20.1 (2026-10-03)
|
|
8
|
+
|
|
9
|
+
4 つのフックの `duringRender(action)` は、`action` が何も記録しない描画に印を付けなくなり、そうした描画では React がホストの子の描画を省くようにしました (Props と公開 API は変わりません)。
|
|
10
|
+
**`duringRender` を呼ぶホストの描画・子の描画・`Profiler` の確定を数えるテストでは、下の「修正」の点で数が変わります。**
|
|
11
|
+
|
|
12
|
+
### 修正
|
|
13
|
+
|
|
14
|
+
- **`duringRender(action)` の `action` が何も記録しない描画では、React がホストの子の描画を省くようになりました。**
|
|
15
|
+
0.20.0 では、描画の中で最初に呼んだ `duringRender` が `action` の中身によらずその描画に印を付け、印がフック内部のステートを変えたため、
|
|
16
|
+
ステートが既に持つオブジェクトの受け渡しや、確定した受け渡しの記録が走らせる描画でも、ホストの本体がもう 1 度走って子も描き直されていました
|
|
17
|
+
(描いている日付への追従を描画のたびに呼ぶ時点フックのホストで、同じオブジェクトの `setValue` は本体 2・子 1・確定 1、目標を動かした追従は本体 4・子 2・確定 2)。
|
|
18
|
+
印は、`action` の中の返す関数がその描画で最初に何か (写しや利用側が知っている値への書き込み・受け渡し・通知) を記録したときに付けます。
|
|
19
|
+
何も記録しない描画は本体の実行も子の描画も増やしません (同じ例で本体 1・子 0・確定 1 と、本体 3・子 1・確定 2)。
|
|
20
|
+
記録した描画は 0.20.0 と同じく、印でその描画の続きに結ばれ、ほかに変化が無くても確定して記録した分を当てます (印は確定を増やしません)。
|
|
21
|
+
何も記録しない描画は React が省き得るため、その直後の同じ同期の処理 (`flushSync` や同期の `act` の直後など) で誤って `duringRender` を呼んでも、
|
|
22
|
+
`Error` にならないことがあります (検出しない誤用で対応外。0.20.0 では印がその描画を確定させたため送出していました)。ほかのコンポーネントの描画の中で
|
|
23
|
+
何も記録しない `action` を呼ぶ誤用では、React の「Cannot update a component while rendering a different component」警告も出ません。
|
|
24
|
+
|
|
25
|
+
### 変更
|
|
26
|
+
|
|
27
|
+
- **`@aiquants/virtualscroll` のピア依存の下限を 3.8.0 に上げました** (`^3.7.0` から `^3.8.0`)。本パッケージが使うのは `VirtualScroll` とラベルの表だけで、
|
|
28
|
+
3.7.1 (Pointer Capture API の無い環境で例外を出さない) と 3.8.0 (矢印を Tab の止まり先から外す選択肢は既定で従来どおり・`VirtualGrid` の横バーの変更・
|
|
29
|
+
行の平行移動を装置の画素へ揃える) を取り込んだ版で、単体テストと E2E を通しています。
|
|
30
|
+
- **公開の流れで tarball の漏洩検査を必ず通すようにしました**。`publish:patch` / `publish:minor` / `publish:major` は typecheck → ビルド → テスト → 検査 →
|
|
31
|
+
版上げ → 公開の順に、素の `pnpm publish` が起動する `prepublishOnly` はビルドの後に検査を走らせます。検出が 1 件でもあれば版上げの前に止まります。
|
|
32
|
+
|
|
33
|
+
### 文書
|
|
34
|
+
|
|
35
|
+
- 同梱の CHANGELOG の 0.10.0 の節が参照していた、tarball に含まれない設計文書への参照 2 件を、参照先が決めていた内容 (範囲領域の作り・◀▶ を描く 1 つの部品・
|
|
36
|
+
ドラッグの連続描画が公開する値を変えないこと) の記述へ置き換えました。
|
|
37
|
+
- 0.20.0 の公開の後に文書を実装へ合わせました (同じオブジェクトの受け渡しなどが走らせる描画で子の描画を省く条件、描画中の対応外の直接の呼び出しが残す受け渡しの記録の影響、欠けていた docstring)。
|
|
38
|
+
|
|
39
|
+
## 0.20.0 (2026-10-02)
|
|
40
|
+
|
|
41
|
+
4 つのフック (`usePeriodSliderRange` / `usePeriodSliderPoint` / `useVernierSliderRange` / `useVernierSliderPoint`) は `duringRender(action)` を返すようにしました。
|
|
42
|
+
ホストが自分の描画の中で `action` の中に呼んだ返す関数はその描画の中だけで働き、ステートへの受け渡しは React の描画中の更新になり、写し・受け渡しの記録・利用側が知っている値への書き込みと通知はその描画の確定で行い、React が捨てた描画は何も残しません (下の「追加」)。
|
|
43
|
+
`duringRender` の外の呼び出しは、描画中でも 0.19.0 と同じく、その場で働く事象の時点の呼び出しです (描画中の直接の呼び出しは対応外です。下の「変更」)。
|
|
44
|
+
ノギスのフックの操作は、動かさないスケールの値が返す関数の読む値とも利用側が知っている値とも等しい間、そのスケールをステートへ渡さず通知もしないようにしました (下の「変更」)。
|
|
45
|
+
4 つのフックは、ステートへ最後に渡した値の記録を、その受け渡しを持たない描画 (移行の中の受け渡しを飛ばして確定した緊急の描画など) を挟んでも保つようにしました (下の「変更」)。
|
|
46
|
+
3 セレクタのメモ比較器の費用を計測し (下の「文書」)、比較器 1 回がキーを求める回数と、比較器が候補の一覧の要素を読まないこと、キーを呼び出しをまたいで保持しないことをテストで押さえました。
|
|
47
|
+
あわせて、`DateSelector variant="dropdown"` は所有側 (隠れた `<Activity>`、フォールバックを出した `Suspense`) が隠すとポップアップを閉じ、
|
|
48
|
+
隠れている間はポップアップを画面に出さず、隠れた操作要素へ届いた入力を無視するようにしました (Props と公開 API は変わりません)。
|
|
49
|
+
**描画中に返す関数を呼ぶホスト (その呼び出しを `duringRender` で包みます)、ノギスのフックの操作の前後でホストの描画や `Profiler` の確定を数えるテスト、
|
|
50
|
+
移行の中の受け渡しを飛ばした描画の後の同じ値の確定経路の前後で `Profiler` の確定を数えるテスト、開いた `DateSelector variant="dropdown"` を `Activity` や `Suspense` で隠して表示し直すホストとテストでは、下の「変更」の点で挙動が変わります。**
|
|
51
|
+
|
|
52
|
+
### 追加
|
|
53
|
+
|
|
54
|
+
- **4 つのフックは `duringRender: (action: () => void) => void` を返します**。ホストが自分の描画の中で、フックを呼んだ後に `duringRender(action)` を呼ぶと、
|
|
55
|
+
`action` の中で同期に呼んだこのフックの返す関数 (設定関数・シフト・リセット・セレクタと `sliderProps` のコールバック・◀▶) は、その描画の中だけで働きます。
|
|
56
|
+
読む値は最後に確定した描画の値 (その後に事象の時点で書いた値と、同じ描画で先に呼んだ返す関数が渡した値があればその値) で、境界とコールバックも確定した描画のものです。
|
|
57
|
+
ステートへの受け渡しは React の描画中の更新になり、写し・受け渡しの記録・利用側が知っている値への書き込みと通知はその描画の範囲へ入り、その描画の確定が当てます。
|
|
58
|
+
範囲を続けるのは、`duringRender` を呼んだ描画の続き (描画中の更新の後の走らせ直し、`StrictMode` の 2 度目の呼び出し、中断した描画のデータが解決した後の再実行) だけです。
|
|
59
|
+
React が捨てた描画の範囲は、同じステートを持つ後の別の描画が確定しても当たらず、後の描画の `action` の書き込みと通知を消しもしません。これを見分けるため、
|
|
60
|
+
描画の中で最初に呼んだ `duringRender` はその描画に印を描画中の更新として付けます (`action` が何も渡さない描画でも、ホストの本体が同じ描画の中でもう 1 度走ります。確定は増えません。
|
|
61
|
+
子の描画は、ホストがもともと子を描く描画では増えませんが、子の描画を省くはずの描画 (ステートが既に持つオブジェクトの受け渡しや、下の記録が走らせる描画) で `duringRender` を呼ぶと、印のため子も描き直します)。
|
|
62
|
+
`action` の中でステートを変える値を渡した描画の確定は、その受け渡しを、ホストのレイアウト副作用からステートの更新の列へ同一性で守った更新関数として記録します。
|
|
63
|
+
その描画が飛ばした優先度の低い受け渡し (移行の中で渡した値) を React が後で当て直しても、保存される値は通知した値に行き着きます。記録の分、ホストの描画が 1 度走ります (その描画で `duringRender` を呼ばないホストでは子の描画を省き、呼ぶホストでは子も描き直します)。
|
|
64
|
+
通知はその描画のコールバックを呼び、ホストのレイアウト副作用で届きます (その確定で先に走る子孫のレイアウト副作用がフックへ書くか通知するときはその前、
|
|
65
|
+
隠れた `<Activity>` の中の確定ではマイクロタスク)。入れ子のホストでは子から親の順に、1 つのホストの複数のフックではフックを呼んだ順に届きます。
|
|
66
|
+
サーバー描画では確定が無いため、`action` の中の呼び出しはコールバックを呼びません。ほかのコンポーネントのステートを書くコールバックでも、
|
|
67
|
+
React の「Cannot update a component while rendering a different component」警告は出ません。
|
|
68
|
+
その描画がフックを呼んだ後に事象の時点の呼び出しが書いたステートと、描画が持たない事象の時点の受け渡し (移行が譲っている間にホストの描画より前に渡した値、
|
|
69
|
+
その描画が飛ばす優先度の移行の中で渡した値) を待つステートには、その描画の分を当てません (ノギスのフックではスケールごと。React は事象の更新を後で当て、そちらが勝ちます)。
|
|
70
|
+
`action` の中の受け渡しがまだ確定し得る間は、表示中の値へ落ち着く事象の時点の呼び出しも同じ値をステートへ渡し直し、後の操作として勝ちます。
|
|
71
|
+
渡し直しはホストの描画を 1 度走らせます (その描画でも `duringRender` を呼ぶホストでは子も描き直します。React が捨てた描画の `action` が値を渡した後も、ホストが次に描かれるまでは、最初のそうした呼び出しで同じく 1 度走ることがあります)。
|
|
72
|
+
フックの描画の範囲が閉じた後 (フックの最後の描画が確定した後と、本体を走らせた同期の処理が終わった後。副作用・イベントハンドラ・フックを呼んだ後に積んだマイクロタスクの中) に `duringRender` を呼ぶと
|
|
73
|
+
`Error` (`<フック名>: duringRender(action) must be called during the host's render, after the hook call (call the returned functions directly from event handlers and effects)`)、
|
|
74
|
+
`action` が関数でなければ `TypeError` (`<フック名>: duringRender(action) must be a function (received: ...)`) です。`action` の中でほかのフックのインスタンスの返す関数を呼ぶと、
|
|
75
|
+
そのインスタンスは何もせずに `Error` (`<フック名>: a returned function was called during another hook's duringRender(action); call it inside this hook's own duringRender(action)`) を送出します
|
|
76
|
+
(そのインスタンス自身の `duringRender` を入れ子に呼べば働きます)。`action` が送出した例外はそのまま伝わります。`duringRender` の同一性はコンポーネントの存続中ずっと変わりません。
|
|
77
|
+
ほかのコンポーネントの描画の中、フックを呼ぶ前、確定しなかった描画と同じ同期の処理の中の事象のコード、描画のコードがフックを呼ぶ前に積んだマイクロタスク
|
|
78
|
+
(先に描いたコンポーネントが積んだものを含む) での `duringRender` は検出せず (送出されないことがあります)、対応外です。
|
|
79
|
+
React が捨てた描画 (Suspense が保留した移行、取り消した移行、追い越された移行、割り込まれた描画) の中の呼び出しは何も残しません。日単位の `usePeriodSliderPoint`
|
|
80
|
+
(2024-01-01〜2024-01-31、初期値 2024-01-10) が、`duringRender` の中の `setValue` で 2024-01-20 へ追従する移行を Suspense が保留している間の例です。
|
|
81
|
+
- `shiftValue(1)` は確定した 2024-01-10 から進み、2024-01-11 を描いて通知します。3 回続けると 2024-01-11・2024-01-12・2024-01-13 をそれぞれ 1 度通知します。
|
|
82
|
+
- `setValue(2024-01-25)` の後の `shiftValue(1)` は 2024-01-26 を描きます。
|
|
83
|
+
- 2024-01-20 を渡す `selectorProps.onChange` は、親を描き直した後でも 2024-01-20 を描いて 1 度通知します。
|
|
84
|
+
- 月単位の `usePeriodSliderRange` (初期 2024-02〜2024-10) が `setRange` で 2024-04〜2024-10 へ追従する移行では、`shiftRange(1)` が 2024-03〜2024-11 を描きます。
|
|
85
|
+
ノギスのフックの `shiftMicroValue` / `shiftMicroRange` / `shiftMacroRange` も確定した値から進みます。
|
|
86
|
+
- `duringRender` の中の `selectorProps.onChange` で 2024-01-20 へ追従する移行は、Suspense が保留している間は通知せず、データの解決で確定したときに 2024-01-20 を 1 度だけ通知します。
|
|
87
|
+
確定する前に取り消した移行は通知しません。
|
|
88
|
+
- 取り消した移行の後に 2024-01-20 を渡す `selectorProps.onChange` は `onChangePoint` を 1 度呼びます (捨てた描画の中でホストが渡しただけの値は、利用側が知っている値になりません)。
|
|
89
|
+
`setValue` は通知しません。
|
|
90
|
+
|
|
91
|
+
### 変更
|
|
92
|
+
|
|
93
|
+
- **`DateSelector variant="dropdown"` は所有側が隠すとポップアップを閉じ、表示し直した操作要素は閉じています**。
|
|
94
|
+
0.19.0 は開いたまま隠して表示し直すと、同じ行を名指して開いたまま戻していました (0.19.0 の「修正」)。隠れた操作要素はフォーカスを保てず (ブラウザは次の描画更新で外す。HTML のフォーカスの修正の規則)、
|
|
95
|
+
React は表示し直してもフォーカスを戻さないため、開いたまま戻した一覧は、キーボードの届かないまま `aria-expanded="true"` を名乗っていました
|
|
96
|
+
(APG のコンボボックスは開いている間フォーカスを操作要素に保ちます。ネイティブの `<select>` も描かれなくなると一覧を閉じ、自分からは開き直しません)。
|
|
97
|
+
表示し直した後は `aria-controls` も `aria-activedescendant` も無く、アクティブ行と先頭一致入力のバッファは捨てられ、次に開くと保持値の行 (集合の外なら最も近い行) から始まります。
|
|
98
|
+
閉じる描画は、`Activity` では隠れた木の描画 (それより先に表示し直したときは表示し直す確定)、`Suspense` では表示し直す確定です。それまで隠れた操作要素は
|
|
99
|
+
`aria-expanded="true"` と `aria-controls` を持ち続けますが、指す listbox は DOM に在ります (画面には出ません。下の「修正」)。
|
|
100
|
+
jsdom の `Profiler` (境界の外に置いたもの) では、開いたポップアップを隠す確定が 2 回から 3 回に増え、表示し直す確定が 3 回から 2 回に減ります (`Activity` と `Suspense` で同じ)。
|
|
101
|
+
押下と同じ事象の中でホストが隠す場合は、押下の確定が 2 回から 3 回に、表示し直す確定が 2 回から 1 回になり、表示後は開かずに閉じています。
|
|
102
|
+
閉じたまま隠す場合と、開く・閉じる操作の確定の回数は変わりません。
|
|
103
|
+
上の回数は `StrictMode` なしのものです。`StrictMode` の中では、開いたポップアップを隠す確定が 2 回から 3 回に増え、表示し直す確定は 2 回のまま変わりません。
|
|
104
|
+
押下と同じ事象の中でホストが隠す場合は、押下の確定が `Activity` では 4 回から 5 回に、`Suspense` では 2 回から 3 回に増え、表示し直す確定が 2 回から 1 回になります。
|
|
105
|
+
|
|
106
|
+
- **描画中に `duringRender` の外で返す関数を呼ぶのは対応外です**。そうした呼び出しは 0.19.0 と同じく事象の時点の呼び出しとして、その場で写し・受け渡しの記録・利用側が知っている値を書いて通知し、
|
|
107
|
+
React が捨てた描画の中の呼び出しでも書き込みと通知を残します (受け渡しの記録も React が捨てた受け渡しを指したまま残るため、以後そのステートへの `duringRender` の受け渡しは、
|
|
108
|
+
事象の時点の呼び出しがそのステートへ値を渡すか、記録が指すオブジェクトそのものをステートが持つ描画が確定するまで、描かれても通知されません)。
|
|
109
|
+
描画中の呼び出しは `duringRender(action)` で包んでください (上の「追加」と下の「移行」)。
|
|
110
|
+
`duringRender` の外の呼び出しは、事象の処理・副作用・マイクロタスク・確定の途中 (子孫のレイアウト副作用の後始末など)・子の描画を省いたホストの描画の直後のどこで呼んでも、
|
|
111
|
+
事象の時点の呼び出しです。`duringRender` の動作の中でほかのフックのインスタンスの返す関数を呼ぶと、そのインスタンスは何もせずに `Error` を送出します (上の「追加」)。
|
|
112
|
+
- **ノギスのフックの操作は、動かさないスケールをステートへ渡しません**。片方のスケールだけを動かす確定経路 (マクロ窓は `setMacroLowerDate` / `setMacroUpperDate`・`shiftMacroRange`・
|
|
113
|
+
マクロのセレクタの `onChange` と ◀▶・`sliderProps.onChangeMacroRange`、ミクロ選択は `setMicroLowerDate` / `setMicroUpperDate` / `setMicroDate`・`shiftMicroRange` / `shiftMicroValue`・
|
|
114
|
+
ミクロのセレクタの `onChange` と ◀▶・`sliderProps` のミクロのコールバック) は、もう片方のスケールの落ち着いた値が返す関数の読む値とも利用側が知っている値とも等しい間、
|
|
115
|
+
そのスケールを渡さず、知っている値も書かず、通知もしません。渡し直すと、事象の時点の書き込みとして、そのスケールへの `duringRender` の受け渡し (移行の描画が譲っている間の追従) を置き換え、
|
|
116
|
+
追従した値を元へ戻してその通知も捨てるためです。利用側が別の値を知っているとき (収め直した値、緊急の確定が元の窓を描いた間も保留している窓の移行) は、これまでどおり描いた値を渡し直して通知し、
|
|
117
|
+
保存する値を最後に通知した値と揃えます。操作の結果もう片方のスケールも動くとき (窓の移動で置き直したミクロ選択、窓を追従させるミクロの ◀▶) と `resetVernier` は、両方のスケールを確定します。
|
|
118
|
+
動かすスケールは、返す関数の読む値 (確定したもう片方のスケール) に照らして置きます。追従した値と動かした値の両方を持つ描画でミクロ選択が窓に収まらないときは、
|
|
119
|
+
その描画が収め直しと同じくミクロ選択を置き直し (その場では通知しません)、その値は次にそれへ落ち着いた操作で通知されます。
|
|
120
|
+
そのため、マウントの後にまだ何も渡していないスケールへの同じ値の確定経路は、もう片方のスケールの操作の後でも、ホストの描画を 1 度走らせます (その描画で `duringRender` を呼ばないホストでは子の描画を省きます)。
|
|
121
|
+
例えば `useVernierSliderRange` で、ミクロだけを動かす `setMicroUpperDate` の後に窓と同じ値の `setMacroUpperDate` を呼ぶと、0.19.0 では `setMicroUpperDate` が窓も渡して記録していたため描画が走りませんでしたが、
|
|
122
|
+
この版では 1 度走り、以後のホストの描画の回数が 1 つずつ増えます (`Profiler` の確定も 1 回増えます)。
|
|
123
|
+
- **4 つのフックは、ステートへ最後に渡した値の記録を、その受け渡しを持たない描画を挟んでも保ちます**。移行の中で渡した値を飛ばして確定した緊急の描画や、
|
|
124
|
+
移行の描画が譲っている間に渡した値を持たないその移行の描画の後も、渡した値が確定すれば、その値へ落ち着く確定経路は何も渡さず、ホストは描き直されません。
|
|
125
|
+
0.19.0 はそうした描画で記録を捨てていたため、その確定経路が同じ値を渡し直し、子の描画を省くホストの描画を 1 度走らせていました。
|
|
126
|
+
値と通知は変わらず、`Profiler` の確定は 0.19.0 より 1 回少なくなります。
|
|
127
|
+
|
|
128
|
+
### 修正
|
|
129
|
+
|
|
130
|
+
- **`DateSelector variant="dropdown"` のポップアップが、所有側が隠れている間も画面に残らなくなりました**。
|
|
131
|
+
React が隠すのは境界の中の最上位のホスト要素 (インラインの `display: none !important`) だけで、`document.body` へポータルしたポップアップには届きません。
|
|
132
|
+
これまでは開いたまま隠すと、ポップアップが隠れた操作要素から切り離されて最後の位置に (スクロールとリサイズへの追従も止まったまま) 画面に残り、
|
|
133
|
+
行を押すと隠れたセレクタの `onChange` が呼ばれていました。ポップアップの根は隠す確定から同じインラインの `display: none !important` を持ち、閉じる描画で外れます。
|
|
134
|
+
押下と同じ事象の中でホストが隠した場合 (開く更新と隠す更新が同じ一括に積まれる場合) も閉じます。
|
|
135
|
+
隠れた操作要素へ届いた `ArrowDown`・`Enter`・押下は何もしません。所有側が隠すと React は操作要素の ref を外しますが、ブラウザが隠れた要素からフォーカスを外すのは次の描画更新のときで、
|
|
136
|
+
それまでの入力は隠れた操作要素へ届きます。受けると隠れた木で一覧を開き (`Activity` では配置を片付ける副作用が走らず、隠す前の配置でポップアップが画面に出る)、
|
|
137
|
+
`Enter` で `onChange` を呼び、表示し直すと開いたまま現れるため、ref の外れた操作要素への入力は捨てます。ref は確定のレイアウトの段階で付くため、画面に在る操作要素への入力は捨てません。
|
|
138
|
+
|
|
139
|
+
### 移行
|
|
140
|
+
|
|
141
|
+
- 開いた `DateSelector variant="dropdown"` を `Activity` や `Suspense` で隠して表示し直すホストとテストは、表示後に閉じた操作要素 (`aria-expanded="false"`) を期待してください。
|
|
142
|
+
一覧は利用者がもう一度開きます (パッケージは開き直す API を持ちません)。
|
|
143
|
+
- その前後で境界の外に置いた `Profiler` の確定を数えていた jsdom のテストは、開いたポップアップを隠す確定を 3 回 (これまで 2 回)、表示し直す確定を 2 回 (これまで 3 回)、
|
|
144
|
+
押下と同じ事象の中で隠す場合は押下を 3 回 (これまで 2 回)・表示し直しを 1 回 (これまで 2 回) と期待してください。閉じたまま隠す場合の回数は変わりません。
|
|
145
|
+
`StrictMode` の中で数えるテストは、開いたポップアップを隠す確定を 3 回 (これまで 2 回)、表示し直す確定を 2 回 (変わらず)、押下と同じ事象の中で隠す場合は押下を `Activity` で 5 回 (これまで 4 回)・
|
|
146
|
+
`Suspense` で 3 回 (これまで 2 回)、表示し直しを 1 回 (これまで 2 回) と期待してください。
|
|
147
|
+
|
|
148
|
+
- 描画中に返す関数を呼ぶホストは、その呼び出しを `duringRender(action)` で包んでください (`if (target !== held) { setHeld(target); point.duringRender(() => point.setValue(target)) }`)。
|
|
149
|
+
包んだ呼び出しの書き込みと通知はその描画の確定で当たり、React が捨てた描画は何も残しません。包まない描画中の呼び出しは 0.19.0 と同じくその場で働きますが、対応外です。
|
|
150
|
+
描画のたびにフック自身の値と比べて追従するときは確定経路で呼ぶか、この例のように保持した目標と比べてください (直接の設定関数は呼ぶたびに値を渡すため、
|
|
151
|
+
フックが置き直す値への追従は落ち着かず、React の「Too many re-renders」に至ります。下の「文書」)。
|
|
152
|
+
ほかのフックの返す関数は、そのフックの `duringRender` の中で呼んでください (別のフックの `action` の中では `Error` です)。
|
|
153
|
+
- 包んだ呼び出しの通知は、その描画の確定でその描画のコールバックへ届きます。描画の途中で通知を読んでいたホストとテストは、その描画の確定で届く通知を読んでください
|
|
154
|
+
(描画中に通知へ応えていた処理は確定の後に走ります)。入れ子のホストの通知を親から子の順や前の確定のコールバックで期待していたテストは、子から親の順と、その描画のコールバックを期待してください。
|
|
155
|
+
1 つのホストの複数のフックの通知は、フックを呼んだ順に届きます。
|
|
156
|
+
- 包んだ呼び出しの通知に応えてホスト自身のステートを書くホストで `Profiler` の確定を数えるテストは、確定が 1 回増えることを期待してください
|
|
157
|
+
(コールバックは確定の後に走るため、その更新は描画中の更新として同じ描画に畳まれず、同期の描画と確定をもう 1 回走らせます)。
|
|
158
|
+
- 描画中に返す関数を呼んで追従し、取り消した移行の後の同じ値の確定経路が通知しないことを期待していたテストは、呼び出しを `duringRender` で包んだうえで 1 度の通知を期待してください。
|
|
159
|
+
- ノギスのフックの操作の前後でホストの描画や `Profiler` の確定を数えるテストは、マウントの後にまだ何も渡していないスケールへ同じ値の確定経路を呼ぶと、
|
|
160
|
+
もう片方のスケールの操作の後でも 1 回増えることを期待してください (上の「変更」)。
|
|
161
|
+
- 移行の中で渡した値を飛ばした描画 (その後の緊急の描画や、移行の描画が譲っている間に渡した値を持たないその移行の描画) を挟み、その値の確定の後に同じ値の確定経路を呼ぶ前後で
|
|
162
|
+
`Profiler` の確定やホストの描画を数えるテストは、0.19.0 より 1 回少なく期待してください (4 つのフックに共通。上の「変更」)。
|
|
163
|
+
- `duringRender` で包んだ呼び出しがステートを変える値を渡した描画の確定の後には、その受け渡しの記録のため、ホストの描画と `Profiler` の確定が 1 回ずつ続きます (その描画で `duringRender` を呼ばないホストでは子の描画を省き、呼ぶホストでは子も描き直します)。
|
|
164
|
+
0.19.0 で描画中に直接呼んでいた追従を包んだホストでその前後を数えるテストは、1 回多く期待してください。`action` が何も渡さない描画では、ホストの本体が同じ描画の中で
|
|
165
|
+
もう 1 度走ります (確定は増えません)。
|
|
166
|
+
|
|
167
|
+
### 文書
|
|
168
|
+
|
|
169
|
+
- **3 セレクタのメモ比較器の費用を計測しました。** キーを検証と同じ関数 (`keyInsideDateRange`) で求める 0.19.0 の比較器は、1 回あたり 0.18.0 の約 1.0〜1.7 倍で
|
|
170
|
+
(Node 24・jsdom・`TZ=Asia/Tokyo` の計測。比較器 1 回は 1〜数 µs)、増分は 1 キーあたり約 0.1 µs です。比較器 1 回がキーを求める回数は 0.18.0 と同じで
|
|
171
|
+
(読む Date 型 Props の値 1 つにつき 1 回、高々 7 回。`DateSelector variant="split-dropdown"` は高々 14 回)、範囲の広さと
|
|
172
|
+
`allowedDates` / `allowedMonths` / `allowedYears` の要素の数には依りません。日単位の `PeriodSlider` に 3 セレクタを結んだドラッグでは、増分は親の描画 1 回の 0.1% 未満です。
|
|
173
|
+
- **0.17.0 の「変更」の「フック自身の値と比べて描画のたびに呼ぶ追従は、値が境界・候補・窓へ置き直される場合も、これまでどおり置き直した値で落ち着きます」は、確定経路に限ります。**
|
|
174
|
+
確定経路 (シフト・リセット、`setLowerDate` / `setMicroDate` などの端ごとの設定関数、セレクタと `sliderProps` のコールバック、◀▶) は、走らせ直した描画で同じ値を何も渡さずに落ち着きます。
|
|
175
|
+
直接の設定関数 (`setValue` / `setRange` / `setMacroRange` / `setMicroRange` / `setMicroValue`) は呼ぶたびに値を渡すため、フックが置き直す値へ描画のたびに比べて追従すると
|
|
176
|
+
落ち着かず、React の「Too many re-renders」に至ります (0.19.0 の描画中の直接の呼び出しでも、この版の `duringRender` の中でも同じです)。
|
|
177
|
+
そうした追従は確定経路で呼ぶか、保持した目標と比べてください (上の「移行」の例)。
|
|
178
|
+
|
|
7
179
|
## 0.19.0 (2026-10-02)
|
|
8
180
|
|
|
9
181
|
パッケージ全体が Date を時刻値のシステムのタイムゾーンで読むようにし、3 セレクタのメモ比較器と非制御の選択が、Date 型 Props の単位を検証と同じ関数 (`keyInsideDateRange`) で読むようにした版です。
|
|
@@ -1205,9 +1377,9 @@ All notable changes to `@aiquants/period-slider` are documented here.
|
|
|
1205
1377
|
|
|
1206
1378
|
## 0.10.0
|
|
1207
1379
|
|
|
1208
|
-
範囲領域 (range area) の `Shift` +
|
|
1209
|
-
|
|
1210
|
-
|
|
1380
|
+
範囲領域 (range area) の `Shift` + ホイール、ステッパーの矢印言語、ドラッグの連続描画。範囲領域はルートの箱・ラベルの帯を覆う子要素・
|
|
1381
|
+
ルートの中のポインターの標的を合わせた領域で、8 つの ◀▶ は 1 つの部品が同じ形・大きさ (当たり判定 44px の `--ps-target-size`)・配色で描きます。
|
|
1382
|
+
ドラッグの連続描画は、公開する値 (スナップ・コールバック・`debounceMs`・`aria-valuenow`) を変えない表示の層です。
|
|
1211
1383
|
|
|
1212
1384
|
### 利用側の契約が変わる点 (0.9.0 からの移行)
|
|
1213
1385
|
|
package/README.md
CHANGED
|
@@ -1448,10 +1448,10 @@ DOM 契約: ルート要素は `data-variant="date|dropdown|split-dropdown"` を
|
|
|
1448
1448
|
|
|
1449
1449
|
- 操作要素は `<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
1450
|
- 開く位置は保持値の行、保持値が集合の外にあるときは**その値に最も近い行** (同距離では早い側の日付) です。先頭行から開かないため、100 年の定義域でも戻る操作が数行で済みます。開いた行は `data-active="true"` と `aria-activedescendant` が指しますが、集合外の保持値では `aria-selected="true"` の行は 1 つもありません (アクティブ行は「これから選ぶ候補」であり、選択済みではないため)。操作要素の表示テキストと `data-out-of-range="true"` はどちらも動きません。
|
|
1451
|
-
- ポップアップは `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`
|
|
1451
|
+
- ポップアップは `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
1452
|
- ポップアップには `role="listbox"` のほかに `@aiquants/virtualscroll` のスクロールバーが同居します (`role="scrollbar"`、つまみの `role="slider"`、そして `aria-label` を持つ矢印ボタン 2 つ)。矢印ボタンは常に `disabled` でタブ順にもキーボード操作にも現れませんが、アクセシビリティツリーには残ります。その名前は `locale` のカタログの `scrollUp` / `scrollDown` (`Scroll up` / `Scroll down`、`ja` では `上へスクロール` / `下へスクロール`) で、`labels` の同じキーで上書きできます (本パッケージが内蔵 VirtualScroll へ `locale` とエンジン 7 キーを転送します)。ポップアップに絞った `getByRole("button")` はこの 2 つに当たるため、行は `role="option"` か `data-testid` で引いてください。
|
|
1453
1453
|
- キーボード: `ArrowDown` / `ArrowUp` (閉じていれば開く、開いていれば 1 行移動)、`Home` / `End` (先頭 = 最新日 / 末尾 = 最古日)、`PageDown` / `PageUp` (1 窓 = 7 行)、`Enter` (閉じていれば開く、開いていればアクティブ行を確定)、`Escape` (閉じる・発火しない)、`Tab` (閉じる)、数字と `-` / `/` / `.` (先頭一致入力。**表示書式に関わらず**先発グレゴリオ暦の `yyyy` / `yyyyMM` / `yyyyMMdd` として解釈し、走査せずに当該日へ飛ぶ。`formatOption` が非数字のテキストを返していても変わらない)。行の押下でも DOM フォーカスは操作要素から離れません。
|
|
1454
|
-
- 閉じる契機: 行の確定、`Escape`、`Tab`、操作要素からのフォーカス喪失、ポップアップ外の `pointerdown
|
|
1454
|
+
- 閉じる契機: 行の確定、`Escape`、`Tab`、操作要素からのフォーカス喪失、ポップアップ外の `pointerdown`、所有側が `<Activity mode="hidden">` で隠れたとき・`Suspense` がフォールバックを出したとき (表示し直しても閉じたまま)。
|
|
1455
1455
|
- `startTransition` で渡した境界・`allowedDates`・`formatLocale`・`formatOption` は、その描画が確定するまでポップアップに使われません。一覧の行 (スクロールで描き足す行も)・先頭一致入力・行の押下は、画面に描かれている一覧を読みます。開いたまま件数が縮み、アクティブ行が一覧の外に出るときは、件数を縮めた描画のうちに末尾の行へ移り、件数が戻っても移った行に留まります。開いている間に配置だけが変わる描画 (ページのスクロール・リサイズへの追従) は、描かれている行を描き直しません (`formatOption` を呼ぶのは新しく描く行だけです)。
|
|
1456
1456
|
- ポップアップは `.period-slider` の外に立つため、`colorScheme` の変数 (`--aqps-*`) は届きません。選択中の行のアクセント色はパッケージ既定の色です。重なり順だけは `--aqps-z-date-popup` (既定 60) で差し替えられます。
|
|
1457
1457
|
- ダークモードは `.dark` の位置に依存しません。ポップアップの祖先 (`document.body` の側) に `.dark` が無くても、**操作要素自身の位置**で解決したモードを `data-color-mode` として運ぶため、`.dark` を部分木へ限定したホストでも暗色で開きます。
|
|
@@ -1687,15 +1687,26 @@ const { sliderProps, startSelectorProps } = usePeriodSliderRange({ unit: "day",
|
|
|
1687
1687
|
- 候補と同じ単位の中の値 (月の候補 `2024-01-01` に対する `2024-01-15`) は、その候補として描かれるため渡されたまま残ります。
|
|
1688
1688
|
- 単位で定義域に入る候補は生の時刻では境界の外に居られるため (月の途中を指す `minDate` と月初の候補)、寄せた後も時刻で境界へ収めます。期間の両端が同じ候補へ寄って生の時刻で逆転するときは、上限を下限へ揃えます。利用側が `setRange` や `sliderProps.onChangeRange` へ逆転した期間を渡したときは揃えず、`RangeError` です。
|
|
1689
1689
|
- 候補の上にない `initialRange` / `initialValue` は拒まず、同じ規則でレールへ置いた値でステートを始め、最初の確定から置いた値を描きます (マウントの確定は 1 回です)。初期値を境界と照らすのはマウント時だけです。マウント時に渡した初期値だけが `resetRange` / `resetValue` の行き先になり (後から変えた `initialRange` / `initialValue` は有効性と逆転だけを検証し、採用しません)、リセットもいまの定義域へ収めて確定します。境界が初期値を越えて動いても送出せず、ステートを収め直します。
|
|
1690
|
-
- 収め直しは描画が描き、ステートへの記録はその描画の確定 (レイアウト副作用) で行います。記録するのは画面に出た確定が描いた値だけです。収め直す更新は、同じ値を描く 2 回目の確定を伴います。ノギスのフック (`useVernierSliderRange` / `useVernierSliderPoint`)
|
|
1691
|
-
- `onChangeRange` / `onChangePoint` は、確定した値が**利用側の知っている値** (渡した初期値・`setRange` / `setValue` で自分で書いた値・最後に通知した値)
|
|
1690
|
+
- 収め直しは描画が描き、ステートへの記録はその描画の確定 (レイアウト副作用) で行います。記録するのは画面に出た確定が描いた値だけです。収め直す更新は、同じ値を描く 2 回目の確定を伴います。ノギスのフック (`useVernierSliderRange` / `useVernierSliderPoint`) のマクロ窓とミクロ選択の収め直し (片方のスケールへの追従ともう片方の操作の両方を持つ描画で、ミクロ選択が窓に収まらないときを含む。下の「ノギスの操作は、動かすスケールだけをステートへ渡します」) も同じで、ノギスのフックは離散のミクロレールに載らない初期値を最初の確定で記録するため、そのマウントは確定が 2 回になります。隠れた `<Activity>` の中の確定は記録せず、表示したときにその描画の Props で記録します (隠れている間に境界を狭めて戻したフックは、畳む前の値を描きます)。
|
|
1691
|
+
- `onChangeRange` / `onChangePoint` は、確定した値が**利用側の知っている値** (渡した初期値・`setRange` / `setValue` で自分で書いた値・最後に通知した値) と異なるときに鳴ります。`duringRender` の中で呼んだ返す関数が書いた値と通知した値は、その描画が確定したときに知っている値になります (React が捨てた描画の中で渡しただけの値は、知っている値になりません)。ノギスの通知 (`onChangeMacroRange` / `onChangeMicroRange` / `onChangeMicroPoint`。知っている値は `setMacroRange` / `setMicroRange` / `setMicroValue` で書いた値も含む) も同じ規則です。収め直しはその場では通知しませんが、次にその値へ落ち着いた操作で通知されます (マウントで寄せた初期値も同じ)。反対に、収め直しの後で利用側の知っている値へ戻る操作は鳴りません。現在の値はコールバックではなく、フックの `range` / `value` で読めます。
|
|
1692
1692
|
|
|
1693
1693
|
**フックの返す関数は、画面に描かれている描画 (最後に確定した描画) の値を読みます**。4 つのフックの設定関数・シフト・リセット・`sliderProps` のコールバック・セレクタの ◀▶ は、最後に確定した描画の境界・候補・コールバック・ステートを読みます。
|
|
1694
1694
|
|
|
1695
1695
|
- `startTransition` で渡した新しいオプションは、その描画が確定するまで使われません。確定していない描画が渡したコールバックは呼ばれません。関数の同一性は変わりません。
|
|
1696
1696
|
- 子孫のレイアウト副作用から呼んでも、隠れた `Activity` の中でも、その確定の値を読みます。
|
|
1697
|
-
- 確定経路は、返す関数が最後にステートへ渡した値と同じ値を、それがステートの最後の更新だと分かっている間は渡さず、それ以外は同じ値でもステートへ渡します。そのため `startTransition` の中で呼んだ設定関数が中断している間に別の操作をしても、保存される値は最後に通知した値 (または `setRange` などで書いた値) と一致します。その間に境界・候補・窓が動いて確定済みの値を収め直しても、収め直しの記録は中断している値を上書きしません。中断している値と同じ値を緊急に呼び直しても、その間にホストが描き直されていなければその値を緊急の優先度へ引き上げず (代替表示を出さず)、更新の後に同じ値で呼び直してもホストは描き直されません。確定経路がステートと同じオブジェクトを渡すときと、設定関数へステートが持つオブジェクトそのものを渡したとき (呼び出しごと)
|
|
1698
|
-
-
|
|
1697
|
+
- 確定経路は、返す関数が最後にステートへ渡した値と同じ値を、それがステートの最後の更新だと分かっている間は渡さず、それ以外は同じ値でもステートへ渡します。そのため `startTransition` の中で呼んだ設定関数が中断している間に別の操作をしても、保存される値は最後に通知した値 (または `setRange` などで書いた値) と一致します。その間に境界・候補・窓が動いて確定済みの値を収め直しても、収め直しの記録は中断している値を上書きしません。中断している値と同じ値を緊急に呼び直しても、その間にホストが描き直されていなければその値を緊急の優先度へ引き上げず (代替表示を出さず)、更新の後に同じ値で呼び直してもホストは描き直されません。確定経路がステートと同じオブジェクトを渡すときと、設定関数へステートが持つオブジェクトそのものを渡したとき (呼び出しごと) は、ホストの描画が 1 度走ります (その描画の `duringRender` の `action` が何かを記録しない限り、子を描き直しません。下の `duringRender` の印)。
|
|
1698
|
+
- ホストの描画の中で返す関数を呼ぶときは、`duringRender(action)` の `action` の中で呼びます。`action` の中で同期に呼んだこのフックの返す関数は、その描画の中だけで働きます。読む値は最後に確定した描画の値 (その後に事象の時点で書いた値と、同じ描画で先に呼んだ返す関数が渡した値があればその値) で、境界も前の確定のもので収めます (同じ描画で広げた `maxDate` ではなく、前の確定の `maxDate`)。ステートへの受け渡しは React の描画中の更新になり、写し・受け渡しの記録・利用側が知っている値への書き込みと通知は、その描画が確定したときに行います。React が捨てた描画 (Suspense が保留した移行、取り消した移行) は何も残しません。フックがその描画の分を続けるのは、`duringRender` を呼んだ描画の続き (描画中の更新の後の走らせ直し、`StrictMode` の 2 度目の呼び出し、中断した描画のデータが解決した後の再実行) だけで、React が捨てた描画の分は、同じ値を持つ後の別の描画が確定しても当たらず (通知も届かず)、後の描画の `action` の書き込みと通知を消しもしません。これを見分けるため、`action` の中の返す関数がその描画で最初に何か (写しや利用側が知っている値への書き込み・受け渡し・通知) を記録したとき、フックはその描画に印を描画中の更新として付けます。印はその描画のフックのステートを変えるため、印を付けた描画では React が子の描画を省かず、ホストの本体は同じ描画の中でもう 1 度走ります (`action` が値を渡すときは、その受け渡しを当てる走らせ直しと同じ 1 度です。確定は増えません)。`action` が何も記録しない描画には印を付けないため、本体の実行は増えず、ほかに変化が無ければ React は子の描画を省きます (ステートと同じオブジェクトの受け渡しや下の記録が走らせる描画で、描画のたびに呼ぶ追従が既に落ち着いている場合など)。その描画に入らない事象の書き込み (描画がフックを呼んだ後の書き込みと、描画が持たない保留中の受け渡し: 移行が譲っている間にホストの描画より前に渡した値や、その描画が飛ばす優先度の移行の中で渡した値) があるステートには描画の分を当てず、事象の書き込みが後から当たります (ノギスのフックではスケールごと)。`action` の中の受け渡しがまだ確定し得る間は、表示中の値へ落ち着く事象の時点の呼び出しも同じ値をステートへ渡し直し、後の操作として勝ちます (渡し直しはホストの描画を 1 度走らせ、その描画の `action` が何かを記録しない限り子の描画を省きます。React が捨てた描画の `action` が値を渡した後も、ホストが次に描かれるまでは、最初のそうした呼び出しで同じく 1 度走ることがあります)。`action` の中でステートを変える値を渡した描画の確定の後は、その受け渡しをステートの更新の列へ記録するため、ホストの描画が 1 度走ります (その描画が飛ばした優先度の低い受け渡しを React が後で当て直しても、保存される値が通知した値に行き着くようにするため。その描画の `action` が何かを記録しない限り子の描画を省きます。受け渡した値で落ち着いた追従は、その描画で何も記録しません)。フック自身の値と比べて描画のたびに呼ぶ追従は、確定経路 (シフト・リセット、`setLowerDate` / `setMicroDate` などの端ごとの設定関数、セレクタと `sliderProps` のコールバック、◀▶) で呼べば、値が境界・候補・窓へ置き直される場合も置き直した値で落ち着きます (走らせ直した描画の同じ値の確定経路は何も渡しません)。直接の設定関数 (`setValue` / `setRange` / `setMacroRange` / `setMicroRange` / `setMicroValue`) は呼ぶたびに値を渡すため、フックが置き直す値へ描画のたびに比べて追従すると落ち着かず、React の「Too many re-renders」に至ります。設定関数で追従するときは、下の例のように保持した目標と比べます (`if (target !== held)`)。同じ描画の値で収めるには、副作用 (`useEffect` / `useLayoutEffect`) かイベントハンドラの中で呼んでください。設定関数 (`setValue` など) へ渡した値は、同じオブジェクトでもその確定が描きます。
|
|
1699
|
+
- `duringRender` は、フックを呼んだホスト自身の描画の中で、フックを呼んだ後に呼びます。フックの描画の範囲が閉じた後、つまりフックの最後の描画が確定した後 (確定した描画から控えた戻り値をフックの呼び出しより前に使う場合を含む) と、本体を走らせた同期の処理が終わった後 (副作用・イベントハンドラ・フックを呼んだ後に積んだマイクロタスク) に呼ぶと、フック名を名乗る `Error` (`usePeriodSliderPoint: duringRender(action) must be called during the host's render, after the hook call (...)`) です。`action` が関数でなければ `TypeError` (`usePeriodSliderPoint: duringRender(action) must be a function (received: ...)`) です。`action` の中でほかのフックのインスタンスの返す関数を呼ぶと、そのインスタンスが何もせずに自分の名前を名乗る `Error` (`... a returned function was called during another hook's duringRender(action); ...`) を送出します (そのインスタンスの `duringRender` を入れ子に呼び、その中で呼びます)。`action` が送出した例外はそのまま伝わり、`duringRender` の同一性はコンポーネントの存続中ずっと変わりません。ほかのコンポーネントの描画の中、フックを呼ぶ前、確定しなかった描画 (`action` が何も記録せず、React がホストを省いた描画を含む) と同じ同期の処理の中の事象のコード (`flushSync` や同期の `act` の直後など)、描画のコードがフックを呼ぶ前に積んだマイクロタスク (先に描いたコンポーネントが積んだものを含む) で `duringRender` を呼ぶのも対応外です (送出されないことがあります)。
|
|
1700
|
+
- `duringRender` の外の呼び出しは、どこで呼んでも (事象の処理・副作用・マイクロタスク・確定の途中 (子孫のレイアウト副作用の後始末など)・描画中) 事象の時点の呼び出しで、その場で書き、待っている通知を届けてから通知します。ただし、ほかのフックのインスタンスの `action` の中の呼び出しは事象の時点の呼び出しではなく、何もせずに `Error` を送出します (上の項目)。描画中に `duringRender` の外で呼ぶのは対応外です (React が捨てた描画の中でも書き込みと通知が残ります。受け渡しの記録も React が捨てた受け渡しを指したまま残るため、以後そのステートへの `duringRender` の中の受け渡しは、描かれても通知されず、利用側が知っている値にもなりません。事象の時点の呼び出しがそのステートへ値を渡すか、記録が指すオブジェクトそのものをステートが持つ描画が確定するまで続きます)。`action` の中の呼び出しの通知は、その描画のコールバックへホストのレイアウト副作用で届き (その確定で先に走る子孫のレイアウト副作用がフックへ書くか通知するときはその前、隠れた `Activity` の中の確定ではマイクロタスク)、入れ子のホストでは子から親、1 つのホストの複数のフックではフックを呼んだ順に届きます。通知に応えてホスト自身のステートを書くコールバックは確定の後に走るため、その更新は同期の描画と確定をもう 1 回走らせます。サーバー描画では確定が無いため、`action` の中の呼び出しはコールバックを呼びません。
|
|
1701
|
+
|
|
1702
|
+
```tsx
|
|
1703
|
+
const point = usePeriodSliderPoint({ unit: "day", minDate, maxDate, initialValue })
|
|
1704
|
+
const [held, setHeld] = useState(target)
|
|
1705
|
+
if (target !== held) {
|
|
1706
|
+
setHeld(target)
|
|
1707
|
+
point.duringRender(() => point.setValue(target)) // 描画中の呼び出しは duringRender で包む
|
|
1708
|
+
}
|
|
1709
|
+
```
|
|
1699
1710
|
|
|
1700
1711
|
#### `usePeriodSliderRange(options)`
|
|
1701
1712
|
|
|
@@ -1723,6 +1734,7 @@ const { sliderProps, startSelectorProps } = usePeriodSliderRange({ unit: "day",
|
|
|
1723
1734
|
| `startSelectorProps` | `SelectorProps` | 開始側セレクタ用 Props (`maxDate` は現在の上限日付) |
|
|
1724
1735
|
| `endSelectorProps` | `SelectorProps` | 終了側セレクタ用 Props (`minDate` は現在の下限日付) |
|
|
1725
1736
|
| `sliderProps` | `PeriodSliderRangeProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
1737
|
+
| `duringRender` | `(action: () => void) => void` | ホストの描画の中で返す関数を呼ぶための関数。`action` の中で同期に呼んだ返す関数はその描画の中だけで働き、書き込みと通知はその確定で当たる (上の「共通: `SelectorProps`」)。ホスト自身の描画の中、フックを呼んだ後で呼ぶ (フックの最後の描画が確定した後と、本体を走らせた同期の処理が終わった後は `Error`、関数でない `action` は `TypeError`。検出しない誤用は上の「共通: `SelectorProps`」)。同一性はコンポーネントの存続中ずっと変わらない |
|
|
1726
1738
|
|
|
1727
1739
|
#### `usePeriodSliderPoint(options)`
|
|
1728
1740
|
|
|
@@ -1744,9 +1756,12 @@ const { sliderProps, startSelectorProps } = usePeriodSliderRange({ unit: "day",
|
|
|
1744
1756
|
| `resetValue` | `() => void` | `initialValue` へ復帰 (いまの定義域へ収め、離散レールでは最近傍の候補へ寄せた日付) |
|
|
1745
1757
|
| `selectorProps` | `SelectorProps` | セレクタ用 Props |
|
|
1746
1758
|
| `sliderProps` | `PeriodSliderPointProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props |
|
|
1759
|
+
| `duringRender` | `(action: () => void) => void` | ホストの描画の中で返す関数を呼ぶための関数。`action` の中で同期に呼んだ返す関数はその描画の中だけで働き、書き込みと通知はその確定で当たる (上の「共通: `SelectorProps`」)。ホスト自身の描画の中、フックを呼んだ後で呼ぶ (フックの最後の描画が確定した後と、本体を走らせた同期の処理が終わった後は `Error`、関数でない `action` は `TypeError`。検出しない誤用は上の「共通: `SelectorProps`」)。同一性はコンポーネントの存続中ずっと変わらない |
|
|
1747
1760
|
|
|
1748
1761
|
#### `useVernierSliderRange(options)`
|
|
1749
1762
|
|
|
1763
|
+
**ノギスの操作は、動かすスケールだけをステートへ渡します** (`useVernierSliderRange` / `useVernierSliderPoint` に共通)。片方のスケールだけを動かす確定経路 (マクロ窓は `setMacroLowerDate` / `setMacroUpperDate`・`shiftMacroRange`・マクロのセレクタの `onChange` と ◀▶・`sliderProps.onChangeMacroRange`、ミクロ選択は `setMicroLowerDate` / `setMicroUpperDate` / `setMicroDate`・`shiftMicroRange` / `shiftMicroValue`・ミクロのセレクタの `onChange` と ◀▶・`sliderProps` のミクロのコールバック) は、もう片方のスケールの落ち着いた値が返す関数の読む値とも利用側が知っている値とも等しい間、そのスケールを渡さず通知もしません。そのため、`duringRender` で一方のスケールへ追従する移行の描画が譲っている間にもう一方だけを動かしても、追従した値はその確定で描かれて通知されます。利用側が別の値を知っているとき (収め直した値、緊急の確定が元の窓を描いた間も保留している窓の移行) は、操作が描いている値を渡し直して通知し、保存する値を最後に通知した値と揃えます。操作の結果もう片方のスケールも動くとき (窓の移動で置き直したミクロ選択、窓を追従させるミクロの ◀▶) と `resetVernier` は、両方のスケールを確定します。動かすスケールは、返す関数の読む値 (確定したもう片方のスケール) に照らして置きます。追従した値と動かした値の両方を持つ描画でミクロ選択が窓に収まらないときは、その描画が収め直しと同じくミクロ選択を置き直し (その場では通知しません)、その値は次にそれへ落ち着いた操作で通知されます。直接の更新関数 (`setMacroRange` / `setMicroRange` / `setMicroValue`) は自分のスケールだけを渡します。もう片方の操作はそのスケールを渡さないため、マウントの後にまだ何も渡していないスケールへ同じ値の確定経路を初めて呼ぶと、ホストの描画が 1 度走ります (上の「共通: `SelectorProps`」の同じ値の受け渡しと同じく、その描画の `duringRender` の `action` が何かを記録しない限り子を描き直しません)。
|
|
1764
|
+
|
|
1750
1765
|
| オプション | 型 | 既定値 | 説明 |
|
|
1751
1766
|
| :--- | :--- | :--- | :--- |
|
|
1752
1767
|
| `unit` | `PeriodSliderUnit` | (必須) | 基本時間解像度単位。`"year"` / `"month"` / `"day"` 以外 (`null` を含む) は `RangeError` |
|
|
@@ -1781,6 +1796,7 @@ const { sliderProps, startSelectorProps } = usePeriodSliderRange({ unit: "day",
|
|
|
1781
1796
|
| `microStartSelectorProps` | `SelectorProps` | ミクロ開始日セレクタ用 Props |
|
|
1782
1797
|
| `microEndSelectorProps` | `SelectorProps` | ミクロ終了日セレクタ用 Props |
|
|
1783
1798
|
| `sliderProps` | `PeriodSliderVernierRangeProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props。本体がマクロ窓を動かしたとき (つまみ・`macro-connect`・ホイール・キーボード)、フックは窓だけを記録し、ミクロ選択は本体が操作ごとの規則で置き直して 1 度だけ通知した値になります (つまみ 1 本は縁で切り落とし、ホイールとキーボードは窓ごと運び、`macro-connect` は暦の差分だけ平行移動してから運ぶ)。包含は本体と同じくミクロ単位で判定するため、窓の端の単位の途中にある値 (12 月で終わる窓の 12 月 15 日) は書き換えません。利用側がまだ知らないミクロ選択 (初期値の寄せ・収め直しの結果) は、新しい窓のレールに載ったままのときだけ窓と一緒に通知します (窓の外の古い値を先に鳴らさない)。コールバックを直接呼んで Invalid Date を渡すと、`sliderProps.onChangeMicroRange(upper)` のように引数名を名乗る `RangeError` |
|
|
1799
|
+
| `duringRender` | `(action: () => void) => void` | ホストの描画の中で返す関数を呼ぶための関数。`action` の中で同期に呼んだ返す関数はその描画の中だけで働き、書き込みと通知はその確定で当たる (上の「共通: `SelectorProps`」)。ホスト自身の描画の中、フックを呼んだ後で呼ぶ (フックの最後の描画が確定した後と、本体を走らせた同期の処理が終わった後は `Error`、関数でない `action` は `TypeError`。検出しない誤用は上の「共通: `SelectorProps`」)。同一性はコンポーネントの存続中ずっと変わらない |
|
|
1784
1800
|
|
|
1785
1801
|
#### `useVernierSliderPoint(options)`
|
|
1786
1802
|
|
|
@@ -1818,6 +1834,7 @@ const { sliderProps, startSelectorProps } = usePeriodSliderRange({ unit: "day",
|
|
|
1818
1834
|
| `macroEndSelectorProps` | `SelectorProps` | マクロ終了日セレクタ用 Props |
|
|
1819
1835
|
| `microSelectorProps` | `SelectorProps` | ミクロ時点セレクタ用 Props (`maxDate` は実効マクロ窓終端。`onChange` は `setMicroDate` そのもので、Invalid Date を関数名で拒む) |
|
|
1820
1836
|
| `sliderProps` | `PeriodSliderVernierPointProps` | `<PeriodSlider {...sliderProps} />` へ渡す Props。本体がマクロ窓を動かしたとき、フックは窓だけを記録し、時点は本体が操作ごとの規則 (`macro-connect` では暦の差分だけ平行移動) で置き直して 1 度だけ通知した値になります。窓の端の単位の途中にある時点は書き換えません。利用側がまだ知らない時点は、新しい窓のレールに載ったままのときだけ窓と一緒に通知します。コールバックを直接呼んで Invalid Date を渡すと、引数名を名乗る `RangeError` |
|
|
1837
|
+
| `duringRender` | `(action: () => void) => void` | ホストの描画の中で返す関数を呼ぶための関数。`action` の中で同期に呼んだ返す関数はその描画の中だけで働き、書き込みと通知はその確定で当たる (上の「共通: `SelectorProps`」)。ホスト自身の描画の中、フックを呼んだ後で呼ぶ (フックの最後の描画が確定した後と、本体を走らせた同期の処理が終わった後は `Error`、関数でない `action` は `TypeError`。検出しない誤用は上の「共通: `SelectorProps`」)。同一性はコンポーネントの存続中ずっと変わらない |
|
|
1821
1838
|
|
|
1822
1839
|
## ライセンス
|
|
1823
1840
|
|
|
@@ -181,6 +181,16 @@ export declare const resolvePopupGeometry: (anchor: {
|
|
|
181
181
|
* (その描画がステートを読んだ後に積まれた移動は上書きしない)。操作要素の 2 つの IDREF は DOM に在る要素だけを指す。`aria-controls` は
|
|
182
182
|
* ポップアップを描くのと同じ条件で listbox を名乗り、`aria-activedescendant` は Props ではなく、アクティブ行の ref が行を付けた確定で書き、
|
|
183
183
|
* 書いた操作要素を持つ後始末が行を外す確定 (Activity・Suspense による退避を含む) で消す。
|
|
184
|
+
*
|
|
185
|
+
* Hiding the owner (a hidden Activity, or Suspense showing its fallback) closes the popup. React hides only the top-most host
|
|
186
|
+
* nodes of the hidden boundary and never reaches a portal below one, so the popup root's ref cleanup, which React runs in the
|
|
187
|
+
* hide commit, takes the root off screen with the same inline `display: none !important`, and the cleanup of a layout effect
|
|
188
|
+
* React runs on hide calls the close path while the open flag is set. open and close write that flag when they are called and
|
|
189
|
+
* every commit copies it, so an open queued in the same batch as the hide is closed too. The reveal shows a closed combobox.
|
|
190
|
+
* 所有側が隠れると (隠れた Activity、フォールバックを出した Suspense) ポップアップは閉じる。React が隠すのは境界の中の最上位のホスト要素だけで
|
|
191
|
+
* その下のポータルへは届かないため、隠す確定で React が走らせるポップアップの根の ref の後始末が同じインラインの `display: none !important` で
|
|
192
|
+
* 根を画面から外し、隠すときに React が走らせるレイアウト副作用の後始末が、開いている旗が立っていれば閉じる経路を呼ぶ。旗は open と close が
|
|
193
|
+
* 呼ばれた時点で書き、確定のたびに写すため、隠す更新と同じ一括で積まれた開く更新も閉じる。表示し直した操作要素は閉じている。
|
|
184
194
|
*/
|
|
185
195
|
export declare const VirtualDateDropdown: React.FC<VirtualDateDropdownProps>;
|
|
186
196
|
//# sourceMappingURL=VirtualDateDropdown.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"VirtualDateDropdown.d.ts","sourceRoot":"","sources":["../src/VirtualDateDropdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAoB,MAAM,UAAU,CAAA;AAG7F,4GAA4G;AAC5G,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAQxC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AA4BnC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAA;IACxB,mKAAmK;IACnK,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB,0HAA0H;IAC1H,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,6JAA6J;IAC7J,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACtC;;;OAGG;IACH,MAAM,EAAE,kBAAkB,CAAA;IAC1B,yEAAyE;IACzE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,QAAQ,gBAAgB,KAAG,MAwBhF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,cAKnD,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,MAAM,EAAE,gBAAgB,MAAM,EAAE,eAAe,MAAM,KAAG,aAUjL,CAAA;AAYD
|
|
1
|
+
{"version":3,"file":"VirtualDateDropdown.d.ts","sourceRoot":"","sources":["../src/VirtualDateDropdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAoB,MAAM,UAAU,CAAA;AAG7F,4GAA4G;AAC5G,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAQxC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AA4BnC;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAA;IACxB,mKAAmK;IACnK,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB,0HAA0H;IAC1H,YAAY,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,6JAA6J;IAC7J,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACtC;;;OAGG;IACH,MAAM,EAAE,kBAAkB,CAAA;IAC1B,yEAAyE;IACzE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAiBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,QAAQ,gBAAgB,KAAG,MAwBhF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,cAKnD,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,MAAM,EAAE,gBAAgB,MAAM,EAAE,eAAe,MAAM,KAAG,aAUjL,CAAA;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAialE,CAAA"}
|