@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,368 @@
1
+ # ApexProvider
2
+
3
+ > ApexProvider:在应用或微前端子应用最外层包裹,确保组件库 Token、主题、滚动条样式在整个组件树生效。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`ApexProvider`、`useConfig`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { ApexProvider, Button } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => (
19
+ <ApexProvider theme="dark">
20
+ <Button type="primary">主题作用域内的按钮</Button>
21
+ </ApexProvider>
22
+ )
23
+ ```
24
+
25
+ ## 何时使用
26
+
27
+ - 在应用或微前端子应用最外层包裹,确保组件库 Token、主题、滚动条样式在整个组件树生效。
28
+ - 需要切换 light / dark 主题,或统一中文 / 英文等语言环境下的内置文案。
29
+ - ApexProvider 不负责页面标题、按钮 label、Toast 等业务文案。
30
+
31
+ ## API
32
+
33
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
34
+
35
+ ### ApexProvider
36
+
37
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
38
+ | --- | --- | --- | --- | --- |
39
+ | theme | 主题模式,写入 `data-theme`(Provider 根 + 浮层根)。<br>`'light'` 走 `:root` 亮色 Token,`'dark'` 走 `[data-theme='dark']` 覆盖。 | `"light" \| "dark"` | 否 | `'dark'` |
40
+ | locale | 语言包对象;不传时子组件回退各自内置默认值(英文) | `Locale` | 否 | — |
41
+
42
+ ### ApexTheme
43
+
44
+ Apex UI 主题模式
45
+
46
+ ```typescript
47
+ type ApexTheme = 'light' | 'dark'
48
+ ```
49
+
50
+ ### PaginationLocale
51
+
52
+ Pagination 内置文案
53
+
54
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
55
+ | --- | --- | --- | --- | --- |
56
+ | itemsPerPage | — | `string` | 是 | — |
57
+ | jumpTo | — | `string` | 是 | — |
58
+ | page | — | `string` | 是 | — |
59
+ | prevPage | — | `string` | 是 | — |
60
+ | nextPage | — | `string` | 是 | — |
61
+ | prev5 | — | `string` | 是 | — |
62
+ | next5 | — | `string` | 是 | — |
63
+ | nav | 根 `<nav>` 的 aria-label | `string` | 是 | — |
64
+ | pageButton | 页码按钮 aria-label,如 `Page 3` | `(page: number) => string` | 是 | — |
65
+
66
+ ### DatePickerLocale
67
+
68
+ DatePicker 内置文案
69
+
70
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
71
+ | --- | --- | --- | --- | --- |
72
+ | weekStartsOn | — | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | 是 | — |
73
+ | weekdaysShort | — | `readonly string[]` | 是 | — |
74
+ | monthsShort | — | `readonly string[]` | 是 | — |
75
+ | buttons | — | `{ today: string /** WeekPicker 底部快捷选择当前周;缺省时回退到 today 文案。 */ thisWeek?: string /** MonthPicker 底部快捷选择当前月份;缺省时回退到 today 文案。 */ thisMonth?: string /** QuarterPicker 底部快捷选择当前季度;缺省时回退到 today 文案。 */ thisQuarter?: string /** YearPicker 底部快捷选择当前年;缺省时回退到 today 文案。 */ thisYear?: string now: string /** 面板底栏「重置 / Reset」按钮文案 */ clear: string confirm: string }` | 是 | — |
76
+ | panel | — | `{ yearSuffix: string monthSuffix: string weekSuffix: string quarterPrefix: string quarterSuffix: string decadeFormat: (start: number, end: number) => string }` | 是 | — |
77
+ | separator | — | `string` | 是 | — |
78
+ | placeholder | — | `{ date: string week: string month: string quarter: string year: string rangeStart: string rangeEnd: string }` | 是 | — |
79
+ | aria | — | `{ clear: string panel: string rangePanel: string prevYear: string prevMonth: string nextMonth: string nextYear: string switchToYearView: (year: number) => string switchToMonthView: (month: number) => string decadeRange: (start: number, end: number) => string }` | 是 | — |
80
+
81
+ ### FormLocale
82
+
83
+ Form 内置文案
84
+
85
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
86
+ | --- | --- | --- | --- | --- |
87
+ | optional | requiredMark="optional" 时非必填项后的标记文案 | `string` | 否 | — |
88
+ | defaultValidateMessages | 校验提示模板,与 Form.validateMessages 深合并 | `ValidateMessages` | 是 | — |
89
+
90
+ ### PickerLocale
91
+
92
+ Select / Cascader / TreeSelect 共用内置文案
93
+
94
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
95
+ | --- | --- | --- | --- | --- |
96
+ | placeholder | — | `string` | 是 | — |
97
+ | notFoundContent | — | `string` | 是 | — |
98
+
99
+ ### TableLocale
100
+
101
+ Table 内置文案
102
+
103
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
104
+ | --- | --- | --- | --- | --- |
105
+ | emptyText | — | `string` | 是 | — |
106
+
107
+ ### ModalLocale
108
+
109
+ Modal / Drawer 内置文案
110
+
111
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
112
+ | --- | --- | --- | --- | --- |
113
+ | ok | — | `string` | 是 | — |
114
+ | cancel | — | `string` | 是 | — |
115
+ | close | — | `string` | 是 | — |
116
+
117
+ ### UploadLocale
118
+
119
+ Upload 内置文案
120
+
121
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
122
+ | --- | --- | --- | --- | --- |
123
+ | upload | — | `string` | 是 | — |
124
+ | dragger | — | `string` | 是 | — |
125
+ | retry | — | `string` | 是 | — |
126
+ | preview | — | `string` | 是 | — |
127
+ | remove | — | `string` | 是 | — |
128
+ | download | — | `string` | 是 | — |
129
+ | uploadExceedMaxCount | — | `(maxCount: number) => string` | 是 | — |
130
+ | uploadExceedMaxSize | — | `(maxSize: string) => string` | 是 | — |
131
+
132
+ ### ImageLocale
133
+
134
+ Image preview built-in labels.
135
+
136
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
137
+ | --- | --- | --- | --- | --- |
138
+ | preview | — | `string` | 是 | — |
139
+ | previewFullscreen | — | `string` | 是 | — |
140
+ | previewPrevious | — | `string` | 是 | — |
141
+ | previewNext | — | `string` | 是 | — |
142
+ | previewRotateRight | — | `string` | 是 | — |
143
+ | previewRotateLeft | — | `string` | 是 | — |
144
+ | previewZoomIn | — | `string` | 是 | — |
145
+ | previewZoomOut | — | `string` | 是 | — |
146
+ | previewOneToOne | — | `string` | 是 | — |
147
+ | previewAdaptToPage | — | `string` | 是 | — |
148
+
149
+ ### TypographyLocale
150
+
151
+ Typography 内置文案(copy / edit / ellipsis 操作)
152
+
153
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
154
+ | --- | --- | --- | --- | --- |
155
+ | copy | — | `string` | 是 | — |
156
+ | copied | — | `string` | 是 | — |
157
+ | edit | — | `string` | 是 | — |
158
+ | editText | — | `string` | 是 | — |
159
+ | save | — | `string` | 是 | — |
160
+ | cancel | — | `string` | 是 | — |
161
+ | expand | — | `string` | 是 | — |
162
+ | collapse | — | `string` | 是 | — |
163
+ | expandAll | — | `string` | 是 | — |
164
+
165
+ ### Locale
166
+
167
+ Apex UI 语言包。
168
+
169
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
170
+ | --- | --- | --- | --- | --- |
171
+ | locale | BCP 47 语言标签,如 `zh-CN`、`en-US` | `string` | 是 | — |
172
+ | Pagination | — | `PaginationLocale` | 否 | — |
173
+ | DatePicker | — | `DatePickerLocale` | 否 | — |
174
+ | Form | — | `FormLocale` | 否 | — |
175
+ | Select | — | `PickerLocale` | 否 | — |
176
+ | Cascader | — | `PickerLocale` | 否 | — |
177
+ | TreeSelect | — | `PickerLocale` | 否 | — |
178
+ | Table | — | `TableLocale` | 否 | — |
179
+ | Modal | — | `ModalLocale` | 否 | — |
180
+ | Upload | — | `UploadLocale` | 否 | — |
181
+ | Image | — | `ImageLocale` | 否 | — |
182
+ | Typography | — | `TypographyLocale` | 否 | — |
183
+
184
+ ### ConfigContextValue
185
+
186
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
187
+ | --- | --- | --- | --- | --- |
188
+ | theme | — | `"light" \| "dark"` | 否 | — |
189
+ | locale | — | `Locale` | 否 | — |
190
+
191
+ 其他组件的类型不在此展开:`ValidateMessages` 见 `../form/llm.txt`。
192
+
193
+ ### 导出类型
194
+
195
+ 另可从 `@apexhub/apex-ui-react` 导入:`ApexProviderProps`、`ApexTheme`、`ConfigContextValue`、`DatePickerLocale`、`FormLocale`、`ImageLocale`、`Locale`、`ModalLocale`、`PaginationLocale`、`PickerLocale`、`TableLocale`、`TypographyLocale`、`UploadLocale`(与上文子类型配合使用)。
196
+
197
+ ## 代码演示
198
+
199
+ ### 切换语言包
200
+
201
+ 通过开关在英文与中文语言包之间切换,观察 Form、Pagination、DatePicker 内置文案联动。`Form.Item` 上自定义的 `rules.message` 不会被 ApexProvider 覆盖。
202
+
203
+ ```tsx
204
+ import {
205
+ ApexProvider,
206
+ Button,
207
+ DatePicker,
208
+ Form,
209
+ Input,
210
+ Pagination,
211
+ Switch,
212
+ Typography,
213
+ } from '@apexhub/apex-ui-react'
214
+
215
+ import enUS from '@apexhub/apex-ui-react/locale/en_US'
216
+
217
+ import zhCN from '@apexhub/apex-ui-react/locale/zh_CN'
218
+
219
+ import { useState } from 'react'
220
+
221
+ const LOCALES = [enUS, zhCN] as const
222
+
223
+ const LOCALE_LABELS = ['English', '中文'] as const
224
+
225
+ const canvasStyle: React.CSSProperties = {
226
+ padding: 24,
227
+ display: 'flex',
228
+ flexDirection: 'column',
229
+ gap: 24,
230
+ maxWidth: 640,
231
+ }
232
+
233
+ export default () => {
234
+ const [localeIndex, setLocaleIndex] = useState(0)
235
+ const locale = LOCALES[localeIndex]
236
+
237
+ return (
238
+ <ApexProvider theme="dark" locale={locale}>
239
+ <div style={canvasStyle}>
240
+ <label htmlFor="locale-slider" style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
241
+ <Switch
242
+ id="locale-switch"
243
+ checked={localeIndex === 1}
244
+ onChange={(checked) => setLocaleIndex(checked ? 1 : 0)}
245
+ aria-label="Language"
246
+ />
247
+ <Typography.Text>{LOCALE_LABELS[localeIndex]}</Typography.Text>
248
+ </label>
249
+
250
+ <Form key={localeIndex} name="locale-demo" wrapperCol={{ span: 12 }} labelCol={{ span: 4 }}>
251
+ <Form.Item name="username" label="Username" rules={[{ required: true }]}>
252
+ <Input placeholder="Username" />
253
+ </Form.Item>
254
+ <Form.Item
255
+ name="feedback2"
256
+ label="feedback2"
257
+ rules={[{ required: true, min: 10, message: 'I DONT CHANGE' }]}
258
+ >
259
+ <Input placeholder="say something" />
260
+ </Form.Item>
261
+ <Form.Item name="feedback" label="feedback" rules={[{ required: true, min: 10 }]}>
262
+ <Input type="textarea" rows={4} placeholder="say something" />
263
+ </Form.Item>
264
+
265
+ <Form.Item style={{ marginLeft: 'auto' }}>
266
+ <Button type="primary" htmlType="submit">
267
+ Submit
268
+ </Button>
269
+ </Form.Item>
270
+ </Form>
271
+
272
+ <Pagination total={60} defaultCurrent={1} showQuickJumper showSizeChanger />
273
+
274
+ <DatePicker />
275
+ </div>
276
+ </ApexProvider>
277
+ )
278
+ }
279
+ ```
280
+
281
+ ### 切换主题
282
+
283
+ `theme` 支持 `'light'` 与 `'dark'` 两套完整 Token。不传时默认 `'dark'`;亮色产品请显式传 `theme="light"`。下面从 light 开始,拨到 dark 可对比两套 Alias。
284
+
285
+ ```tsx
286
+ import { ApexProvider, Button, Card, Input, Switch, Typography } from '@apexhub/apex-ui-react'
287
+
288
+ import { type CSSProperties, useState } from 'react'
289
+
290
+ const canvasStyle: CSSProperties = {
291
+ padding: 24,
292
+ display: 'flex',
293
+ flexDirection: 'column',
294
+ gap: 16,
295
+ maxWidth: 480,
296
+ background: 'var(--apex-fill-neutral-secondary)',
297
+ borderRadius: 8,
298
+ }
299
+
300
+ export default () => {
301
+ const [theme, setTheme] = useState<'light' | 'dark'>('light')
302
+
303
+ return (
304
+ <ApexProvider theme={theme}>
305
+ <div style={canvasStyle}>
306
+ <label htmlFor="theme-switch" style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
307
+ <Switch
308
+ id="theme-switch"
309
+ checked={theme === 'dark'}
310
+ onChange={(checked) => setTheme(checked ? 'dark' : 'light')}
311
+ aria-label="Theme"
312
+ />
313
+ <Typography.Text>theme: {theme}</Typography.Text>
314
+ </label>
315
+ <Input placeholder="输入内容查看主题 Token" />
316
+ <div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
317
+ <Button type="primary">主要按钮</Button>
318
+ <Button>默认按钮</Button>
319
+ </div>
320
+ <Card title="卡片">light / dark 两套 Token 都已交付,切换后 Alias 与组件色一起变。</Card>
321
+ </div>
322
+ </ApexProvider>
323
+ )
324
+ }
325
+ ```
326
+
327
+ ## DOM 结构
328
+
329
+ 源码声明的静态 `data-slot`:`provider`。具体节点随模式和状态出现,不表示固定嵌套顺序。
330
+
331
+ ## 样式定制
332
+
333
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
334
+
335
+ ## FAQ
336
+
337
+ ### ConfigProvider 去哪了?
338
+
339
+ 已合并进 `ApexProvider`(`locale` Context)。迁移:`<ConfigProvider locale={…}>` → `<ApexProvider locale={…}>`;原双层 Provider 合并为一层。
340
+
341
+ 浮层挂载容器(`getPopupContainer`)由各浮层组件自行提供(如 Select、DatePicker、Cascader),不在 ApexProvider 上配置。
342
+
343
+
344
+ ### 能嵌套 ApexProvider 局部换 locale 或 theme 吗?
345
+
346
+ 不支持。请改外层 `locale` / `theme` prop。个别组件支持组件级 `locale`(Pagination、Form、DatePicker 等)。
347
+
348
+ ### 不传 `theme` 时默认是什么?
349
+
350
+ 默认 `'dark'`。亮色产品必须写 `<ApexProvider theme="light">`。CSS `:root` 本身是亮色基线;只有包了 Provider 且不传 `theme` 时才会落到暗色。
351
+
352
+ ### light 和 dark 都完整支持吗?
353
+
354
+ 是。两套 foundation Token 都已交付:light 使用 `:root`(`grey-light-*`),dark 使用 `[data-theme='dark']` 覆盖(`grey-dark-*`)。组件局部 Token 引用 Alias,会随主题一起变。
355
+
356
+ ### ApexProvider 会翻译我写在 Form.Item 里的 `rules.message` 吗?
357
+
358
+ 不会。你在 `rules` 里写死的字符串属于业务文案;ApexProvider 仅注入组件库内置的校验模板。
359
+
360
+
361
+ ### 语言包怎么按需加载?
362
+
363
+ 从子路径单独导入,例如 `import zhCN from '@apexhub/apex-ui-react/locale/zh_CN'`,再传给 `<ApexProvider locale={zhCN}>`。
364
+
365
+
366
+ ### 不传 `locale` 时默认是什么语言?
367
+
368
+ 各组件回退各自内置默认值,一般为英文。