@apexhub/apex-ui-react 0.0.0-stage → 1.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.
Files changed (185) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/en_US.d.ts +191 -0
  4. package/dist/index.cjs +40692 -0
  5. package/dist/index.d.ts +6869 -0
  6. package/dist/index.mjs +40676 -0
  7. package/dist/llm/alert.tokens.txt +44 -0
  8. package/dist/llm/alert.txt +167 -0
  9. package/dist/llm/apex-provider.txt +368 -0
  10. package/dist/llm/auto-complete.tokens.txt +77 -0
  11. package/dist/llm/auto-complete.txt +373 -0
  12. package/dist/llm/avatar.tokens.txt +38 -0
  13. package/dist/llm/avatar.txt +199 -0
  14. package/dist/llm/breadcrumb.tokens.txt +193 -0
  15. package/dist/llm/breadcrumb.txt +251 -0
  16. package/dist/llm/button.tokens.txt +470 -0
  17. package/dist/llm/button.txt +262 -0
  18. package/dist/llm/card.tokens.txt +27 -0
  19. package/dist/llm/card.txt +95 -0
  20. package/dist/llm/cascader.tokens.txt +253 -0
  21. package/dist/llm/cascader.txt +898 -0
  22. package/dist/llm/checkbox.tokens.txt +28 -0
  23. package/dist/llm/checkbox.txt +332 -0
  24. package/dist/llm/collapse.tokens.txt +84 -0
  25. package/dist/llm/collapse.txt +330 -0
  26. package/dist/llm/date-picker.tokens.txt +171 -0
  27. package/dist/llm/date-picker.txt +424 -0
  28. package/dist/llm/divider.tokens.txt +22 -0
  29. package/dist/llm/divider.txt +161 -0
  30. package/dist/llm/drawer.tokens.txt +71 -0
  31. package/dist/llm/drawer.txt +369 -0
  32. package/dist/llm/dropdown.tokens.txt +59 -0
  33. package/dist/llm/dropdown.txt +420 -0
  34. package/dist/llm/form.tokens.txt +26 -0
  35. package/dist/llm/form.txt +341 -0
  36. package/dist/llm/grid.txt +419 -0
  37. package/dist/llm/image.tokens.txt +28 -0
  38. package/dist/llm/image.txt +428 -0
  39. package/dist/llm/input-number.tokens.txt +159 -0
  40. package/dist/llm/input-number.txt +486 -0
  41. package/dist/llm/input.tokens.txt +136 -0
  42. package/dist/llm/input.txt +422 -0
  43. package/dist/llm/layout.tokens.txt +29 -0
  44. package/dist/llm/layout.txt +298 -0
  45. package/dist/llm/menu.tokens.txt +87 -0
  46. package/dist/llm/menu.txt +680 -0
  47. package/dist/llm/message.tokens.txt +25 -0
  48. package/dist/llm/message.txt +301 -0
  49. package/dist/llm/modal.tokens.txt +96 -0
  50. package/dist/llm/modal.txt +584 -0
  51. package/dist/llm/notification.tokens.txt +79 -0
  52. package/dist/llm/notification.txt +383 -0
  53. package/dist/llm/pagination.tokens.txt +33 -0
  54. package/dist/llm/pagination.txt +208 -0
  55. package/dist/llm/popover.tokens.txt +28 -0
  56. package/dist/llm/popover.txt +233 -0
  57. package/dist/llm/progress.tokens.txt +83 -0
  58. package/dist/llm/progress.txt +279 -0
  59. package/dist/llm/radio.tokens.txt +21 -0
  60. package/dist/llm/radio.txt +348 -0
  61. package/dist/llm/rate.tokens.txt +20 -0
  62. package/dist/llm/rate.txt +241 -0
  63. package/dist/llm/select.tokens.txt +160 -0
  64. package/dist/llm/select.txt +830 -0
  65. package/dist/llm/skeleton.tokens.txt +15 -0
  66. package/dist/llm/skeleton.txt +275 -0
  67. package/dist/llm/spin.tokens.txt +21 -0
  68. package/dist/llm/spin.txt +294 -0
  69. package/dist/llm/steps.tokens.txt +30 -0
  70. package/dist/llm/steps.txt +300 -0
  71. package/dist/llm/switch.tokens.txt +38 -0
  72. package/dist/llm/switch.txt +216 -0
  73. package/dist/llm/table.tokens.txt +94 -0
  74. package/dist/llm/table.txt +1046 -0
  75. package/dist/llm/tabs.tokens.txt +78 -0
  76. package/dist/llm/tabs.txt +306 -0
  77. package/dist/llm/tag.tokens.txt +76 -0
  78. package/dist/llm/tag.txt +305 -0
  79. package/dist/llm/tooltip.tokens.txt +22 -0
  80. package/dist/llm/tooltip.txt +304 -0
  81. package/dist/llm/tree-select.tokens.txt +174 -0
  82. package/dist/llm/tree-select.txt +762 -0
  83. package/dist/llm/tree.tokens.txt +36 -0
  84. package/dist/llm/tree.txt +505 -0
  85. package/dist/llm/typography.tokens.txt +60 -0
  86. package/dist/llm/typography.txt +413 -0
  87. package/dist/llm/upload.tokens.txt +201 -0
  88. package/dist/llm/upload.txt +706 -0
  89. package/dist/llms-full.txt +16689 -0
  90. package/dist/llms-theme.txt +32 -0
  91. package/dist/llms.txt +59 -0
  92. package/dist/locale/en_US.cjs +160 -0
  93. package/dist/locale/en_US.d.ts +4 -0
  94. package/dist/locale/en_US.mjs +161 -0
  95. package/dist/locale/zh_CN.cjs +160 -0
  96. package/dist/locale/zh_CN.d.ts +4 -0
  97. package/dist/locale/zh_CN.mjs +161 -0
  98. package/dist/style.css +19619 -0
  99. package/dist/zh_CN.d.ts +191 -0
  100. package/llms-full.txt +16689 -0
  101. package/llms-theme.txt +32 -0
  102. package/llms.txt +59 -0
  103. package/package.json +118 -3
  104. package/src/alert/llm.txt +167 -0
  105. package/src/alert/tokens.txt +44 -0
  106. package/src/apex-provider/llm.txt +368 -0
  107. package/src/auto-complete/llm.txt +373 -0
  108. package/src/auto-complete/tokens.txt +77 -0
  109. package/src/avatar/llm.txt +199 -0
  110. package/src/avatar/tokens.txt +38 -0
  111. package/src/breadcrumb/llm.txt +251 -0
  112. package/src/breadcrumb/tokens.txt +193 -0
  113. package/src/button/llm.txt +262 -0
  114. package/src/button/tokens.txt +470 -0
  115. package/src/card/llm.txt +95 -0
  116. package/src/card/tokens.txt +27 -0
  117. package/src/cascader/llm.txt +898 -0
  118. package/src/cascader/tokens.txt +253 -0
  119. package/src/checkbox/llm.txt +332 -0
  120. package/src/checkbox/tokens.txt +28 -0
  121. package/src/collapse/llm.txt +330 -0
  122. package/src/collapse/tokens.txt +84 -0
  123. package/src/date-picker/llm.txt +424 -0
  124. package/src/date-picker/tokens.txt +171 -0
  125. package/src/divider/llm.txt +161 -0
  126. package/src/divider/tokens.txt +22 -0
  127. package/src/drawer/llm.txt +369 -0
  128. package/src/drawer/tokens.txt +71 -0
  129. package/src/dropdown/llm.txt +420 -0
  130. package/src/dropdown/tokens.txt +59 -0
  131. package/src/form/llm.txt +341 -0
  132. package/src/form/tokens.txt +26 -0
  133. package/src/grid/llm.txt +419 -0
  134. package/src/image/llm.txt +428 -0
  135. package/src/image/tokens.txt +28 -0
  136. package/src/input/llm.txt +422 -0
  137. package/src/input/tokens.txt +136 -0
  138. package/src/input-number/llm.txt +486 -0
  139. package/src/input-number/tokens.txt +159 -0
  140. package/src/layout/llm.txt +298 -0
  141. package/src/layout/tokens.txt +29 -0
  142. package/src/menu/llm.txt +680 -0
  143. package/src/menu/tokens.txt +87 -0
  144. package/src/message/llm.txt +301 -0
  145. package/src/message/tokens.txt +25 -0
  146. package/src/modal/llm.txt +584 -0
  147. package/src/modal/tokens.txt +96 -0
  148. package/src/notification/llm.txt +383 -0
  149. package/src/notification/tokens.txt +79 -0
  150. package/src/pagination/llm.txt +208 -0
  151. package/src/pagination/tokens.txt +33 -0
  152. package/src/popover/llm.txt +233 -0
  153. package/src/popover/tokens.txt +28 -0
  154. package/src/progress/llm.txt +279 -0
  155. package/src/progress/tokens.txt +83 -0
  156. package/src/radio/llm.txt +348 -0
  157. package/src/radio/tokens.txt +21 -0
  158. package/src/rate/llm.txt +241 -0
  159. package/src/rate/tokens.txt +20 -0
  160. package/src/select/llm.txt +830 -0
  161. package/src/select/tokens.txt +160 -0
  162. package/src/skeleton/llm.txt +275 -0
  163. package/src/skeleton/tokens.txt +15 -0
  164. package/src/spin/llm.txt +294 -0
  165. package/src/spin/tokens.txt +21 -0
  166. package/src/steps/llm.txt +300 -0
  167. package/src/steps/tokens.txt +30 -0
  168. package/src/switch/llm.txt +216 -0
  169. package/src/switch/tokens.txt +38 -0
  170. package/src/table/llm.txt +1046 -0
  171. package/src/table/tokens.txt +94 -0
  172. package/src/tabs/llm.txt +306 -0
  173. package/src/tabs/tokens.txt +78 -0
  174. package/src/tag/llm.txt +305 -0
  175. package/src/tag/tokens.txt +76 -0
  176. package/src/tooltip/llm.txt +304 -0
  177. package/src/tooltip/tokens.txt +22 -0
  178. package/src/tree/llm.txt +505 -0
  179. package/src/tree/tokens.txt +36 -0
  180. package/src/tree-select/llm.txt +762 -0
  181. package/src/tree-select/tokens.txt +174 -0
  182. package/src/typography/llm.txt +413 -0
  183. package/src/typography/tokens.txt +60 -0
  184. package/src/upload/llm.txt +706 -0
  185. package/src/upload/tokens.txt +201 -0
@@ -0,0 +1,424 @@
1
+ # DatePicker
2
+
3
+ > DatePicker:用户需要选择单个日期或日期范围,且精确到日、周、月、季、年等不同粒度时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`DatePicker`、`RangePicker`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { DatePicker } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => (
19
+ <div style={{ padding: 24, minHeight: 360 }}>
20
+ <DatePicker />
21
+ </div>
22
+ )
23
+ ```
24
+
25
+ ## 何时使用
26
+
27
+ - 用户需要选择单个日期或日期范围,且精确到日、周、月、季、年等不同粒度时。
28
+ - 需要禁用特定日期、允许清除、或受控管理选中值时。
29
+ - 若只需输入固定格式字符串且无需日历面板,可考虑 Input;若需时间选择,可配合 `showTime`。
30
+
31
+ ## API
32
+
33
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
34
+
35
+ ### DatePicker
36
+
37
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
38
+ | --- | --- | --- | --- | --- |
39
+ | value | — | `DateValue` | 否 | — |
40
+ | defaultValue | — | `DateValue` | 否 | — |
41
+ | onChange | — | `(date: DateValue, dateString: string) => void` | 否 | — |
42
+ | disabledDate | — | `DisabledDateFn` | 否 | — |
43
+ | presets | 面板左侧的业务快捷日期;未传或为空时不展示快捷区。 | `DatePickerPreset[]` | 否 | — |
44
+ | placeholder | — | `string` | 否 | — |
45
+ | showToday | 是否显示面板底部当前周期快捷按钮。<br>`date`:「今天」;`week`:「本周」;`month`:「本月」;`quarter`:「本季」;`year`:「本年」。 | `boolean` | 否 | `true` |
46
+ | ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
47
+ | variant | 输入框表面变体,与 Input 一致;不改变日期面板样式。 | `"default" \| "elevated"` | 否 | `'default'` |
48
+ | picker | — | `"date" \| "week" \| "month" \| "quarter" \| "year"` | 否 | — |
49
+ | format | — | `string` | 否 | — |
50
+ | showTime | 是否展示时间选择。仅 `picker="date"` 时生效。<br>- `true`:默认精确到秒(展示 `YYYY-MM-DD HH:mm:ss`,面板三列);须点「确定」后才会 `onChange`<br>- `{ format: 'HH:mm' }`:仅时/分(两列);触发器 format 未指定时跟随时段<br>- **RangePicker**:`showTime` 时分步确认——先 start 日期+时间 → 确定 → 再 end 日期+时间 → 确定 | `boolean \| { format?: string; defaultValue?: Dayjs \| [Dayjs, Dayjs] }` | 否 | `false` |
51
+ | needConfirm | 为 `true` 时,面板内选择仅作为草稿,须点击「确定」后才会触发 `onChange` 并更新触发器展示值。 | `boolean` | 否 | `false` |
52
+ | allowClear | — | `boolean \| { clearIcon?: ReactNode }` | 否 | — |
53
+ | disabled | — | `boolean` | 否 | — |
54
+ | readOnly | 只读:不可打开面板、不可改值,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
55
+ | size | — | `"small" \| "medium" \| "large"` | 否 | — |
56
+ | status | — | `"error" \| "warning"` | 否 | — |
57
+ | open | — | `boolean` | 否 | — |
58
+ | closeOnScroll | 外部滚动祖先滚动时关闭;内部列表滚动不关闭。触发器完全不可见时始终请求关闭。 | `boolean` | 否 | `false` |
59
+ | onOpenChange | — | `(open: boolean) => void` | 否 | — |
60
+ | popupClassName | — | `string` | 否 | — |
61
+ | getPopupContainer | 已弃用:浮层统一挂载 `[data-slot="overlay-root"]`,该 prop 不再生效。 | `(triggerNode: HTMLElement) => HTMLElement` | 否 | — |
62
+ | timezone | — | `string` | 否 | — |
63
+ | autoFocus | — | `boolean` | 否 | — |
64
+ | className | — | `string` | 否 | — |
65
+ | style | — | `React.CSSProperties` | 否 | — |
66
+
67
+ ### CommonPickerProps
68
+
69
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
70
+ | --- | --- | --- | --- | --- |
71
+ | variant | 输入框表面变体,与 Input 一致;不改变日期面板样式。 | `"default" \| "elevated"` | 否 | `'default'` |
72
+ | picker | — | `"date" \| "week" \| "month" \| "quarter" \| "year"` | 否 | — |
73
+ | format | — | `string` | 否 | — |
74
+ | showTime | 是否展示时间选择。仅 `picker="date"` 时生效。<br>- `true`:默认精确到秒(展示 `YYYY-MM-DD HH:mm:ss`,面板三列);须点「确定」后才会 `onChange`<br>- `{ format: 'HH:mm' }`:仅时/分(两列);触发器 format 未指定时跟随时段<br>- **RangePicker**:`showTime` 时分步确认——先 start 日期+时间 → 确定 → 再 end 日期+时间 → 确定 | `boolean \| { format?: string; defaultValue?: Dayjs \| [Dayjs, Dayjs] }` | 否 | `false` |
75
+ | needConfirm | 为 `true` 时,面板内选择仅作为草稿,须点击「确定」后才会触发 `onChange` 并更新触发器展示值。 | `boolean` | 否 | `false` |
76
+ | allowClear | — | `boolean \| { clearIcon?: ReactNode }` | 否 | — |
77
+ | disabled | — | `boolean` | 否 | — |
78
+ | readOnly | 只读:不可打开面板、不可改值,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
79
+ | size | — | `"small" \| "medium" \| "large"` | 否 | — |
80
+ | status | — | `"error" \| "warning"` | 否 | — |
81
+ | open | — | `boolean` | 否 | — |
82
+ | closeOnScroll | 外部滚动祖先滚动时关闭;内部列表滚动不关闭。触发器完全不可见时始终请求关闭。 | `boolean` | 否 | `false` |
83
+ | onOpenChange | — | `(open: boolean) => void` | 否 | — |
84
+ | popupClassName | — | `string` | 否 | — |
85
+ | getPopupContainer | 已弃用:浮层统一挂载 `[data-slot="overlay-root"]`,该 prop 不再生效。 | `(triggerNode: HTMLElement) => HTMLElement` | 否 | — |
86
+ | timezone | — | `string` | 否 | — |
87
+ | autoFocus | — | `boolean` | 否 | — |
88
+ | className | — | `string` | 否 | — |
89
+ | style | — | `React.CSSProperties` | 否 | — |
90
+
91
+ ### RangePickerProps
92
+
93
+ 继承:`CommonPickerProps`;本节列出新增或重声明字段。
94
+
95
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
96
+ | --- | --- | --- | --- | --- |
97
+ | value | — | `RangeValue` | 否 | — |
98
+ | defaultValue | — | `RangeValue` | 否 | — |
99
+ | onChange | — | `(value: RangeValue, formatString: [string, string]) => void` | 否 | — |
100
+ | disabledDate | — | `DisabledRangeDateFn` | 否 | — |
101
+ | presets | RangePicker 面板左侧的业务快捷区。 | `RangePickerPreset[]` | 否 | — |
102
+ | placeholder | — | `[string, string]` | 否 | — |
103
+ | separator | — | `ReactNode` | 否 | — |
104
+ | ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
105
+
106
+ ### RangePresetValue
107
+
108
+ ```typescript
109
+ type RangePresetValue = [Dayjs, Dayjs] | (() => [Dayjs, Dayjs] | null)
110
+ ```
111
+
112
+ ### DatePresetValue
113
+
114
+ 固定日期,或仅在点击时计算的日期;返回 null 时不改值。
115
+
116
+ ```typescript
117
+ type DatePresetValue = Dayjs | (() => Dayjs | null)
118
+ ```
119
+
120
+ ### DatePickerPreset
121
+
122
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
123
+ | --- | --- | --- | --- | --- |
124
+ | key | 稳定身份;同一组快捷项中必须唯一。 | `string` | 是 | — |
125
+ | label | 快捷按钮内容。 | `ReactNode` | 是 | — |
126
+ | value | 保留业务传入的完整日期与时间,遵循 needConfirm / showTime 确认规则。 | `DatePresetValue` | 是 | — |
127
+ | disabled | 禁用后不可触发。 | `boolean` | 否 | — |
128
+
129
+ ### RangePickerPreset
130
+
131
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
132
+ | --- | --- | --- | --- | --- |
133
+ | key | 稳定身份;同一组快捷项中必须唯一。 | `string` | 是 | — |
134
+ | label | 快捷按钮内容。 | `ReactNode` | 是 | — |
135
+ | value | 固定区间,或点击时计算的区间。 | `RangePresetValue` | 是 | — |
136
+ | disabled | 禁用后不可触发。 | `boolean` | 否 | — |
137
+
138
+ ### PickerType
139
+
140
+ ```typescript
141
+ type PickerType = 'date' | 'week' | 'month' | 'quarter' | 'year'
142
+ ```
143
+
144
+ ### DateSize
145
+
146
+ ```typescript
147
+ type DateSize = 'small' | 'medium' | 'large'
148
+ ```
149
+
150
+ ### DateStatus
151
+
152
+ ```typescript
153
+ type DateStatus = 'error' | 'warning'
154
+ ```
155
+
156
+ ### DateValue
157
+
158
+ ```typescript
159
+ type DateValue = Dayjs | null
160
+ ```
161
+
162
+ ### DisabledDateFn
163
+
164
+ 单参用法兼容;双参时可读取 info.type / info.from
165
+
166
+ ```typescript
167
+ type DisabledDateFn = (current: Dayjs, info?: DisabledDateInfo) => boolean
168
+ ```
169
+
170
+ ### RangeValue
171
+
172
+ ```typescript
173
+ type RangeValue = [DateValue, DateValue]
174
+ ```
175
+
176
+ ### DisabledRangeDateFn
177
+
178
+ RangePicker 用:统一双参签名(可忽略字段)
179
+
180
+ ```typescript
181
+ type DisabledRangeDateFn = (current: Dayjs, info: DisabledDateInfo) => boolean
182
+ ```
183
+
184
+ ### DisabledDateInfo
185
+
186
+ disabledDate 第二参。
187
+
188
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
189
+ | --- | --- | --- | --- | --- |
190
+ | type | 判定来源面板;含 `week`(WeekPanel,非 PanelView) | `"date" \| "week" \| "month" \| "quarter" \| "year" \| "decade"` | 否 | — |
191
+ | from | — | `Dayjs` | 否 | — |
192
+
193
+ ### PanelView
194
+
195
+ ```typescript
196
+ type PanelView = 'date' | 'month' | 'quarter' | 'year' | 'decade'
197
+ ```
198
+
199
+ 其他组件的类型不在此展开:`InputVariant` 见 `../input/llm.txt`。
200
+
201
+ ### 导出类型
202
+
203
+ 另可从 `@apexhub/apex-ui-react` 导入:`DatePickerPreset`、`DatePickerProps`、`DatePresetValue`、`DateValue`、`DisabledDateFn`、`DisabledDateInfo`、`DisabledRangeDateFn`、`PickerType`、`RangePickerPreset`、`RangePickerProps`、`RangePresetValue`、`RangeValue`(与上文子类型配合使用)。
204
+
205
+ ## 代码演示
206
+
207
+ ### 受控用法
208
+
209
+ 通过 `value` 与 变更事件 由外部管理选中日期;变更事件 同时提供 `Dayjs` 与格式化字符串。
210
+
211
+ ```tsx
212
+ import { DatePicker, type DateValue } from '@apexhub/apex-ui-react'
213
+
214
+ import { useState } from 'react'
215
+
216
+ export default () => {
217
+ const [value, setValue] = useState<DateValue>(null)
218
+
219
+ return (
220
+ <div style={{ padding: 24, minHeight: 360 }}>
221
+ <DatePicker value={value} onChange={(d) => setValue(d)} />
222
+ </div>
223
+ )
224
+ }
225
+ ```
226
+
227
+ ### 范围选择
228
+
229
+ 使用 `RangePicker` 选择起止日期区间。
230
+
231
+ ```tsx
232
+ import { RangePicker } from '@apexhub/apex-ui-react'
233
+
234
+ export default () => (
235
+ <div style={{ padding: 24, minHeight: 360 }}>
236
+ <RangePicker />
237
+ </div>
238
+ )
239
+ ```
240
+
241
+ ### 选择月份
242
+
243
+ 通过 `picker="month"` 切换为 3 列 × 4 行的月份选择面板。默认点击月份后立即提交并关闭;设置 `needConfirm` 后先保留草稿,点击「确定」才提交。「本月」会选择当前月份,并始终停留在月份面板。
244
+
245
+ ```tsx
246
+ import { ApexProvider, DatePicker } from '@apexhub/apex-ui-react'
247
+
248
+ import zhCN from '@apexhub/apex-ui-react/locale/zh_CN'
249
+
250
+ export default () => (
251
+ <ApexProvider theme="dark" locale={zhCN}>
252
+ <div style={{ display: 'flex', gap: 16, padding: 24, minHeight: 360 }}>
253
+ <DatePicker picker="month" placeholder="点击月份立即选择" />
254
+ <DatePicker picker="month" needConfirm placeholder="确认后选择月份" />
255
+ </div>
256
+ </ApexProvider>
257
+ )
258
+ ```
259
+
260
+ ### 禁用
261
+
262
+ `disabled` 禁用整个控件;`disabledDate` 可禁止选中特定日期。
263
+
264
+ ```tsx
265
+ import { DatePicker } from '@apexhub/apex-ui-react'
266
+
267
+ export default () => (
268
+ <div style={{ padding: 24 }}>
269
+ <DatePicker disabled />
270
+ </div>
271
+ )
272
+ ```
273
+
274
+ ### 跨月、跨年查看禁用日期
275
+
276
+ `disabledDate` 按天判断。当月份或年份中仍有至少一天可选时,对应的月/年单元格会保持可进入;只有整个周期都不可选时才禁用,避免月初或年初被禁用后无法继续下钻选择。
277
+
278
+ 下面仅开放 2026 年 8 月 10 日至 20 日。打开面板并切换到年份、月份视图,2026 年和 8 月仍可进入。
279
+
280
+ ```tsx
281
+ import { DatePicker } from '@apexhub/apex-ui-react'
282
+
283
+ import dayjs from 'dayjs'
284
+
285
+ const selectableStart = dayjs('2026-08-10')
286
+
287
+ const selectableEnd = dayjs('2026-08-20')
288
+
289
+ export default () => (
290
+ <div style={{ padding: 24, minHeight: 360 }}>
291
+ <DatePicker
292
+ defaultValue={dayjs('2026-08-15')}
293
+ disabledDate={(current) =>
294
+ current.isBefore(selectableStart, 'day') || current.isAfter(selectableEnd, 'day')
295
+ }
296
+ />
297
+ </div>
298
+ )
299
+ ```
300
+
301
+ ### 只读
302
+
303
+ `readOnly` 为 true 时仅展示选中值,不可打开面板或修改;与 `disabled` 正交,触发器仍可聚焦。
304
+
305
+ ```tsx
306
+ import { DatePicker, RangePicker } from '@apexhub/apex-ui-react'
307
+
308
+ export default () => (
309
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, padding: 24 }}>
310
+ <DatePicker readOnly placeholder="只读,不可打开面板" />
311
+ <RangePicker readOnly placeholder={['开始日期', '结束日期']} />
312
+ </div>
313
+ )
314
+ ```
315
+
316
+ ### 日期时间
317
+
318
+ `showTime` 仅在 `picker="date"` 时生效。`showTime` 设为 `true` 默认精确到秒(面板三列),须点「确定」后才会触发 变更事件;传 `{ format: 'HH:mm' }` 可改为仅选时/分(两列)。
319
+
320
+ ```tsx
321
+ import { DatePicker } from '@apexhub/apex-ui-react'
322
+
323
+ export default () => (
324
+ <div style={{ display: 'flex', gap: 24, flexWrap: 'wrap', alignItems: 'center' }}>
325
+ <DatePicker showTime style={{ width: 240 }} placeholder="精确到秒" />
326
+ <DatePicker showTime={{ format: 'HH:mm' }} style={{ width: 240 }} placeholder="仅时/分" />
327
+ </div>
328
+ )
329
+ ```
330
+
331
+ ### 范围日期时间
332
+
333
+ `RangePicker` 开启 `showTime` 后分步确认:先选起点日期与时间并确定,再选终点日期与时间并确定,两次确认后才触发 变更事件。
334
+
335
+ ```tsx
336
+ import { RangePicker } from '@apexhub/apex-ui-react'
337
+
338
+ export default () => <RangePicker showTime style={{ width: 520 }} />
339
+ ```
340
+
341
+ ### 快捷日期
342
+
343
+ `DatePicker` 的 `presets` 在面板左侧展示业务快捷日期,例如从今天起的 15 天、30 天、45 天。`value` 支持固定 `Dayjs` 或点击时计算的函数,组件保留业务提供的日期与时间。
344
+
345
+ 默认点击立即提交;设置 `needConfirm` 或 `showTime` 后先选中草稿,点击「确定」才触发变更事件。按 Escape 或点击外部取消草稿;清空操作立即清除已提交值。`showToday={false}` 可以隐藏底栏「今天」,呈现设计稿中的快捷区与确认按钮。
346
+
347
+ ```tsx
348
+ import { DatePicker, type DatePickerPreset } from '@apexhub/apex-ui-react'
349
+
350
+ import dayjs from 'dayjs'
351
+
352
+ const presets: DatePickerPreset[] = [15, 30, 45].map((days) => ({
353
+ key: `expires-in-${days}-days`,
354
+ label: `${days}天`,
355
+ // 点击时以当天为起点计算;业务也可返回指定的截止时间。
356
+ value: () => dayjs().add(days, 'day').startOf('day'),
357
+ }))
358
+
359
+ export default () => (
360
+ <DatePicker placeholder="过期时间" presets={presets} needConfirm showToday={false} />
361
+ )
362
+ ```
363
+
364
+ ### 快捷区间
365
+
366
+ 通过 `presets` 在面板左侧提供业务快捷区间;`value` 可以是固定的 `[Dayjs, Dayjs]`,也可以是点击时计算区间的函数。
367
+
368
+ ```tsx
369
+ import { RangePicker, type RangePickerPreset } from '@apexhub/apex-ui-react'
370
+
371
+ import dayjs from 'dayjs'
372
+
373
+ const presets: RangePickerPreset[] = [
374
+ {
375
+ key: 'this-week',
376
+ label: '本周',
377
+ value: () => [dayjs().startOf('week'), dayjs().endOf('week')],
378
+ },
379
+ {
380
+ key: 'last-7-days',
381
+ label: '最近 7 天',
382
+ value: () => [dayjs().subtract(6, 'day').startOf('day'), dayjs().endOf('day')],
383
+ },
384
+ ]
385
+
386
+ export default () => (
387
+ <div style={{ padding: 24, minHeight: 360 }}>
388
+ <RangePicker presets={presets} />
389
+ </div>
390
+ )
391
+ ```
392
+
393
+ ## DOM 结构
394
+
395
+ 源码声明的静态 `data-slot`:`date-picker-shortcuts`、`date-picker-shortcut`、`date-picker-suffix`、`range-picker-trigger`、`date-picker-clear`、`range-picker-panel`、`date-picker-panel-body`、`date-picker-panel-day`、`date-picker-panel-footer`、`date-picker-panel-header`、`date-picker-panel`、`date-picker-panel-time-shortcut`、`date-picker-panel-time`。具体节点随模式和状态出现,不表示固定嵌套顺序。
396
+
397
+ ## 样式定制
398
+
399
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
400
+
401
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
402
+
403
+ ## FAQ
404
+
405
+ ### 必须安装 dayjs 吗?
406
+
407
+ 使用 DatePicker / RangePicker 时需要安装 `dayjs`(peer dependency);未使用日期组件时可不装。
408
+
409
+ ### 占位符文案能随 ApexProvider 切换吗?
410
+
411
+ 可以。未传 `placeholder` 时,组件会读取 ApexProvider 下发的 DatePicker locale;自定义 placeholder 则始终显示你传入的字符串。
412
+
413
+ ### RangePicker 的 `disabledDate` 第二参 `info.from` 是什么?
414
+
415
+ 选择结束日期时,`info.from` 为已选起点,便于实现「结束日期不能早于开始日期」等规则。
416
+
417
+ ### 为什么月初被 `disabledDate` 禁用后,月份仍然可以点击?
418
+
419
+ 月/年单元格代表一个时间周期,不只代表周期首日。只要周期内仍存在可选日期,单元格就会保持可进入,并从第一个可选日期继续下钻;只有周期内所有日期都不可选时才会禁用。
420
+
421
+
422
+ ### `showTime` 为什么选完时间不立刻回填?
423
+
424
+ 开启 `showTime` 时,日期与时间均在面板内草稿态,须点击「确定」后才会更新触发器并触发 `onChange`。RangePicker 还需分别确认起点与终点。
@@ -0,0 +1,171 @@
1
+ # DatePicker Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--button-size-height` | `flex` | `var(--apex-size-32)` | `.apex-button.apex-icon-md-button` |
14
+ | `--button-size-height` | `flex` | `var(--apex-size-24)` | `.apex-button.apex-icon-sm-button` |
15
+ | `--button-size-height` | `flex` | `var(--apex-size-32)` | `.apex-button.apex-link-md-button` |
16
+ | `--button-size-height` | `flex` | `var(--apex-size-24)` | `.apex-button.apex-link-sm-button` |
17
+ | `--button-size-height` | `flex` | `var(--apex-size-32)` | `.apex-button.apex-main-md-button` |
18
+ | `--button-size-height` | `flex` | `var(--apex-size-24)` | `.apex-button.apex-main-sm-button` |
19
+ | `--button-size-height` | `flex` | `var(--apex-size-32)` | `.apex-button.apex-text-md-button` |
20
+ | `--button-size-height` | `flex` | `var(--apex-size-24)` | `.apex-button.apex-text-sm-button` |
21
+ | `--datepicker-button-fill-active` | `background` | `var(--apex-fill-neutral-quaternary)` | `.apex-datepicker-button.apex-default-datepicker-button` |
22
+ | `--datepicker-button-fill-hover` | `background` | `var(--apex-fill-neutral-tertiary)` | `.apex-datepicker-button.apex-default-datepicker-button` |
23
+ | `--datepicker-button-fill-selected` | `background`、`color`、`outline` | `var(--apex-fill-brand-primary)` | `.apex-datepicker-button.apex-default-datepicker-button` |
24
+ | `--datepicker-button-stroke-selected` | `border-color` | `var(--apex-stroke-brand-primary)` | `.apex-datepicker-button.apex-default-datepicker-button` |
25
+ | `--datepicker-button-text-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-datepicker-button.apex-default-datepicker-button` |
26
+ | `--datepicker-button-text-selected` | `color` | `var(--apex-text-neutral-inverse)` | `.apex-datepicker-button.apex-default-datepicker-button` |
27
+ | `--datepicker-fill-container-default` | `background` | `var(--apex-fill-neutral-tertiary)` | `.apex-datepicker.apex-default-datepicker` |
28
+ | `--datepicker-radius-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-datepicker.apex-default-datepicker` |
29
+ | `--datepicker-radius-radius-shortcuts` | `border-radius` | `var(--apex-radius-8)` | `.apex-datepicker.apex-default-datepicker` |
30
+ | `--datepicker-spacing-gap-content` | `column-gap`、`flex`、`gap`、`height`、`margin-top`、`padding`、`padding-bottom`、`width` | `var(--apex-spacing-4)` | `.apex-datepicker.apex-default-datepicker` |
31
+ | `--datepicker-spacing-gap-icon-header` | `gap` | `var(--apex-spacing-0)` | `.apex-datepicker.apex-default-datepicker` |
32
+ | `--datepicker-spacing-gap-shortcuts` | `gap` | `var(--apex-spacing-4)` | `.apex-datepicker.apex-default-datepicker` |
33
+ | `--datepicker-spacing-height-footer` | `min-height` | `var(--apex-spacing-48)` | `.apex-datepicker.apex-default-datepicker` |
34
+ | `--datepicker-spacing-height-header` | `flex`、`height` | `var(--apex-size-40)` | `.apex-datepicker.apex-default-datepicker` |
35
+ | `--datepicker-spacing-padding-x-content` | `padding` | `var(--apex-spacing-16)` | `.apex-datepicker.apex-default-datepicker` |
36
+ | `--datepicker-spacing-padding-x-footer` | `padding` | `var(--apex-spacing-16)` | `.apex-datepicker.apex-default-datepicker` |
37
+ | `--datepicker-spacing-padding-x-header` | `padding` | `var(--apex-spacing-16)` | `.apex-datepicker.apex-default-datepicker` |
38
+ | `--datepicker-spacing-padding-x-shortcuts` | `padding` | `var(--apex-spacing-12)` | `.apex-datepicker.apex-default-datepicker` |
39
+ | `--datepicker-spacing-padding-y-content` | `flex`、`height`、`margin-top`、`padding`、`padding-bottom`、`row-gap` | `var(--apex-spacing-16)` | `.apex-datepicker.apex-default-datepicker` |
40
+ | `--datepicker-spacing-padding-y-footer` | `padding` | `var(--apex-spacing-6)` | `.apex-datepicker.apex-default-datepicker` |
41
+ | `--datepicker-spacing-padding-y-shortcuts` | `padding` | `var(--apex-spacing-8)` | `.apex-datepicker.apex-default-datepicker` |
42
+ | `--datepicker-stroke-container-default` | `background`、`border`、`border-bottom`、`border-left`、`border-right`、`border-top` | `var(--apex-stroke-neutral-quaternary)` | `.apex-datepicker.apex-default-datepicker` |
43
+ | `--datepicker-stroke-stroke-container` | `border`、`border-bottom`、`border-left`、`border-right`、`border-top`、`flex`、`width` | `var(--apex-border-1)` | `.apex-datepicker.apex-default-datepicker` |
44
+ | `--datepicker-text-content-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-datepicker.apex-default-datepicker` |
45
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-cn-body-font` |
46
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-cn-caption-font` |
47
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-cn-heading-1-font` |
48
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-cn-heading-2-font` |
49
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-3-font` |
50
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-4-font` |
51
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-en-body-font` |
52
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-en-caption-font` |
53
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-en-heading-1-font` |
54
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-en-heading-2-font` |
55
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-3-font` |
56
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-4-font` |
57
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-cn-body-font` |
58
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-cn-caption-font` |
59
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-cn-heading-1-font` |
60
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-cn-heading-2-font` |
61
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-3-font` |
62
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-4-font` |
63
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-en-body-font` |
64
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-en-caption-font` |
65
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-en-heading-1-font` |
66
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-en-heading-2-font` |
67
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-3-font` |
68
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-4-font` |
69
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-body-font` |
70
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-caption-font` |
71
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-1-font` |
72
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-2-font` |
73
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-8)` | `.apex-font.apex-text-cn-heading-3-font` |
74
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-4-font` |
75
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-body-font` |
76
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-caption-font` |
77
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-1-font` |
78
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-2-font` |
79
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-3-font` |
80
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-4-font` |
81
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-body-font` |
82
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-caption-font` |
83
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-1-font` |
84
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-2-font` |
85
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-3-font` |
86
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-heading-4-font` |
87
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-body-font` |
88
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-caption-font` |
89
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-1-font` |
90
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-2-font` |
91
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-3-font` |
92
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-heading-4-font` |
93
+ | `--input-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
94
+ | `--input-fill-default` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
95
+ | `--input-fill-disabled` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
96
+ | `--input-fill-disabled` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
97
+ | `--input-fill-error` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-input.apex-default-input` |
98
+ | `--input-fill-error` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
99
+ | `--input-fill-focused` | `background-color` | `var(--apex-fill-neutral-quaternary)` | `.apex-input.apex-default-input` |
100
+ | `--input-fill-focused` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
101
+ | `--input-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-default-input` |
102
+ | `--input-fill-hover` | `background-color` | `var(--apex-fill-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
103
+ | `--input-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
104
+ | `--input-icon-default` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
105
+ | `--input-icon-disabled` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-input.apex-default-input` |
106
+ | `--input-icon-disabled` | `color` | `var(--apex-icon-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
107
+ | `--input-icon-error` | `color` | `var(--apex-icon-error-primary)` | `.apex-input.apex-default-input` |
108
+ | `--input-icon-error` | `color` | `var(--apex-icon-error-primary)` | `.apex-input.apex-elevated-input` |
109
+ | `--input-icon-focused` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
110
+ | `--input-icon-focused` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
111
+ | `--input-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-default-input` |
112
+ | `--input-icon-hover` | `color` | `var(--apex-icon-neutral-primary)` | `.apex-input.apex-elevated-input` |
113
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-16)` | `.apex-input.apex-lg-input` |
114
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-16)` | `.apex-input.apex-md-input` |
115
+ | `--input-icon-icon` | `height`、`padding-right`、`right`、`width` | `var(--apex-icon-14)` | `.apex-input.apex-sm-input` |
116
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-lg-input` |
117
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-md-input` |
118
+ | `--input-radius-radius` | `border-radius` | `var(--apex-radius-8)` | `.apex-input.apex-sm-input` |
119
+ | `--input-spacing-char-counter-gap` | `gap` | `var(--apex-spacing-4)` | `.apex-input.apex-textarea-input` |
120
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-lg-input` |
121
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-md-input` |
122
+ | `--input-spacing-gap-x` | `gap`、`min-height`、`padding`、`padding-right`、`padding-top` | `var(--apex-spacing-4)` | `.apex-input.apex-sm-input` |
123
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-44)` | `.apex-input.apex-lg-input` |
124
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-32)` | `.apex-input.apex-md-input` |
125
+ | `--input-spacing-height` | `height`、`min-height`、`padding-top` | `var(--apex-size-24)` | `.apex-input.apex-sm-input` |
126
+ | `--input-spacing-height-max` | `max-height` | `var(--apex-size-130)` | `.apex-input.apex-textarea-input` |
127
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-lg-input` |
128
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-md-input` |
129
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-8)` | `.apex-input.apex-sm-input` |
130
+ | `--input-spacing-padding-x` | `padding-inline` | `var(--apex-spacing-12)` | `.apex-input.apex-textarea-input` |
131
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-12)` | `.apex-input.apex-lg-input` |
132
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-6)` | `.apex-input.apex-md-input` |
133
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-4)` | `.apex-input.apex-sm-input` |
134
+ | `--input-spacing-padding-y` | `padding-block` | `var(--apex-spacing-6)` | `.apex-input.apex-textarea-input` |
135
+ | `--input-spacing-width-min` | `min-width`、`width` | `var(--apex-size-120)` | `.apex-input.apex-lg-input` |
136
+ | `--input-spacing-width-min` | `min-width`、`width` | `var(--apex-size-120)` | `.apex-input.apex-md-input` |
137
+ | `--input-spacing-width-min` | `min-width`、`width` | `var(--apex-size-120)` | `.apex-input.apex-sm-input` |
138
+ | `--input-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-default-input` |
139
+ | `--input-stroke-default` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-elevated-input` |
140
+ | `--input-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-default-input` |
141
+ | `--input-stroke-disabled` | `border-color` | `var(--apex-stroke-neutral-quaternary)` | `.apex-input.apex-elevated-input` |
142
+ | `--input-stroke-error` | `border-color` | `var(--apex-stroke-error-primary)` | `.apex-input.apex-default-input` |
143
+ | `--input-stroke-error` | `border-color` | `var(--apex-stroke-error-primary)` | `.apex-input.apex-elevated-input` |
144
+ | `--input-stroke-focused` | `background`、`border-color` | `var(--apex-stroke-brand-primary)` | `.apex-input.apex-default-input` |
145
+ | `--input-stroke-focused` | `background`、`border-color` | `var(--apex-stroke-brand-primary)` | `.apex-input.apex-elevated-input` |
146
+ | `--input-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-input.apex-default-input` |
147
+ | `--input-stroke-hover` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-input.apex-elevated-input` |
148
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-lg-input` |
149
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-md-input` |
150
+ | `--input-stroke-stroke` | `border-width`、`padding-block` | `var(--apex-border-1)` | `.apex-input.apex-sm-input` |
151
+ | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
152
+ | `--input-text-filled-default` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
153
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-secondary)` | `.apex-input.apex-default-input` |
154
+ | `--input-text-filled-disabled` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
155
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
156
+ | `--input-text-filled-error` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
157
+ | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
158
+ | `--input-text-filled-focused` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
159
+ | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
160
+ | `--input-text-filled-hover` | `-webkit-text-fill-color`、`caret-color`、`color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
161
+ | `--input-text-placeholder-default` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
162
+ | `--input-text-placeholder-default` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
163
+ | `--input-text-placeholder-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-default-input` |
164
+ | `--input-text-placeholder-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-input.apex-elevated-input` |
165
+ | `--input-text-placeholder-error` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
166
+ | `--input-text-placeholder-error` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
167
+ | `--input-text-placeholder-focused` | `color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-default-input` |
168
+ | `--input-text-placeholder-focused` | `color` | `var(--apex-text-neutral-primary)` | `.apex-input.apex-elevated-input` |
169
+ | `--input-text-placeholder-hover` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-default-input` |
170
+ | `--input-text-placeholder-hover` | `color` | `var(--apex-text-neutral-tertiary)` | `.apex-input.apex-elevated-input` |
171
+ | `--scrollbar-fill-thumb-default` | `scrollbar-color` | `var(--apex-fill-neutral-quinary)` | `.apex-scrollbar.apex-default-scrollbar` |