@aiquants/period-slider 0.2.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/LICENSE +21 -0
- package/README.md +389 -0
- package/dist/DateSelector.d.ts +45 -0
- package/dist/DateSelector.d.ts.map +1 -0
- package/dist/MonthSelector.d.ts +43 -0
- package/dist/MonthSelector.d.ts.map +1 -0
- package/dist/PeriodSlider.d.ts +384 -0
- package/dist/PeriodSlider.d.ts.map +1 -0
- package/dist/YearSelector.d.ts +36 -0
- package/dist/YearSelector.d.ts.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +1770 -0
- package/dist/period-slider.css +1 -0
- package/dist/styles/period-slider.css +2 -0
- package/dist/styles/period-slider.standalone.css +3 -0
- package/dist/usePeriodSlider.d.ts +213 -0
- package/dist/usePeriodSlider.d.ts.map +1 -0
- package/package.json +98 -0
- package/src/DateSelector.tsx +414 -0
- package/src/MonthSelector.tsx +303 -0
- package/src/PeriodSlider.tsx +2557 -0
- package/src/YearSelector.tsx +168 -0
- package/src/index.ts +67 -0
- package/src/styles/components.entry.css +10 -0
- package/src/styles/period-slider.css +910 -0
- package/src/styles/standalone.entry.css +10 -0
- package/src/usePeriodSlider.ts +692 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 fehde-k
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,389 @@
|
|
|
1
|
+
<!-- markdownlint-disable MD013 -->
|
|
2
|
+
# @aiquants/period-slider
|
|
3
|
+
|
|
4
|
+
時系列分析・期間指定 UI のための React スライダーおよび日付セレクタコンポーネントライブラリ。
|
|
5
|
+
|
|
6
|
+
## 概要
|
|
7
|
+
|
|
8
|
+
`@aiquants/period-slider` は、年・月・日単位での期間範囲選択 (Range) および単一時点選択 (Point) に対応した `PeriodSlider`、および会計年・年月・年月日のステッパー付き入力コンポーネント (`YearSelector`, `MonthSelector`, `DateSelector`) を提供します。
|
|
9
|
+
|
|
10
|
+
外部依存ライブラリ (nouislider 等) を排した純粋な React / SVG 実装であり、滑らかなドラッグ操作、数学的幾何計算による近接ラベルの重なり防止自動斜めエフェクト、上限/下限交差時のアクティブハイライト自動追従、および WAI-ARIA に準拠したキーボードアクセシビリティを備えています。
|
|
11
|
+
|
|
12
|
+
## 特徴
|
|
13
|
+
|
|
14
|
+
- **柔軟な時間単位**: `year`, `month`, `day` の 3 つの単位をサポート。
|
|
15
|
+
- **3 つの操作モード**:
|
|
16
|
+
- `range`: 開始時期と終了時期の 2 つのつまみと連結バーで範囲を選択。
|
|
17
|
+
- `point`: 単一のつまみで時点を選択。
|
|
18
|
+
- `vernier`: ノギス(Vernier Caliper)型 2 段スケール一体型モード。全体期間からマクロ表示窓を上側で指定し、その拡大スケールを下側で精密選択。上下反転、台形プロジェクション光、アダプティブ目盛線、精密ヘアライン針を完備。
|
|
19
|
+
- **半円直径(±8px)完全充填幾何配置**: 半円ノブ底面(16px)を完全に満たす一体型選択ゲージ。
|
|
20
|
+
- **上下段つまみ交差反転スワップ (Crossover)**: マクロ・ミクロ双方で上限下限の追い越し反転をサポート。
|
|
21
|
+
- **弾性復元 (Push-and-Restore)**: マクロ縮小時の一時クランプ後、拡大時に記憶された初期ミクロ選択範囲へ自動復元。
|
|
22
|
+
- **マクロ・ミクロ完全独立設定**: マクロ(年)× ミクロ(日)やマクロ(年)× ミクロ(月)などの異単位構成、個別離散スナップ、個別カスタムフォーマッタに対応。
|
|
23
|
+
- **中央 1 px スリット空隙**: 上段 3.5 px、中央空隙 1.0 px、下段 3.5 px(`calc(50% - 0.5px)`)の独立レール設計による高い視認性と数学的均等分割。
|
|
24
|
+
- **SVG ベクター幾何学半円ドーム (`VernierKnobSvg`)**: 数学的真円弧コマンド(`shapeRendering="geometricPrecision"`)による、環境非依存で一切のガタつき・階段状ジャギーのない滑らかな真円弧。
|
|
25
|
+
- **上下反転時のセマンティック配色直交分離**: 配置位置(`data-vernier-pos`)と配色(`data-handle-type`)を CSS セレクタレベルで直交分離し、反転時もマクロ針・ノブグロー・目盛線・台形プロジェクション光が完璧に追従。
|
|
26
|
+
- **トラック厚み 8px 偶数設計**: サブピクセル滲みを完全に解消し、上下対称の半円つまみ配置と 3.5px+1.0px+3.5px マクロ・ミクロ塗り分けを実現。
|
|
27
|
+
- **離散日付対応 (`allowedDates`)**: 実データが存在する日付のみをスナップ対象にする離散モードを内蔵。
|
|
28
|
+
- **ラベル配置と重なり防止自動傾斜**:
|
|
29
|
+
- `labelPosition`: 上側 (`"top"`, 既定) または下側 (`"bottom"`) のラベル表示位置を選択可能。
|
|
30
|
+
- `preventCollisionSlant`: 2 つのラベルが近接した際に Smootherstep 補間により 0° 〜 90° に滑らかに自動傾斜し、テキストの重なりを数学的に完全防止。回転時もラベル下端がトラック中心から常に 10px(つまみ上端から 2px)の統一された高さを維持。
|
|
31
|
+
- 操作中(ドラッグ中)のラベル・つまみを前面 (`z-index`) に強調表示。
|
|
32
|
+
- **上限/下限交差 (クロスオーバー) の動的ハイライト追従**:
|
|
33
|
+
- レンジドラッグ中につまみが相手側アンカーを超えて上限と下限が入れ替わった際、現在ポインターで操作している側のつまみへアクティブ状態 (`[data-active="true"]`、スケール縮小+ブルーグロー・波紋) がリアルタイムに自動スワップ。
|
|
34
|
+
- **充実した日付セレクタ**:
|
|
35
|
+
- `YearSelector`: ドロップダウンと ◀▶ ステッパーで年を選択。
|
|
36
|
+
- `MonthSelector`: カレンダー入力 / ドロップダウン対応の月セレクタ。
|
|
37
|
+
- `DateSelector`: 単一セレクトボックス (`variant="dropdown"`)、日付入力 (`variant="date"`)、年月日の 3 分割セレクト (`variant="split-dropdown"`) に対応。
|
|
38
|
+
- **カラーテーマ・メリハリ対比 & ダークモード**:
|
|
39
|
+
- `colorScheme`: 6 系統のカラーパレット(`"blue-rose"` [既定], `"indigo-amber"`, `"teal-emerald"`, `"violet-fuchsia"`, `"slate-sky"`, `"monochrome"`)をサポート。
|
|
40
|
+
- ノギス 2 段スケールにおける広域マクロ(青系)と確定ミクロ(赤系)の明確なメリハリ対比、および境界を結ぶ台形プロジェクション光の動的 2 色グラデーション。
|
|
41
|
+
- トラック、ノブ、目盛線、ツールチップ、セレクタ群(`YearSelector`, `MonthSelector`, `DateSelector`)を含む Tailwind `.dark` クラスによるダークモード完全対応。
|
|
42
|
+
- **垂直レイアウト対応 (`isVertical`)**:
|
|
43
|
+
- `isVertical={true}` によりダッシュボードのサイドバーや狭小パネルに最適な垂直指向スライダーを提供。
|
|
44
|
+
- つまみ左側から厳密に 8.00px の数学的クリアランスでツールチップラベルを配置。
|
|
45
|
+
- **数学的 8.00px 均一クリアランス & ノギスツールチップ色分け**:
|
|
46
|
+
- 垂直スライダーおよびノギス(Vernier)モードにおいて、つまみ端面からラベルまでの距離を厳密に 8.00px に統一。
|
|
47
|
+
- ノギスモードではマクロツールチップ(`--aqps-macro-color`)とミクロツールチップ(`--aqps-micro-color`)がセマンティックに色分けされ、上下段の対応関係が一目で判別可能。
|
|
48
|
+
- **高いアクセシビリティ**: WAI-ARIA `slider` ロール、キーボード操作 (矢印キー, PageUp/Down, Home/End) 完全準拠(Vernier ノギスハンドル含む)。
|
|
49
|
+
|
|
50
|
+
## インストール
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
pnpm add @aiquants/period-slider
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## 使用方法
|
|
57
|
+
|
|
58
|
+
### スタイル読み込み
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
// Tailwind CSS v4 プロジェクトの場合
|
|
62
|
+
import "@aiquants/period-slider/styles/period-slider.css"
|
|
63
|
+
|
|
64
|
+
// スタンドアロン環境の場合
|
|
65
|
+
import "@aiquants/period-slider/styles/period-slider.standalone.css"
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### ゼロ・ボイラープレート React フック連携 (`usePeriodSliderRange`)
|
|
69
|
+
|
|
70
|
+
ステート管理・単一要素ミューテータ・セレクタ連動を 1 行で完結できます。
|
|
71
|
+
|
|
72
|
+
```tsx
|
|
73
|
+
import { PeriodSlider, MonthSelector, usePeriodSliderRange } from "@aiquants/period-slider"
|
|
74
|
+
|
|
75
|
+
export function FastRangeExample() {
|
|
76
|
+
const { sliderProps, startSelectorProps, endSelectorProps } = usePeriodSliderRange({
|
|
77
|
+
unit: "month",
|
|
78
|
+
initialRange: [new Date(2024, 0, 1), new Date(2024, 11, 1)],
|
|
79
|
+
minDate: new Date(2020, 0, 1),
|
|
80
|
+
maxDate: new Date(2025, 11, 1),
|
|
81
|
+
colorScheme: "indigo-amber",
|
|
82
|
+
})
|
|
83
|
+
|
|
84
|
+
return (
|
|
85
|
+
<div className="flex items-center gap-4">
|
|
86
|
+
<MonthSelector {...startSelectorProps} />
|
|
87
|
+
<PeriodSlider {...sliderProps} className="flex-1" />
|
|
88
|
+
<MonthSelector {...endSelectorProps} />
|
|
89
|
+
</div>
|
|
90
|
+
)
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### PeriodSlider (Range モード: タプル直接指定)
|
|
95
|
+
|
|
96
|
+
```tsx
|
|
97
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
98
|
+
import { useState } from "react"
|
|
99
|
+
|
|
100
|
+
export function Example() {
|
|
101
|
+
const [range, setRange] = useState<[Date, Date]>([
|
|
102
|
+
new Date(2024, 0, 1),
|
|
103
|
+
new Date(2024, 11, 1),
|
|
104
|
+
])
|
|
105
|
+
|
|
106
|
+
return (
|
|
107
|
+
<PeriodSlider
|
|
108
|
+
mode="range"
|
|
109
|
+
unit="month"
|
|
110
|
+
minDate={new Date(2020, 0, 1)}
|
|
111
|
+
maxDate={new Date(2025, 11, 1)}
|
|
112
|
+
range={range}
|
|
113
|
+
onChange={setRange}
|
|
114
|
+
labelPosition="top"
|
|
115
|
+
preventCollisionSlant={true}
|
|
116
|
+
/>
|
|
117
|
+
)
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### PeriodSlider (Point モード)
|
|
122
|
+
|
|
123
|
+
```tsx
|
|
124
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
125
|
+
import { useState } from "react"
|
|
126
|
+
|
|
127
|
+
export function PointExample() {
|
|
128
|
+
const [date, setDate] = useState<Date>(new Date(2024, 5, 1))
|
|
129
|
+
|
|
130
|
+
return (
|
|
131
|
+
<PeriodSlider
|
|
132
|
+
mode="point"
|
|
133
|
+
unit="month"
|
|
134
|
+
minDate={new Date(2020, 0, 1)}
|
|
135
|
+
maxDate={new Date(2025, 11, 1)}
|
|
136
|
+
valueDate={date}
|
|
137
|
+
labelPosition="top"
|
|
138
|
+
onChangePoint={(nextDate) => setDate(nextDate)}
|
|
139
|
+
/>
|
|
140
|
+
)
|
|
141
|
+
}
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### PeriodSlider (Vernier ノギス 2 段スケール一体型モード)
|
|
145
|
+
|
|
146
|
+
広域期間(例: 数年〜十数年)の中から極小期間(例: 数日〜数ヶ月)を精密に選択する場合に適した、ノギス型 2 段スケール一体型スライダーです。上側(マクロ)で全体期間の表示窓を定め、下側(ミクロ)でその表示窓を 100% に拡大した精密な選択を行います。
|
|
147
|
+
|
|
148
|
+
```tsx
|
|
149
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
150
|
+
import { useState } from "react"
|
|
151
|
+
|
|
152
|
+
export function VernierExample() {
|
|
153
|
+
// マクロ側の表示窓 (2023年〜2025年)
|
|
154
|
+
const [macroRange, setMacroRange] = useState<[Date, Date]>([
|
|
155
|
+
new Date(2023, 0, 1),
|
|
156
|
+
new Date(2025, 0, 1),
|
|
157
|
+
])
|
|
158
|
+
// ミクロ側の最終確定選択期間 (2023年6月〜11月)
|
|
159
|
+
const [microRange, setMicroRange] = useState<[Date, Date]>([
|
|
160
|
+
new Date(2023, 5, 1),
|
|
161
|
+
new Date(2023, 10, 1),
|
|
162
|
+
])
|
|
163
|
+
|
|
164
|
+
return (
|
|
165
|
+
<PeriodSlider
|
|
166
|
+
mode="vernier"
|
|
167
|
+
unit="month"
|
|
168
|
+
minDate={new Date(2010, 0, 1)}
|
|
169
|
+
maxDate={new Date(2026, 11, 31)}
|
|
170
|
+
macroRange={macroRange}
|
|
171
|
+
onChangeMacroRange={(lower, upper) => setMacroRange([lower, upper])}
|
|
172
|
+
lowerDate={microRange[0]}
|
|
173
|
+
upperDate={microRange[1]}
|
|
174
|
+
onChangeRange={(lower, upper) => setMicroRange([lower, upper])}
|
|
175
|
+
vernierOrientation="macro-top"
|
|
176
|
+
showVernierProjection={true}
|
|
177
|
+
showVernierTicks={true}
|
|
178
|
+
showHairline={true}
|
|
179
|
+
/>
|
|
180
|
+
)
|
|
181
|
+
}
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
### PeriodSlider (垂直レイアウト)
|
|
185
|
+
|
|
186
|
+
`isVertical={true}` を指定することで、縦向き(下部が最小日付、上部が最大日付)のスライダーとして表示できます。親要素に `h-64` 等の高さを指定して利用します。
|
|
187
|
+
|
|
188
|
+
```tsx
|
|
189
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
190
|
+
import { useState } from "react"
|
|
191
|
+
|
|
192
|
+
export function VerticalExample() {
|
|
193
|
+
const [range, setRange] = useState<[Date, Date]>([
|
|
194
|
+
new Date(2024, 2, 1),
|
|
195
|
+
new Date(2024, 8, 1),
|
|
196
|
+
])
|
|
197
|
+
|
|
198
|
+
return (
|
|
199
|
+
<div className="h-64 flex items-center justify-center p-4">
|
|
200
|
+
<PeriodSlider
|
|
201
|
+
mode="range"
|
|
202
|
+
unit="month"
|
|
203
|
+
isVertical={true}
|
|
204
|
+
minDate={new Date(2024, 0, 1)}
|
|
205
|
+
maxDate={new Date(2024, 11, 31)}
|
|
206
|
+
lowerDate={range[0]}
|
|
207
|
+
upperDate={range[1]}
|
|
208
|
+
onChangeRange={(lower, upper) => setRange([lower, upper])}
|
|
209
|
+
/>
|
|
210
|
+
</div>
|
|
211
|
+
)
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
### PeriodSlider (離散日付スナップ & 目盛表示)
|
|
216
|
+
|
|
217
|
+
実データが存在する離散日付のみを選択対象とし、トラック上に目盛線を表示します。
|
|
218
|
+
|
|
219
|
+
```tsx
|
|
220
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
221
|
+
import { useState } from "react"
|
|
222
|
+
|
|
223
|
+
const discreteDates = [
|
|
224
|
+
new Date(2024, 0, 15),
|
|
225
|
+
new Date(2024, 1, 14),
|
|
226
|
+
new Date(2024, 2, 18),
|
|
227
|
+
new Date(2024, 3, 22),
|
|
228
|
+
new Date(2024, 4, 10),
|
|
229
|
+
]
|
|
230
|
+
|
|
231
|
+
export function DiscreteExample() {
|
|
232
|
+
const [point, setPoint] = useState<Date>(discreteDates[0])
|
|
233
|
+
|
|
234
|
+
return (
|
|
235
|
+
<PeriodSlider
|
|
236
|
+
mode="point"
|
|
237
|
+
unit="day"
|
|
238
|
+
allowedDates={discreteDates}
|
|
239
|
+
showTicks={true}
|
|
240
|
+
snapMode="time"
|
|
241
|
+
valueDate={point}
|
|
242
|
+
onChangePoint={(d) => setPoint(d)}
|
|
243
|
+
/>
|
|
244
|
+
)
|
|
245
|
+
}
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
### PeriodSlider (カスタムラベル & 独立 2 点選択)
|
|
249
|
+
|
|
250
|
+
四半期表示などのカスタムフォーマット (`formatLabel`) や、2 点間の連結バーを非表示にする `hideConnectBar={true}` を組み合わせた設定例です。
|
|
251
|
+
|
|
252
|
+
```tsx
|
|
253
|
+
import { PeriodSlider } from "@aiquants/period-slider"
|
|
254
|
+
import { useState } from "react"
|
|
255
|
+
|
|
256
|
+
export function CustomLabelExample() {
|
|
257
|
+
const [range, setRange] = useState<[Date, Date]>([
|
|
258
|
+
new Date(2024, 0, 1),
|
|
259
|
+
new Date(2024, 6, 1),
|
|
260
|
+
])
|
|
261
|
+
|
|
262
|
+
const formatQuarter = (date: Date) => {
|
|
263
|
+
const y = date.getFullYear()
|
|
264
|
+
const q = Math.floor(date.getMonth() / 3) + 1
|
|
265
|
+
return `${y}-Q${q}`
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
return (
|
|
269
|
+
<PeriodSlider
|
|
270
|
+
mode="range"
|
|
271
|
+
unit="month"
|
|
272
|
+
minDate={new Date(2023, 0, 1)}
|
|
273
|
+
maxDate={new Date(2025, 11, 31)}
|
|
274
|
+
lowerDate={range[0]}
|
|
275
|
+
upperDate={range[1]}
|
|
276
|
+
hideConnectBar={true}
|
|
277
|
+
formatLabel={formatQuarter}
|
|
278
|
+
tooltipStyle="balloon"
|
|
279
|
+
onChangeRange={(lower, upper) => setRange([lower, upper])}
|
|
280
|
+
/>
|
|
281
|
+
)
|
|
282
|
+
}
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
### PeriodSlider 主な Props
|
|
286
|
+
|
|
287
|
+
| プロパティ | 型 | 既定値 | 説明 |
|
|
288
|
+
| :--- | :--- | :--- | :--- |
|
|
289
|
+
| `mode` | `"range" \| "point" \| "vernier"` | (必須) | 操作モード (`range`: 2 点範囲選択, `point`: 1 点選択, `vernier`: ノギス 2 段スケール一体型) |
|
|
290
|
+
| `unit` | `"year" \| "month" \| "day"` | (必須) | 時間解像度単位 |
|
|
291
|
+
| `minDate` | `Date` | (必須) | 選択可能最小日付 (固定フォールバックなし) |
|
|
292
|
+
| `maxDate` | `Date` | (必須) | 選択可能最大日付 (固定フォールバックなし) |
|
|
293
|
+
| `lowerDate` | `Date` | (range / vernier 必須) | レンジまたはミクロ選択時の開始日付 |
|
|
294
|
+
| `upperDate` | `Date` | (range / vernier 必須) | レンジまたはミクロ選択時の終了日付 |
|
|
295
|
+
| `valueDate` | `Date` | (point 必須) | ポイント選択時の日付 |
|
|
296
|
+
| `macroRange` | `[Date, Date]` | (vernier 必須) | ノギスモード時のマクロ側表示窓 [開始, 終了] |
|
|
297
|
+
| `macroUnit` | `"year" \| "month" \| "day"` | `unit` | ノギスモード時のマクロ側時間解像度単位 (異単位構成用) |
|
|
298
|
+
| `microUnit` | `"year" \| "month" \| "day"` | `unit` | ノギスモード時のミクロ側時間解像度単位 (異単位構成用) |
|
|
299
|
+
| `formatMacroLabel` | `(date: Date) => string` | `undefined` | ノギスマクロ側ラベル・ツールチップのカスタム表示文字列生成関数 |
|
|
300
|
+
| `formatMicroLabel` | `(date: Date) => string` | `undefined` | ノギスミクロ側ラベル・ツールチップのカスタム表示文字列生成関数 |
|
|
301
|
+
| `macroAllowedDates` | `Date[]` | `undefined` | ノギスマクロ側の離散スナップ対象日付配列 |
|
|
302
|
+
| `microAllowedDates` | `Date[]` | `undefined` | ノギスミクロ側の離散スナップ対象日付配列 |
|
|
303
|
+
| `vernierOrientation` | `"macro-top" \| "macro-bottom"` | `"macro-top"` | ノギスの上下配置 (上マクロ/下ミクロ または 上ミクロ/下マクロ反転) |
|
|
304
|
+
| `showVernierProjection` | `boolean` | `true` | マクロ窓からミクロ全幅へ広がる半透明台形プロジェクション光の表示有無 |
|
|
305
|
+
| `showVernierTicks` | `boolean` | `true` | マクロレールおよびミクロレール上のアダプティブ目盛線の表示有無 |
|
|
306
|
+
| `showHairline` | `boolean` | `true` | 半円つまみ先端の 1px 精密ヘアライン針の表示有無 |
|
|
307
|
+
| `adaptiveExpand` | `boolean` | `false` | ノギスモード時のズーム展開アニメーション有無 |
|
|
308
|
+
| `allowedDates` | `Date[]` | `undefined` | 離散スナップ対象日付配列 (指定時はこの日付のみにスナップ) |
|
|
309
|
+
| `snapMode` | `"index" \| "time"` | `"time"` | 離散スナップ時の計算方式 (`"time"`: 時間距離, `"index"`: 配列インデックス均等) |
|
|
310
|
+
| `labelPosition` | `"top" \| "bottom"` | `"top"` | 日付ラベルの表示位置 (スライダーの上側または下側) |
|
|
311
|
+
| `autoSlantLabels` | `boolean` | `true` | 近接時にラベルを斜め〜90°に自動傾斜させて重なりを防止 |
|
|
312
|
+
| `tooltipStyle` | `"always" \| "hover" \| "balloon"` | `"hover"` | ツールチップの表示スタイル (`"always"`: 常時, `"hover"`: ポインター操作時, `"balloon"`: 吹き出し型) |
|
|
313
|
+
| `isVertical` | `boolean` | `false` | 垂直スライダー表示の有効化 |
|
|
314
|
+
| `hideConnectBar` | `boolean` | `false` | 範囲選択バー (ハイライト) を非表示にし、独立 2 点選択 UI として利用 |
|
|
315
|
+
| `showTicks` | `boolean` | `false` | トラック上の目盛線の表示有無 |
|
|
316
|
+
| `showStepper` | `boolean` | `true` | ◀▶ ステッパーボタンの表示有無 (垂直時は ▲▼) |
|
|
317
|
+
| `formatLabel` | `(date: Date) => string` | `undefined` | 日付ラベル・ツールチップのカスタム表示文字列生成関数 |
|
|
318
|
+
| `disabled` | `boolean` | `false` | スライダーの無効化・非活性表示 |
|
|
319
|
+
| `debounceMs` | `number` | `0` | コールバック呼び出しのデバウンス時間 (ミリ秒) |
|
|
320
|
+
| `colorScheme` | `PeriodSliderColorScheme` | `"blue-rose"` | カラーテーマプリセット (`"blue-rose"`, `"indigo-amber"`, `"teal-emerald"`, `"violet-fuchsia"`, `"slate-sky"`, `"monochrome"`) |
|
|
321
|
+
| `className` | `string` | `undefined` | 最外層コンテナ要素の追加 CSS クラス |
|
|
322
|
+
| `onChangeRange` | `(lower: Date, upper: Date) => void` | - | レンジまたはミクロ変更時コールバック |
|
|
323
|
+
| `onChangeMacroRange` | `(lower: Date, upper: Date) => void` | - | ノギスモード時のマクロ窓変更時コールバック |
|
|
324
|
+
| `onChangePoint` | `(date: Date) => void` | - | ポイント変更時コールバック |
|
|
325
|
+
|
|
326
|
+
### カラーテーマ & ダークモード
|
|
327
|
+
|
|
328
|
+
`colorScheme` プロパティを指定することで、スライダー全体のベースカラー体系を容易に変更できます。
|
|
329
|
+
|
|
330
|
+
```tsx
|
|
331
|
+
<PeriodSlider
|
|
332
|
+
mode="vernier"
|
|
333
|
+
unit="month"
|
|
334
|
+
colorScheme="indigo-amber" // 🟣 Indigo × 🟠 Amber 配色
|
|
335
|
+
// ...
|
|
336
|
+
/>
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
| プリセット | マクロ色 | ミクロ色 | アクセント色 | 特徴 |
|
|
340
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
341
|
+
| `"blue-rose"` (既定) | Sky / Blue (`#0284c7`) | Rose / Red (`#e11d48`) | Indigo (`#4f46e5`) | 青と赤の鮮明なメリハリ対比 |
|
|
342
|
+
| `"indigo-amber"` | Indigo (`#4f46e5`) | Amber (`#d97706`) | Violet (`#7c3aed`) | 藍色と琥珀色のモダンなコントラスト |
|
|
343
|
+
| `"teal-emerald"` | Teal (`#0d9488`) | Emerald (`#059669`) | Cyan (`#0891b2`) | 自然で落ち着きのあるグリーン・ティール系 |
|
|
344
|
+
| `"violet-fuchsia"` | Violet (`#7c3aed`) | Fuchsia (`#c026d3`) | Purple (`#9333ea`) | クリエイティブな紫・赤紫系 |
|
|
345
|
+
| `"slate-sky"` | Slate (`#475569`) | Sky (`#0284c7`) | Blue (`#2563eb`) | エンタープライズ向けクールスレート系 |
|
|
346
|
+
| `"monochrome"` | Zinc (`#52525b`) | Neutral (`#262626`) | Dark Neutral (`#171717`) | 無彩色ニュートラル設計 |
|
|
347
|
+
|
|
348
|
+
ダークモードは、祖先要素に `.dark` クラスを付与するだけで、スライダー(トラック、ノブ、グロー光、目盛線、ツールチップ)および全セレクタ(`YearSelector`, `MonthSelector`, `DateSelector`)が自動でダークパレットに適応します。
|
|
349
|
+
|
|
350
|
+
### 各種セレクタ
|
|
351
|
+
|
|
352
|
+
```tsx
|
|
353
|
+
import { YearSelector, MonthSelector, DateSelector } from "@aiquants/period-slider"
|
|
354
|
+
import { useState } from "react"
|
|
355
|
+
|
|
356
|
+
export function SelectorsExample() {
|
|
357
|
+
const [currentDate, setCurrentDate] = useState<Date>(new Date())
|
|
358
|
+
|
|
359
|
+
return (
|
|
360
|
+
<div className="flex flex-col gap-4">
|
|
361
|
+
{/* 年セレクタ */}
|
|
362
|
+
<YearSelector
|
|
363
|
+
initialDate={currentDate}
|
|
364
|
+
minYear={2020}
|
|
365
|
+
maxYear={2030}
|
|
366
|
+
onChange={(date, year) => setCurrentDate(date)}
|
|
367
|
+
/>
|
|
368
|
+
|
|
369
|
+
{/* 年月セレクタ */}
|
|
370
|
+
<MonthSelector
|
|
371
|
+
initialDate={currentDate}
|
|
372
|
+
variant="dropdown"
|
|
373
|
+
onChange={(date, yyyymm) => setCurrentDate(date)}
|
|
374
|
+
/>
|
|
375
|
+
|
|
376
|
+
{/* 年月日セレクタ (単一セレクトボックス) */}
|
|
377
|
+
<DateSelector
|
|
378
|
+
initialDate={currentDate}
|
|
379
|
+
variant="dropdown"
|
|
380
|
+
onChange={(date) => setCurrentDate(date)}
|
|
381
|
+
/>
|
|
382
|
+
</div>
|
|
383
|
+
)
|
|
384
|
+
}
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
## ライセンス
|
|
388
|
+
|
|
389
|
+
MIT
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { PeriodSliderUnit } from './PeriodSlider';
|
|
3
|
+
export interface DateSelectorProps {
|
|
4
|
+
/** Controlled selected date / 選択日付(外部制御用) */
|
|
5
|
+
value?: Date;
|
|
6
|
+
/** Initial selected date (defaults to current date) / 選択日付(未指定時は現在日) */
|
|
7
|
+
initialDate?: Date;
|
|
8
|
+
/** Time resolution unit (ignored by selector, accepted for hook interoperability) / 時間解像度単位 (フック相互運用用) */
|
|
9
|
+
unit?: PeriodSliderUnit;
|
|
10
|
+
/** Callback triggered when date changes / 日付変更時コールバック */
|
|
11
|
+
onChange?(date: Date): void;
|
|
12
|
+
/** Child elements / 子要素 */
|
|
13
|
+
children?: React.ReactNode;
|
|
14
|
+
/** Minimum selectable year / ドロップダウン・可能範囲の最小年 */
|
|
15
|
+
minYear?: number;
|
|
16
|
+
/** Maximum selectable year / ドロップダウン・可能範囲の最大年 */
|
|
17
|
+
maxYear?: number;
|
|
18
|
+
/** Minimum selectable date / 選択可能範囲の最小日付 */
|
|
19
|
+
minDate?: Date;
|
|
20
|
+
/** Maximum selectable date / 選択可能範囲の最大日付 */
|
|
21
|
+
maxDate?: Date;
|
|
22
|
+
/** Discrete allowed dates list / 選択可能な離散日付配列 */
|
|
23
|
+
allowedDates?: Date[];
|
|
24
|
+
/**
|
|
25
|
+
* UI Variant:
|
|
26
|
+
* - "dropdown": Single select element with yyyy-MM-dd options (既定の単一セレクトボックス)
|
|
27
|
+
* - "date": Native input[type="date"]
|
|
28
|
+
* - "split-dropdown": Three separate selects for year, month, and day
|
|
29
|
+
*/
|
|
30
|
+
variant?: "date" | "dropdown" | "split-dropdown";
|
|
31
|
+
/** Additional CSS class name / 追加の CSS クラス名 */
|
|
32
|
+
className?: string;
|
|
33
|
+
/** Custom styles / スタイル */
|
|
34
|
+
style?: React.CSSProperties;
|
|
35
|
+
/** Disabled flag / 無効化フラグ */
|
|
36
|
+
disabled?: boolean;
|
|
37
|
+
/** Accessible label for previous date button / 前日ボタンのアクセシブル名 */
|
|
38
|
+
prevDateAriaLabel?: string;
|
|
39
|
+
/** Accessible label for next date button / 翌日ボタンのアクセシブル名 */
|
|
40
|
+
nextDateAriaLabel?: string;
|
|
41
|
+
/** Accessible label for date select combobox / 年月日セレクトのアクセシブル名 */
|
|
42
|
+
selectAriaLabel?: string;
|
|
43
|
+
}
|
|
44
|
+
export declare const DateSelector: React.MemoExoticComponent<(props: DateSelectorProps) => React.JSX.Element>;
|
|
45
|
+
//# sourceMappingURL=DateSelector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"DateSelector.d.ts","sourceRoot":"","sources":["../src/DateSelector.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,wEAAwE;IACxE,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,0GAA0G;IAC1G,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,4CAA4C;IAC5C,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,gDAAgD;IAChD,YAAY,CAAC,EAAE,IAAI,EAAE,CAAA;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAAA;IAChD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAsVD,eAAO,MAAM,YAAY,oCAtSa,iBAAiB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+TzE,CAAA"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { PeriodSliderUnit } from './PeriodSlider';
|
|
3
|
+
export interface MonthSelectorProps {
|
|
4
|
+
/** Controlled selected date / 選択日付(外部制御用) */
|
|
5
|
+
value?: Date;
|
|
6
|
+
/** Initial selected date (defaults to current month) / 選択日付(未指定時は現在月) */
|
|
7
|
+
initialDate?: Date;
|
|
8
|
+
/** Time resolution unit (ignored by selector, accepted for hook interoperability) / 時間解像度単位 (フック相互運用用) */
|
|
9
|
+
unit?: PeriodSliderUnit;
|
|
10
|
+
/** Callback triggered when month changes / 月変更時コールバック */
|
|
11
|
+
onChange?(date: Date, yyyymm: number): void;
|
|
12
|
+
/** Child elements / 子要素 */
|
|
13
|
+
children?: React.ReactNode;
|
|
14
|
+
/**
|
|
15
|
+
* UI variant: "date" (input[type="month"]) or "dropdown" (select[yyyy-mm]). Defaults to "date".
|
|
16
|
+
* 表示バリエーション: "date" (input[type="month"]) または "dropdown" (select[yyyy-mm])。既定値 "date"
|
|
17
|
+
*/
|
|
18
|
+
variant?: "date" | "dropdown";
|
|
19
|
+
/** Minimum year for options / 選択肢・可能範囲の最小年 */
|
|
20
|
+
minYear?: number;
|
|
21
|
+
/** Maximum year for options / 選択肢・可能範囲の最大年 */
|
|
22
|
+
maxYear?: number;
|
|
23
|
+
/** Minimum date for options / 選択肢・可能範囲の最小日付 */
|
|
24
|
+
minDate?: Date;
|
|
25
|
+
/** Maximum date for options / 選択肢・可能範囲の最大日付 */
|
|
26
|
+
maxDate?: Date;
|
|
27
|
+
/** Warning style flag / 警告枠スタイル適用フラグ */
|
|
28
|
+
isWarning?: boolean;
|
|
29
|
+
/** Additional CSS class name / 追加の CSS クラス名 */
|
|
30
|
+
className?: string;
|
|
31
|
+
/** Custom styles / スタイル */
|
|
32
|
+
style?: React.CSSProperties;
|
|
33
|
+
/** Disabled flag / 無効化フラグ */
|
|
34
|
+
disabled?: boolean;
|
|
35
|
+
/** Accessible label for previous month button / 前月ボタンのアクセシブル名 */
|
|
36
|
+
prevMonthAriaLabel?: string;
|
|
37
|
+
/** Accessible label for next month button / 翌月ボタンのアクセシブル名 */
|
|
38
|
+
nextMonthAriaLabel?: string;
|
|
39
|
+
/** Accessible label for month select combobox / 年月セレクトのアクセシブル名 */
|
|
40
|
+
selectAriaLabel?: string;
|
|
41
|
+
}
|
|
42
|
+
export declare const MonthSelector: React.MemoExoticComponent<(props: MonthSelectorProps) => React.JSX.Element>;
|
|
43
|
+
//# sourceMappingURL=MonthSelector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MonthSelector.d.ts","sourceRoot":"","sources":["../src/MonthSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,yEAAyE;IACzE,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,0GAA0G;IAC1G,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,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,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AA0OD,eAAO,MAAM,aAAa,oCAhMa,kBAAkB,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAyN3E,CAAA"}
|