@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,298 @@
1
+ # Layout
2
+
3
+ > Layout:搭建后台页面的 Header、侧栏、内容区与 Footer 等整体结构时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Layout`、`LayoutSiderDrawerBody`、`LayoutSiderDrawerHeader`、`LayoutSiderMenuCollapsed`、`LayoutSiderMenuMaximized`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Layout } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => (
19
+ <Layout style={{ minHeight: 260 }}>
20
+ <Layout.Header>Header</Layout.Header>
21
+ <Layout.Content
22
+ style={{
23
+ display: 'flex',
24
+ alignItems: 'center',
25
+ justifyContent: 'center',
26
+ }}
27
+ >
28
+ Content
29
+ </Layout.Content>
30
+ <Layout.Footer style={{ textAlign: 'center' }}>Footer</Layout.Footer>
31
+ </Layout>
32
+ )
33
+ ```
34
+
35
+ ## 何时使用
36
+
37
+ - 搭建后台页面的 Header、侧栏、内容区与 Footer 等整体结构时。
38
+ - 需要可折叠侧栏、双栏侧栏(`variant="sidebar"`)或右侧信息抽屉(`variant="drawer"`)时。
39
+ - 简单单页内容区不必套多层 Layout;临时浮层请用 Drawer 或 Modal。
40
+
41
+ ## API
42
+
43
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
44
+
45
+ ### Layout
46
+
47
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
48
+ | --- | --- | --- | --- | --- |
49
+ | hasSider | 表示子元素里有 Sider,可用于 SSR 场景避免样式闪动。 | `boolean` | 否 | — |
50
+ | ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
51
+
52
+ ### LayoutBreakpoint
53
+
54
+ ```typescript
55
+ type LayoutBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | 'xxxl'
56
+ ```
57
+
58
+ ### LayoutCollapseType
59
+
60
+ ```typescript
61
+ type LayoutCollapseType = 'clickTrigger' | 'responsive'
62
+ ```
63
+
64
+ ### LayoutSiderVariant
65
+
66
+ Sider 展示形态:
67
+
68
+ ```typescript
69
+ type LayoutSiderVariant = 'default' | 'sidebar' | 'drawer'
70
+ ```
71
+
72
+ ### LayoutHeaderProps
73
+
74
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
75
+
76
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
77
+ | --- | --- | --- | --- | --- |
78
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
79
+
80
+ ### LayoutContentProps
81
+
82
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
83
+
84
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
85
+ | --- | --- | --- | --- | --- |
86
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
87
+
88
+ ### LayoutFooterProps
89
+
90
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
91
+
92
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
93
+ | --- | --- | --- | --- | --- |
94
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
95
+
96
+ ### LayoutSiderMenuCollapsedProps
97
+
98
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
99
+
100
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
101
+ | --- | --- | --- | --- | --- |
102
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
103
+
104
+ ### LayoutSiderMenuMaximizedProps
105
+
106
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
107
+
108
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
109
+ | --- | --- | --- | --- | --- |
110
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
111
+
112
+ ### LayoutSiderDrawerHeaderProps
113
+
114
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
115
+
116
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
117
+ | --- | --- | --- | --- | --- |
118
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
119
+
120
+ ### LayoutSiderDrawerBodyProps
121
+
122
+ 继承:`React.HTMLAttributes<HTMLDivElement>`;本节列出新增或重声明字段。
123
+
124
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
125
+ | --- | --- | --- | --- | --- |
126
+ | ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
127
+
128
+ ### LayoutSiderProps
129
+
130
+ 继承:`React.HTMLAttributes<HTMLElement>`;本节列出新增或重声明字段。
131
+
132
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
133
+ | --- | --- | --- | --- | --- |
134
+ | ref | — | `React.Ref<HTMLElement>` | 否 | — |
135
+ | variant | 侧栏形态:`sidebar` 双栏侧栏;`drawer` 右侧抽屉(宽度由 `--drawer-width` 决定)。 | `"default" \| "sidebar" \| "drawer"` | 否 | `'default'` |
136
+ | breakpoint | 触发响应式布局的断点。 | `"xs" \| "sm" \| "md" \| "lg" \| "xl" \| "xxl" \| "xxxl"` | 否 | — |
137
+ | collapsed | 当前收起状态(受控)。 | `boolean` | 否 | — |
138
+ | collapsedWidth | 收缩宽度,设置为 0 会出现特殊 trigger。 | `number` | 否 | `80` |
139
+ | collapsible | 是否可收起。 | `boolean` | 否 | `false` |
140
+ | defaultCollapsed | 是否默认收起(非受控)。 | `boolean` | 否 | `false` |
141
+ | reverseArrow | 翻转折叠箭头方向。 | `boolean` | 否 | `false` |
142
+ | trigger | 自定义 trigger,传 null 隐藏默认 trigger。 | `React.ReactNode` | 否 | — |
143
+ | width | Sider 宽度;`sidebar` / `drawer` 时默认由对应 token 决定。 | `number \| string` | 否 | — |
144
+ | zeroWidthTriggerStyle | collapsedWidth 为 0 时特殊 trigger 的样式。 | `React.CSSProperties` | 否 | — |
145
+ | onBreakpoint | 触发断点时回调。 | `(broken: boolean) => void` | 否 | — |
146
+ | onCollapse | 展开/收起状态变化回调。 | `(collapsed: boolean, type: LayoutCollapseType) => void` | 否 | — |
147
+
148
+ ### 导出类型
149
+
150
+ 另可从 `@apexhub/apex-ui-react` 导入:`LayoutBreakpoint`、`LayoutCollapseType`、`LayoutContentProps`、`LayoutFooterProps`、`LayoutHeaderProps`、`LayoutProps`、`LayoutSiderDrawerBodyProps`、`LayoutSiderDrawerHeaderProps`、`LayoutSiderMenuCollapsedProps`、`LayoutSiderMenuMaximizedProps`、`LayoutSiderProps`、`LayoutSiderVariant`(与上文子类型配合使用)。
151
+
152
+ ## 代码演示
153
+
154
+ ### 顶部与侧栏
155
+
156
+ 当页面包含侧栏时,可将 Sider 与右侧纵向 Layout 组合使用。
157
+
158
+ ```tsx
159
+ import { Layout } from '@apexhub/apex-ui-react'
160
+
161
+ export default () => (
162
+ <Layout style={{ minHeight: 300 }}>
163
+ <Layout.Header>Header</Layout.Header>
164
+ <Layout hasSider>
165
+ <Layout.Sider width={180}>
166
+ <div style={{ padding: 'var(--apex-spacing-16)' }}>Sider</div>
167
+ </Layout.Sider>
168
+ <Layout.Content
169
+ style={{
170
+ display: 'flex',
171
+ alignItems: 'center',
172
+ justifyContent: 'center',
173
+ }}
174
+ >
175
+ Content
176
+ </Layout.Content>
177
+ </Layout>
178
+ <Layout.Footer style={{ textAlign: 'center' }}>Footer</Layout.Footer>
179
+ </Layout>
180
+ )
181
+ ```
182
+
183
+ ### 可折叠侧栏
184
+
185
+ 开启 `collapsible` 后,Sider 会展示默认折叠触发器,也可以通过 `collapsed` 和 折叠变化事件 受控管理。
186
+
187
+ ```tsx
188
+ import { Layout } from '@apexhub/apex-ui-react'
189
+
190
+ import { useState } from 'react'
191
+
192
+ export default () => {
193
+ const [collapsed, setCollapsed] = useState(false)
194
+
195
+ return (
196
+ <Layout style={{ minHeight: 260 }}>
197
+ <Layout.Sider
198
+ collapsible
199
+ collapsed={collapsed}
200
+ width={200}
201
+ onCollapse={(next) => setCollapsed(next)}
202
+ >
203
+ <div style={{ padding: 'var(--apex-spacing-16)' }}>{collapsed ? '已收起' : '侧栏内容'}</div>
204
+ </Layout.Sider>
205
+ <Layout.Content
206
+ style={{
207
+ display: 'flex',
208
+ alignItems: 'center',
209
+ justifyContent: 'center',
210
+ }}
211
+ >
212
+ {collapsed ? '点击 trigger 展开侧栏' : '点击 trigger 收起侧栏'}
213
+ </Layout.Content>
214
+ </Layout>
215
+ )
216
+ }
217
+ ```
218
+
219
+ ### 双栏侧栏
220
+
221
+ `variant="sidebar"` 用于 menu-collapsed + menu-maximized 的双栏侧边布局,根 Layout 可配合 `apex-sidebar-layout` 获得与菜单列一致的宽度别名。
222
+
223
+ ```tsx
224
+ import { Layout } from '@apexhub/apex-ui-react'
225
+
226
+ export default () => (
227
+ <Layout className="apex-sidebar-layout" style={{ minHeight: 320 }}>
228
+ <Layout hasSider>
229
+ <Layout.Sider variant="sidebar">
230
+ <Layout.SiderMenuCollapsed>
231
+ <div style={{ padding: 'var(--apex-spacing-12)' }}>Menu collapsed</div>
232
+ </Layout.SiderMenuCollapsed>
233
+ <Layout.SiderMenuMaximized>
234
+ <div style={{ padding: 'var(--apex-spacing-12)' }}>Menu maximized</div>
235
+ </Layout.SiderMenuMaximized>
236
+ </Layout.Sider>
237
+ <Layout>
238
+ <Layout.Header>Header</Layout.Header>
239
+ <Layout.Content
240
+ style={{
241
+ display: 'flex',
242
+ alignItems: 'center',
243
+ justifyContent: 'center',
244
+ }}
245
+ >
246
+ Content
247
+ </Layout.Content>
248
+ </Layout>
249
+ </Layout>
250
+ </Layout>
251
+ )
252
+ ```
253
+
254
+ ### 右侧抽屉区域
255
+
256
+ `variant="drawer"` 用于在主内容右侧展示信息抽屉,可配合 `SiderDrawerHeader` 与 `SiderDrawerBody` 组织内容。
257
+
258
+ ```tsx
259
+ import { Layout } from '@apexhub/apex-ui-react'
260
+
261
+ export default () => (
262
+ <Layout style={{ minHeight: 320 }}>
263
+ <Layout.Content
264
+ style={{
265
+ display: 'flex',
266
+ alignItems: 'center',
267
+ justifyContent: 'center',
268
+ }}
269
+ >
270
+ 主内容
271
+ </Layout.Content>
272
+ <Layout.Sider variant="drawer">
273
+ <Layout.SiderDrawerHeader>详情</Layout.SiderDrawerHeader>
274
+ <Layout.SiderDrawerBody>这里展示与当前页面相关的辅助信息。</Layout.SiderDrawerBody>
275
+ </Layout.Sider>
276
+ </Layout>
277
+ )
278
+ ```
279
+
280
+ ## DOM 结构
281
+
282
+ 源码声明的静态 `data-slot`:`layout-header`、`layout-footer`、`layout-content`、`layout-sider-menu-collapsed`、`layout-sider-menu-maximized`、`layout-sider-drawer-header`、`layout-sider-drawer`、`layout-sider`。具体节点随模式和状态出现,不表示固定嵌套顺序。
283
+
284
+ ## 样式定制
285
+
286
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
287
+
288
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
289
+
290
+ ## FAQ
291
+
292
+ ### 满屏页面高度不对怎么办?
293
+
294
+ 在根 `Layout` 上添加 `apex-layout--fullscreen`,并确保父级容器具备明确高度。
295
+
296
+ ### 双栏侧栏宽度如何与菜单列对齐?
297
+
298
+ 双栏侧栏场景建议在根 `Layout` 上添加 `apex-sidebar-layout`,使侧栏宽度与收窄图标列、展开菜单列的设计默认宽度对齐。
@@ -0,0 +1,29 @@
1
+ # Layout 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
+ | `--drawer-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-drawer.apex-default-drawer` |
14
+ | `--drawer-spacing-header` | `height`、`line-height` | `var(--apex-size-40)` | `.apex-drawer.apex-default-drawer` |
15
+ | `--drawer-spacing-padding` | `padding` | `var(--apex-spacing-16)` | `.apex-drawer.apex-default-drawer` |
16
+ | `--drawer-spacing-width` | `flex`、`max-width`、`width` | `var(--apex-size-800)` | `.apex-drawer.apex-default-drawer` |
17
+ | `--drawer-stroke-default` | `border-bottom`、`border-left` | `var(--apex-stroke-neutral-quinary)` | `.apex-drawer.apex-default-drawer` |
18
+ | `--drawer-stroke-stroke` | `border-bottom`、`border-left` | `var(--apex-border-1)` | `.apex-drawer.apex-default-drawer` |
19
+ | `--drawer-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-drawer.apex-default-drawer` |
20
+ | `--header-spacing-height` | `height`、`line-height` | `var(--apex-size-48)` | `.apex-header.apex-default-header` |
21
+ | `--header-spacing-padding-x` | `padding` | `var(--apex-spacing-24)` | `.apex-header.apex-default-header` |
22
+ | `--header-spacing-padding-y` | `padding` | `var(--apex-spacing-8)` | `.apex-header.apex-default-header` |
23
+ | `--layout-spacing-padding` | `padding` | `var(--apex-spacing-24)` | `.apex-layout.apex-defalut-layout` |
24
+ | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-md-menu` |
25
+ | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
26
+ | `--menu-spacing-padding-y` | `padding` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
27
+ | `--menu-spacing-padding-y` | `padding` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-sm-menu` |
28
+ | `--menu-stroke-stroke` | `border-right` | `var(--apex-border-1)` | `.apex-menu.apex-container-md-menu` |
29
+ | `--menu-stroke-stroke` | `border-right` | `var(--apex-border-1)` | `.apex-menu.apex-container-sm-menu` |