@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,419 @@
1
+ # Grid
2
+
3
+ > Grid:页面区块需要按 24 栅格划分宽度与响应式列数时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Col`、`Row`、`useBreakpoint`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Col, Row } from '@apexhub/apex-ui-react'
15
+
16
+ import type { CSSProperties } from 'react'
17
+
18
+ import '@apexhub/apex-ui-react/style.css'
19
+
20
+ const boxStyle: CSSProperties = {
21
+ background: 'var(--apex-fill-neutral-secondary)',
22
+ padding: '8px 0',
23
+ textAlign: 'center',
24
+ borderRadius: 4,
25
+ }
26
+
27
+ export default () => (
28
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
29
+ <Row>
30
+ <Col span={24}>
31
+ <div style={boxStyle}>col-24</div>
32
+ </Col>
33
+ </Row>
34
+ <Row>
35
+ <Col span={12}>
36
+ <div style={boxStyle}>col-12</div>
37
+ </Col>
38
+ <Col span={12}>
39
+ <div style={boxStyle}>col-12</div>
40
+ </Col>
41
+ </Row>
42
+ <Row>
43
+ <Col span={8}>
44
+ <div style={boxStyle}>col-8</div>
45
+ </Col>
46
+ <Col span={8}>
47
+ <div style={boxStyle}>col-8</div>
48
+ </Col>
49
+ <Col span={8}>
50
+ <div style={boxStyle}>col-8</div>
51
+ </Col>
52
+ </Row>
53
+ <Row>
54
+ <Col span={6}>
55
+ <div style={boxStyle}>col-6</div>
56
+ </Col>
57
+ <Col span={6}>
58
+ <div style={boxStyle}>col-6</div>
59
+ </Col>
60
+ <Col span={6}>
61
+ <div style={boxStyle}>col-6</div>
62
+ </Col>
63
+ <Col span={6}>
64
+ <div style={boxStyle}>col-6</div>
65
+ </Col>
66
+ </Row>
67
+ </div>
68
+ )
69
+ ```
70
+
71
+ ## 何时使用
72
+
73
+ - 页面区块需要按 24 栅格划分宽度与响应式列数时。
74
+ - 需要统一控制列间距(`gutter`)、主轴对齐或列偏移时。
75
+ - 需要随视口断点切换 `span`、`offset` 等布局时,可配合 `useBreakpoint`。
76
+
77
+ ## API
78
+
79
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
80
+
81
+ ### 使用入口
82
+
83
+ 通过 `Col`、`Row`、`useBreakpoint` 使用,配置与方法见下方关联类型。
84
+
85
+ ### GridBreakpoint
86
+
87
+ 响应式断点标识。
88
+
89
+ ```typescript
90
+ type GridBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'
91
+ ```
92
+
93
+ ### Gutter
94
+
95
+ 栅格间隔。number 为固定像素;对象形态按断点响应式取值。
96
+
97
+ ```typescript
98
+ type Gutter = number | Partial<Record<GridBreakpoint, number>>
99
+ ```
100
+
101
+ ### Justify
102
+
103
+ Row 主轴(横向)对齐方式。
104
+
105
+ ```typescript
106
+ type Justify = 'start' | 'end' | 'center' | 'space-around' | 'space-between' | 'space-evenly'
107
+ ```
108
+
109
+ ### Align
110
+
111
+ Row 交叉轴(纵向)对齐方式。
112
+
113
+ ```typescript
114
+ type Align = 'top' | 'middle' | 'bottom' | 'stretch'
115
+ ```
116
+
117
+ ### ColSize
118
+
119
+ Col 断点 prop 的对象形态。
120
+
121
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
122
+ | --- | --- | --- | --- | --- |
123
+ | span | 栅格占位格数,`0–24`。 | `number` | 否 | — |
124
+ | offset | 左侧间隔格数。 | `number` | 否 | — |
125
+ | order | flex 排序。 | `number` | 否 | — |
126
+ | pull | 向左移动格数。 | `number` | 否 | — |
127
+ | push | 向右移动格数。 | `number` | 否 | — |
128
+ | flex | flex 布局填充。 | `number \| string` | 否 | — |
129
+
130
+ ### RowProps
131
+
132
+ 继承:`React.HTMLAttributes<HTMLDivElement>`;本节列出新增或重声明字段。
133
+
134
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
135
+ | --- | --- | --- | --- | --- |
136
+ | gutter | 栅格间隔。`number` 为水平间隔;`[水平, 垂直]` 分别设置;<br>每个分量可为响应式对象(如 `{ xs: 8, md: 24 }`)。 | `Gutter \| [Gutter, Gutter]` | 否 | `0` |
137
+ | justify | 主轴(横向)排列方式;可传响应式对象按断点切换。 | `Justify \| Partial<Record<GridBreakpoint, Justify>>` | 否 | `'start'` |
138
+ | align | 交叉轴(纵向)对齐方式;可传响应式对象按断点切换。 | `Align \| Partial<Record<GridBreakpoint, Align>>` | 否 | `'top'` |
139
+ | wrap | 是否自动换行。 | `boolean` | 否 | `true` |
140
+ | ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
141
+
142
+ ### ColProps
143
+
144
+ 继承:`React.HTMLAttributes<HTMLDivElement>`;本节列出新增或重声明字段。
145
+
146
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
147
+ | --- | --- | --- | --- | --- |
148
+ | span | 栅格占位格数,`0–24`;为 `0` 时等价于 `display: none`。 | `number` | 否 | — |
149
+ | offset | 左侧间隔格数(`margin-inline-start`)。 | `number` | 否 | `0` |
150
+ | order | flex 排序。 | `number` | 否 | `0` |
151
+ | push | 向右移动格数(`inset-inline-start`)。 | `number` | 否 | `0` |
152
+ | pull | 向左移动格数(`inset-inline-end`)。 | `number` | 否 | `0` |
153
+ | flex | flex 布局填充,直接作用于 `style.flex`;与 `span` 同时存在时 `flex` 优先。 | `number \| string` | 否 | — |
154
+ | xs | `<576px` 响应式列配置;传 `number` 等价于 `{ span }`。 | `number \| ColSize` | 否 | — |
155
+ | sm | `≥576px` 响应式列配置。 | `number \| ColSize` | 否 | — |
156
+ | md | `≥768px` 响应式列配置。 | `number \| ColSize` | 否 | — |
157
+ | lg | `≥992px` 响应式列配置。 | `number \| ColSize` | 否 | — |
158
+ | xl | `≥1200px` 响应式列配置。 | `number \| ColSize` | 否 | — |
159
+ | xxl | `≥1600px` 响应式列配置。 | `number \| ColSize` | 否 | — |
160
+ | ref | — | `React.Ref<HTMLDivElement>` | 否 | — |
161
+
162
+ ### 导出类型
163
+
164
+ 另可从 `@apexhub/apex-ui-react` 导入:`Align`、`ColProps`、`ColSize`、`GridBreakpoint`、`Gutter`、`Justify`、`RowProps`(与上文子类型配合使用)。
165
+
166
+ ## 代码演示
167
+
168
+ ### 基础用法
169
+
170
+ `Row` 与 `Col` 组合搭建常见页面结构;`span` 总和不超过 24。
171
+
172
+ ```tsx
173
+ import { Col, Row } from '@apexhub/apex-ui-react'
174
+
175
+ import type { CSSProperties } from 'react'
176
+
177
+ const boxStyle: CSSProperties = {
178
+ background: 'var(--apex-fill-neutral-secondary)',
179
+ padding: '8px 0',
180
+ textAlign: 'center',
181
+ borderRadius: 4,
182
+ }
183
+
184
+ export default () => (
185
+ <Row gutter={16}>
186
+ <Col span={8}>
187
+ <div style={boxStyle}>col-8</div>
188
+ </Col>
189
+ <Col span={8}>
190
+ <div style={boxStyle}>col-8</div>
191
+ </Col>
192
+ <Col span={8}>
193
+ <div style={boxStyle}>col-8</div>
194
+ </Col>
195
+ </Row>
196
+ )
197
+ ```
198
+
199
+ ### 栅格间隔
200
+
201
+ 支持一维间距(`gutter` 设为 `16`)与二维间距(设为 `[16, 24]`)。
202
+
203
+ ```tsx
204
+ import { Col, Row } from '@apexhub/apex-ui-react'
205
+
206
+ import type { CSSProperties } from 'react'
207
+
208
+ const boxStyle: CSSProperties = {
209
+ background: 'var(--apex-fill-neutral-secondary)',
210
+ padding: '8px 0',
211
+ textAlign: 'center',
212
+ borderRadius: 4,
213
+ }
214
+
215
+ export default () => (
216
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
217
+ <Row gutter={16}>
218
+ <Col span={6}>
219
+ <div style={boxStyle}>col-6</div>
220
+ </Col>
221
+ <Col span={6}>
222
+ <div style={boxStyle}>col-6</div>
223
+ </Col>
224
+ <Col span={6}>
225
+ <div style={boxStyle}>col-6</div>
226
+ </Col>
227
+ <Col span={6}>
228
+ <div style={boxStyle}>col-6</div>
229
+ </Col>
230
+ </Row>
231
+ <Row gutter={[16, 24]}>
232
+ <Col span={8}>
233
+ <div style={boxStyle}>col-8</div>
234
+ </Col>
235
+ <Col span={8}>
236
+ <div style={boxStyle}>col-8</div>
237
+ </Col>
238
+ <Col span={8}>
239
+ <div style={boxStyle}>col-8</div>
240
+ </Col>
241
+ <Col span={8}>
242
+ <div style={boxStyle}>col-8(换行)</div>
243
+ </Col>
244
+ <Col span={8}>
245
+ <div style={boxStyle}>col-8(换行)</div>
246
+ </Col>
247
+ <Col span={8}>
248
+ <div style={boxStyle}>col-8(换行)</div>
249
+ </Col>
250
+ </Row>
251
+ </div>
252
+ )
253
+ ```
254
+
255
+ ### 主轴对齐
256
+
257
+ `justify` 控制 Row 内列在主轴(横向)上的对齐与分布方式。
258
+
259
+ ```tsx
260
+ import { Col, Divider, Row, Typography } from '@apexhub/apex-ui-react'
261
+
262
+ import type { CSSProperties } from 'react'
263
+
264
+ const boxStyle: CSSProperties = {
265
+ background: 'var(--apex-fill-neutral-secondary)',
266
+ padding: '8px 0',
267
+ textAlign: 'center',
268
+ borderRadius: 4,
269
+ }
270
+
271
+ const rowStyle: CSSProperties = {
272
+ width: '100%',
273
+ backgroundColor: 'var(--apex-fill-neutral-primary)',
274
+ borderRadius: 4,
275
+ }
276
+
277
+ const justifies = [
278
+ 'start',
279
+ 'center',
280
+ 'end',
281
+ 'space-between',
282
+ 'space-around',
283
+ 'space-evenly',
284
+ ] as const
285
+
286
+ export default () => (
287
+ <>
288
+ {justifies.map((justify) => (
289
+ <Row key={justify} justify="end" style={{ width: '100%' }}>
290
+ <Divider titlePlacement="start" style={{ margin: '16px 0' }}>
291
+ <Typography.Text variant="caption" style={{ fontSize: 14 }}>
292
+ {justify[0].toUpperCase() + justify.slice(1)}
293
+ </Typography.Text>
294
+ </Divider>
295
+ <Row justify={justify} gutter={16} style={rowStyle}>
296
+ <Col span={4}>
297
+ <div style={boxStyle}>col-4</div>
298
+ </Col>
299
+ <Col span={4}>
300
+ <div style={boxStyle}>col-4</div>
301
+ </Col>
302
+ </Row>
303
+ <br />
304
+ <br />
305
+ <br />
306
+ <br />
307
+ </Row>
308
+ ))}
309
+ </>
310
+ )
311
+ ```
312
+
313
+ ### 列偏移
314
+
315
+ `offset` 为列左侧留出间隔格数,无需占位空列。
316
+
317
+ ```tsx
318
+ import { Col, Row } from '@apexhub/apex-ui-react'
319
+
320
+ import type { CSSProperties } from 'react'
321
+
322
+ const boxStyle: CSSProperties = {
323
+ background: 'var(--apex-fill-neutral-secondary)',
324
+ padding: '8px 0',
325
+ textAlign: 'center',
326
+ borderRadius: 4,
327
+ }
328
+
329
+ export default () => (
330
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
331
+ <Row>
332
+ <Col span={8}>
333
+ <div style={boxStyle}>col-8</div>
334
+ </Col>
335
+ <Col span={8} offset={8}>
336
+ <div style={boxStyle}>col-8 offset-8</div>
337
+ </Col>
338
+ </Row>
339
+ <Row>
340
+ <Col span={6} offset={6}>
341
+ <div style={boxStyle}>col-6 offset-6</div>
342
+ </Col>
343
+ <Col span={6} offset={6}>
344
+ <div style={boxStyle}>col-6 offset-6</div>
345
+ </Col>
346
+ </Row>
347
+ </div>
348
+ )
349
+ ```
350
+
351
+ ### 交叉轴对齐
352
+
353
+ `align` 控制 Row 内列在交叉轴(纵向)上的对齐方式。
354
+
355
+ ```tsx
356
+ import { Col, Row } from '@apexhub/apex-ui-react'
357
+
358
+ const boxStyle = {
359
+ background: 'var(--apex-fill-neutral-secondary)',
360
+ padding: '8px 12px',
361
+ borderRadius: 4,
362
+ display: 'flex',
363
+ alignItems: 'center',
364
+ justifyContent: 'center',
365
+ }
366
+
367
+ export default () => (
368
+ <Row justify="center" align="middle" style={{ height: 80, gap: 4 }}>
369
+ <Col span={4}>
370
+ <div style={boxStyle}>居中</div>
371
+ </Col>
372
+ <Col span={4}>
373
+ <div style={{ ...boxStyle, height: 48, lineHeight: '48px' }}>较高</div>
374
+ </Col>
375
+ </Row>
376
+ )
377
+ ```
378
+
379
+ ### 响应式
380
+
381
+ 通过 `xs` / `sm` / `md` 等断点 prop 为不同视口设置 `span` 或 `ColSize` 对象。
382
+
383
+ ```tsx
384
+ import { Col, Row } from '@apexhub/apex-ui-react'
385
+
386
+ import type { CSSProperties } from 'react'
387
+
388
+ const boxStyle: CSSProperties = {
389
+ background: 'var(--apex-fill-neutral-secondary)',
390
+ padding: '8px 0',
391
+ textAlign: 'center',
392
+ borderRadius: 4,
393
+ }
394
+
395
+ export default () => (
396
+ <Row gutter={16}>
397
+ <Col xs={24} sm={12} md={8} lg={6}>
398
+ <div style={boxStyle}>响应式</div>
399
+ </Col>
400
+ <Col xs={24} sm={12} md={8} lg={6}>
401
+ <div style={boxStyle}>列</div>
402
+ </Col>
403
+ <Col xs={24} sm={12} md={8} lg={6}>
404
+ <div style={boxStyle}>布局</div>
405
+ </Col>
406
+ <Col xs={24} sm={12} md={8} lg={6}>
407
+ <div style={boxStyle}>示例</div>
408
+ </Col>
409
+ </Row>
410
+ )
411
+ ```
412
+
413
+ ## DOM 结构
414
+
415
+ 源码声明的静态 `data-slot`:`col`、`row`。具体节点随模式和状态出现,不表示固定嵌套顺序。
416
+
417
+ ## 样式定制
418
+
419
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。