@apexhub/apex-ui-react 0.0.0-stage → 1.2.2

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 +40727 -0
  5. package/dist/index.d.ts +6873 -0
  6. package/dist/index.mjs +40711 -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 +369 -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 +143 -0
  15. package/dist/llm/breadcrumb.txt +251 -0
  16. package/dist/llm/button.tokens.txt +470 -0
  17. package/dist/llm/button.txt +270 -0
  18. package/dist/llm/card.tokens.txt +29 -0
  19. package/dist/llm/card.txt +118 -0
  20. package/dist/llm/cascader.tokens.txt +261 -0
  21. package/dist/llm/cascader.txt +917 -0
  22. package/dist/llm/checkbox.tokens.txt +36 -0
  23. package/dist/llm/checkbox.txt +343 -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 +428 -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 +28 -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 +491 -0
  41. package/dist/llm/input.tokens.txt +136 -0
  42. package/dist/llm/input.txt +424 -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 +100 -0
  46. package/dist/llm/menu.txt +687 -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 +35 -0
  54. package/dist/llm/pagination.txt +217 -0
  55. package/dist/llm/popover.tokens.txt +18 -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 +26 -0
  60. package/dist/llm/radio.txt +385 -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 +831 -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 +1049 -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 +75 -0
  78. package/dist/llm/tag.txt +304 -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 +175 -0
  82. package/dist/llm/tree-select.txt +772 -0
  83. package/dist/llm/tree.tokens.txt +34 -0
  84. package/dist/llm/tree.txt +501 -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 +205 -0
  88. package/dist/llm/upload.txt +708 -0
  89. package/dist/llms-full.txt +16826 -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 +20095 -0
  99. package/dist/zh_CN.d.ts +191 -0
  100. package/llms-full.txt +16826 -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 +369 -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 +143 -0
  113. package/src/button/llm.txt +270 -0
  114. package/src/button/tokens.txt +470 -0
  115. package/src/card/llm.txt +118 -0
  116. package/src/card/tokens.txt +29 -0
  117. package/src/cascader/llm.txt +917 -0
  118. package/src/cascader/tokens.txt +261 -0
  119. package/src/checkbox/llm.txt +343 -0
  120. package/src/checkbox/tokens.txt +36 -0
  121. package/src/collapse/llm.txt +330 -0
  122. package/src/collapse/tokens.txt +84 -0
  123. package/src/date-picker/llm.txt +428 -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 +28 -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 +424 -0
  137. package/src/input/tokens.txt +136 -0
  138. package/src/input-number/llm.txt +491 -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 +687 -0
  143. package/src/menu/tokens.txt +100 -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 +217 -0
  151. package/src/pagination/tokens.txt +35 -0
  152. package/src/popover/llm.txt +233 -0
  153. package/src/popover/tokens.txt +18 -0
  154. package/src/progress/llm.txt +279 -0
  155. package/src/progress/tokens.txt +83 -0
  156. package/src/radio/llm.txt +385 -0
  157. package/src/radio/tokens.txt +26 -0
  158. package/src/rate/llm.txt +241 -0
  159. package/src/rate/tokens.txt +20 -0
  160. package/src/select/llm.txt +831 -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 +1049 -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 +304 -0
  175. package/src/tag/tokens.txt +75 -0
  176. package/src/tooltip/llm.txt +304 -0
  177. package/src/tooltip/tokens.txt +22 -0
  178. package/src/tree/llm.txt +501 -0
  179. package/src/tree/tokens.txt +34 -0
  180. package/src/tree-select/llm.txt +772 -0
  181. package/src/tree-select/tokens.txt +175 -0
  182. package/src/typography/llm.txt +413 -0
  183. package/src/typography/tokens.txt +60 -0
  184. package/src/upload/llm.txt +708 -0
  185. package/src/upload/tokens.txt +205 -0
@@ -0,0 +1,330 @@
1
+ # Collapse
2
+
3
+ > Collapse:页面信息量大,需要将次要内容默认折叠、按需展开时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Collapse`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Collapse } from '@apexhub/apex-ui-react'
15
+
16
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
17
+
18
+ import '@apexhub/apex-ui-react/style.css'
19
+
20
+ const COLLAPSE_ITEMS: CollapseItem[] = [
21
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
22
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
23
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
24
+ ]
25
+
26
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
27
+
28
+ export default () => (
29
+ <div style={collapseWrapStyle}>
30
+ <Collapse items={COLLAPSE_ITEMS} defaultActiveKey="1" />
31
+ </div>
32
+ )
33
+ ```
34
+
35
+ ## 何时使用
36
+
37
+ - 页面信息量大,需要将次要内容默认折叠、按需展开时。
38
+ - FAQ、帮助文档、表单高级选项等「标题 + 可隐藏正文」结构时。
39
+ - 需要手风琴模式(同一时间只展开一项)或受控展开指定面板时。
40
+
41
+ ## API
42
+
43
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
44
+
45
+ ### Collapse
46
+
47
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
48
+ | --- | --- | --- | --- | --- |
49
+ | items | 折叠面板列表。 | `CollapseItem[]` | 否 | `[]` |
50
+ | activeKey | 受控展开 key;`accordion=true` 时使用单个 string。 | `CollapseActiveKey` | 否 | `undefined` |
51
+ | defaultActiveKey | 非受控初始展开 key。 | `CollapseActiveKey` | 否 | `undefined` |
52
+ | onChange | 展开项变化回调。 | `(key: CollapseActiveKey) => void` | 否 | `undefined` |
53
+ | accordion | 是否启用手风琴模式;开启后同一时间只允许一个面板展开。 | `boolean` | 否 | `false` |
54
+ | collapsible | 全局折叠触发方式。<br>- `header`:点击头部触发展开/收起<br>- `disabled`:禁用所有面板展开/收起 | `"disabled" \| "header"` | 否 | `'header'` |
55
+ | expandIconPosition | 展开箭头位置。<br>- `start`:标题前<br>- `end`:标题后 | `"start" \| "end"` | 否 | `'start'` |
56
+ | variant | 视觉风格,映射 `apex-default-collapse` / `apex-clean-collapse` token 作用域。 | `"default" \| "clean"` | 否 | `'default'` |
57
+ | className | 根节点类名,作用于 `data-slot="collapse"`。 | `React.ComponentProps<typeof AccordionPrimitive.Root>['className']` | 否 | `undefined` |
58
+ | style | 根节点样式;禁止硬编码色值,优先使用 CSS Token。 | `React.ComponentProps<typeof AccordionPrimitive.Root>['style']` | 否 | `undefined` |
59
+ | ref | 转发到根节点。 | `React.ComponentProps<typeof AccordionPrimitive.Root>['ref']` | 否 | `undefined` |
60
+
61
+ ### CollapseKey
62
+
63
+ ```typescript
64
+ type CollapseKey = string
65
+ ```
66
+
67
+ ### CollapseActiveKey
68
+
69
+ ```typescript
70
+ type CollapseActiveKey = CollapseKey | CollapseKey[]
71
+ ```
72
+
73
+ ### CollapseCollapsible
74
+
75
+ ```typescript
76
+ type CollapseCollapsible = 'header' | 'disabled'
77
+ ```
78
+
79
+ ### CollapseExpandIconPosition
80
+
81
+ ```typescript
82
+ type CollapseExpandIconPosition = 'start' | 'end'
83
+ ```
84
+
85
+ ### CollapseVariant
86
+
87
+ Collapse 视觉风格:`default` 分区头背景;`clean` 简洁无头部分割线。
88
+
89
+ ```typescript
90
+ type CollapseVariant = 'default' | 'clean'
91
+ ```
92
+
93
+ ### CollapseItem
94
+
95
+ Collapse 面板项。
96
+
97
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
98
+ | --- | --- | --- | --- | --- |
99
+ | key | 面板唯一标识;仅支持字符串,作为展开状态 value 使用。 | `CollapseKey` | 是 | — |
100
+ | label | 面板标题。 | `React.ReactNode` | 是 | — |
101
+ | children | 面板内容。 | `React.ReactNode` | 否 | — |
102
+ | disabled | 是否禁用该面板。 | `boolean` | 否 | `false` |
103
+ | collapsible | 单项折叠触发方式。<br>- `header`:点击头部触发展开/收起<br>- `disabled`:禁用该项展开/收起 | `"disabled" \| "header"` | 否 | `'header'` |
104
+ | showArrow | 是否展示展开箭头。 | `boolean` | 否 | `true` |
105
+
106
+ ### 导出类型
107
+
108
+ 另可从 `@apexhub/apex-ui-react` 导入:`CollapseActiveKey`、`CollapseItem`、`CollapseProps`、`CollapseVariant`(与上文子类型配合使用)。
109
+
110
+ ## 代码演示
111
+
112
+ ### 简洁风格
113
+
114
+ `variant="clean"` 为无分区头背景的简洁样式。
115
+
116
+ ```tsx
117
+ import { Collapse } from '@apexhub/apex-ui-react'
118
+
119
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
120
+
121
+ const COLLAPSE_ITEMS: CollapseItem[] = [
122
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
123
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
124
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
125
+ ]
126
+
127
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
128
+
129
+ export default () => (
130
+ <div style={collapseWrapStyle}>
131
+ <Collapse items={COLLAPSE_ITEMS} variant="clean" defaultActiveKey="1" />
132
+ </div>
133
+ )
134
+ ```
135
+
136
+ ### 风格对比
137
+
138
+ 并排对比 `default` 与 `clean` 两种视觉风格。
139
+
140
+ ```tsx
141
+ import { Collapse } from '@apexhub/apex-ui-react'
142
+
143
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
144
+
145
+ const COLLAPSE_ITEMS: CollapseItem[] = [
146
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
147
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
148
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
149
+ ]
150
+
151
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
152
+
153
+ export default () => (
154
+ <div style={{ ...collapseWrapStyle, display: 'flex', flexDirection: 'column', gap: 24 }}>
155
+ <Collapse items={COLLAPSE_ITEMS} variant="default" defaultActiveKey="1" />
156
+ <Collapse items={COLLAPSE_ITEMS} variant="clean" defaultActiveKey="1" />
157
+ </div>
158
+ )
159
+ ```
160
+
161
+ ### 手风琴模式
162
+
163
+ `accordion` 为 `true` 时,同一时间仅允许展开一个面板。
164
+
165
+ ```tsx
166
+ import { Collapse } from '@apexhub/apex-ui-react'
167
+
168
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
169
+
170
+ const COLLAPSE_ITEMS: CollapseItem[] = [
171
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
172
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
173
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
174
+ ]
175
+
176
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
177
+
178
+ export default () => (
179
+ <div style={collapseWrapStyle}>
180
+ <Collapse items={COLLAPSE_ITEMS} accordion defaultActiveKey="1" />
181
+ </div>
182
+ )
183
+ ```
184
+
185
+ ### 受控用法
186
+
187
+ 通过 `activeKey` 与 变更事件 由外部控制当前展开的面板。
188
+
189
+ ```tsx
190
+ import type { CollapseActiveKey } from '@apexhub/apex-ui-react'
191
+
192
+ import { Collapse } from '@apexhub/apex-ui-react'
193
+
194
+ import { useState } from 'react'
195
+
196
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
197
+
198
+ const COLLAPSE_ITEMS: CollapseItem[] = [
199
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
200
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
201
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
202
+ ]
203
+
204
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
205
+
206
+ export default () => {
207
+ const [activeKey, setActiveKey] = useState<CollapseActiveKey>('2')
208
+
209
+ return (
210
+ <div style={{ ...collapseWrapStyle, display: 'flex', flexDirection: 'column', gap: 8 }}>
211
+ <Collapse items={COLLAPSE_ITEMS} accordion activeKey={activeKey} onChange={setActiveKey} />
212
+ <span style={{ fontSize: 12 }}>
213
+ 当前展开:
214
+ {Array.isArray(activeKey) ? activeKey.join(', ') : activeKey}
215
+ </span>
216
+ </div>
217
+ )
218
+ }
219
+ ```
220
+
221
+ ### 禁用项
222
+
223
+ 在 `items` 中为单项设置 `disabled: true`,或通过 `collapsible="disabled"` 禁止展开。
224
+
225
+ ```tsx
226
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
227
+
228
+ import { Collapse } from '@apexhub/apex-ui-react'
229
+
230
+ const COLLAPSE_ITEMS: CollapseItem[] = [
231
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
232
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
233
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
234
+ ]
235
+
236
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
237
+
238
+ const items: CollapseItem[] = [
239
+ { key: '1', label: '可展开面板', children: '可正常展开、收起。' },
240
+ { key: '2', label: '已禁用(disabled)', children: '不可点击', disabled: true },
241
+ {
242
+ key: '3',
243
+ label: '不可折叠(collapsible: disabled)',
244
+ children: '保持收起',
245
+ collapsible: 'disabled',
246
+ },
247
+ ]
248
+
249
+ export default () => (
250
+ <div style={collapseWrapStyle}>
251
+ <Collapse items={items} defaultActiveKey="1" />
252
+ </div>
253
+ )
254
+ ```
255
+
256
+ ### 展开图标位置
257
+
258
+ `expandIconPosition` 控制箭头在标题前(`start`)或后(`end`)。
259
+
260
+ ```tsx
261
+ import { Collapse } from '@apexhub/apex-ui-react'
262
+
263
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
264
+
265
+ const COLLAPSE_ITEMS: CollapseItem[] = [
266
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
267
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
268
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
269
+ ]
270
+
271
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
272
+
273
+ export default () => (
274
+ <div style={{ ...collapseWrapStyle, display: 'flex', flexDirection: 'column', gap: 24 }}>
275
+ <Collapse items={COLLAPSE_ITEMS} expandIconPosition="start" defaultActiveKey="1" />
276
+ <Collapse items={COLLAPSE_ITEMS} expandIconPosition="end" defaultActiveKey="1" />
277
+ </div>
278
+ )
279
+ ```
280
+
281
+ ### 无箭头
282
+
283
+ 单项设 `showArrow` 设为 `false` 可隐藏箭头,仍可通过点击标题展开(除非禁用)。
284
+
285
+ ```tsx
286
+ import { Collapse } from '@apexhub/apex-ui-react'
287
+
288
+ import type { CollapseItem } from '@apexhub/apex-ui-react'
289
+
290
+ const COLLAPSE_ITEMS: CollapseItem[] = [
291
+ { key: '1', label: '面板一', children: '这是面板一的内容。' },
292
+ { key: '2', label: '面板二', children: '这是面板二的内容。' },
293
+ { key: '3', label: '面板三', children: '这是面板三的内容。' },
294
+ ]
295
+
296
+ const collapseWrapStyle = { width: '100%', minWidth: 560, maxWidth: 720 } as const
297
+
298
+ export default () => (
299
+ <div style={collapseWrapStyle}>
300
+ <Collapse
301
+ defaultActiveKey="1"
302
+ items={[{ key: '1', label: '无箭头', children: '仍可点击标题展开', showArrow: false }]}
303
+ />
304
+ </div>
305
+ )
306
+ ```
307
+
308
+ ## DOM 结构
309
+
310
+ 源码声明的静态 `data-slot`:`collapse-item`、`collapse-header`、`collapse-trigger`、`collapse-icon`、`collapse-label`、`collapse-content`、`collapse-body`。具体节点随模式和状态出现,不表示固定嵌套顺序。
311
+
312
+ ## 样式定制
313
+
314
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
315
+
316
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
317
+
318
+ ## FAQ
319
+
320
+ ### 面板 `key` 可以用数字吗?
321
+
322
+ 不可以。仅支持 `string` 类型的 key;从 antd 迁移时请将数字 key 转为字符串。
323
+
324
+ ### 支持在标题右侧放自定义操作(extra)吗?
325
+
326
+ 当前版本未实现 `extra` 或仅点击图标展开;标题区域点击即触发展开/收起。
327
+
328
+ ### `collapsible="icon"` 支持吗?
329
+
330
+ 不支持。v1 仅支持 `'header'`(点击整行标题)与 `'disabled'`(禁止展开)。
@@ -0,0 +1,84 @@
1
+ # Collapse Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--collapse-fill-content-default` | `background-color` | `var(--apex-fill-neutral-primary)` | `.apex-collapse.apex-clean-collapse` |
14
+ | `--collapse-fill-content-default` | `background-color` | `var(--apex-fill-neutral-primary)` | `.apex-collapse.apex-default-collapse` |
15
+ | `--collapse-fill-header-default` | `background-color` | `var(--apex-fill-neutral-primary)` | `.apex-collapse.apex-clean-collapse` |
16
+ | `--collapse-fill-header-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-collapse.apex-default-collapse` |
17
+ | `--collapse-radius-radius-container` | `border-radius` | `var(--apex-radius-8)` | `.apex-collapse.apex-default-collapse` |
18
+ | `--collapse-spacing-gap-header` | `gap` | `var(--apex-spacing-4)` | `.apex-collapse.apex-default-collapse` |
19
+ | `--collapse-spacing-height-header` | `min-height` | `var(--apex-size-32)` | `.apex-collapse.apex-default-collapse` |
20
+ | `--collapse-spacing-padding-x-header` | `padding` | `var(--apex-spacing-4)` | `.apex-collapse.apex-default-collapse` |
21
+ | `--collapse-spacing-padding-x-left-content` | `padding` | `var(--apex-spacing-32)` | `.apex-collapse.apex-default-collapse` |
22
+ | `--collapse-spacing-padding-x-right-content` | `padding` | `var(--apex-spacing-8)` | `.apex-collapse.apex-default-collapse` |
23
+ | `--collapse-spacing-padding-y-content` | `padding` | `var(--apex-spacing-8)` | `.apex-collapse.apex-default-collapse` |
24
+ | `--collapse-stroke-container-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-collapse.apex-clean-collapse` |
25
+ | `--collapse-stroke-container-default` | `border-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-collapse.apex-default-collapse` |
26
+ | `--collapse-stroke-content-default` | `border-top-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-collapse.apex-clean-collapse` |
27
+ | `--collapse-stroke-content-default` | `border-top-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-collapse.apex-default-collapse` |
28
+ | `--collapse-stroke-header-default` | `border-top-color` | `var(--apex-stroke-neutral-transparent)` | `.apex-collapse.apex-clean-collapse` |
29
+ | `--collapse-stroke-header-default` | `border-top-color` | `var(--apex-stroke-neutral-quinary)` | `.apex-collapse.apex-default-collapse` |
30
+ | `--collapse-stroke-stroke-container` | `border-width` | `var(--apex-border-08)` | `.apex-collapse.apex-default-collapse` |
31
+ | `--collapse-stroke-stroke-content` | `border-top-width` | `var(--apex-border-08)` | `.apex-collapse.apex-default-collapse` |
32
+ | `--collapse-stroke-stroke-header` | `border-top-width` | `var(--apex-border-08)` | `.apex-collapse.apex-default-collapse` |
33
+ | `--collapse-text-content-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-collapse.apex-clean-collapse` |
34
+ | `--collapse-text-content-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-collapse.apex-default-collapse` |
35
+ | `--collapse-text-header-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-collapse.apex-clean-collapse` |
36
+ | `--collapse-text-header-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-collapse.apex-default-collapse` |
37
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-cn-body-font` |
38
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-cn-caption-font` |
39
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-cn-heading-1-font` |
40
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-cn-heading-2-font` |
41
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-3-font` |
42
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-cn-heading-4-font` |
43
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-20)` | `.apex-font.apex-text-en-body-font` |
44
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-18)` | `.apex-font.apex-text-en-caption-font` |
45
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-36)` | `.apex-font.apex-text-en-heading-1-font` |
46
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-28)` | `.apex-font.apex-text-en-heading-2-font` |
47
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-3-font` |
48
+ | `--font-fontheight` | `line-height` | `var(--apex-fontheight-24)` | `.apex-font.apex-text-en-heading-4-font` |
49
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-cn-body-font` |
50
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-cn-caption-font` |
51
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-cn-heading-1-font` |
52
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-cn-heading-2-font` |
53
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-3-font` |
54
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-cn-heading-4-font` |
55
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-14)` | `.apex-font.apex-text-en-body-font` |
56
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-12)` | `.apex-font.apex-text-en-caption-font` |
57
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-24)` | `.apex-font.apex-text-en-heading-1-font` |
58
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-18)` | `.apex-font.apex-text-en-heading-2-font` |
59
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-3-font` |
60
+ | `--font-fontsize` | `font-size` | `var(--apex-fontsize-16)` | `.apex-font.apex-text-en-heading-4-font` |
61
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-body-font` |
62
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-caption-font` |
63
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-1-font` |
64
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-2-font` |
65
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-8)` | `.apex-font.apex-text-cn-heading-3-font` |
66
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-0)` | `.apex-font.apex-text-cn-heading-4-font` |
67
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-body-font` |
68
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-caption-font` |
69
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-1-font` |
70
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-2-font` |
71
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-3-font` |
72
+ | `--font-fontspacing` | `letter-spacing` | `var(--apex-fontspacing-1)` | `.apex-font.apex-text-en-heading-4-font` |
73
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-body-font` |
74
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-caption-font` |
75
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-1-font` |
76
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-2-font` |
77
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-cn-heading-3-font` |
78
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-cn-heading-4-font` |
79
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-body-font` |
80
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-caption-font` |
81
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-1-font` |
82
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-2-font` |
83
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-600)` | `.apex-font.apex-text-en-heading-3-font` |
84
+ | `--font-fontweight` | `font-weight` | `var(--apex-fontweight-400)` | `.apex-font.apex-text-en-heading-4-font` |