add vitepress docs

2026-09-21 16:05:14 +08:00
parent b435bf992e
commit 37cf38fe27
73 changed files with 7003 additions and 802 deletions
@@ -0,0 +1,33 @@
+# Space 间距
+
+控制子元素之间的间距与排列方向，支持分隔符。
+
+## 基础用法
+
+:::preview 基础用法 || 尺寸可用预设名或具体数值，数组形式分别指定横向与纵向
+
+demo-preview=../demos/space/basic.vue
+
+:::
+
+## 何时使用
+
+需要给一组元素之间加统一间距时使用。相比手写 `margin`，它把间距收敛到一个属性上，调整时不必逐个改样式。
+
+## 尺寸
+
+`size` 接受三种写法：
+
+| 写法 | 说明 |
+| --- | --- |
+| `"small"` / `"medium"` / `"large"` | 预设值，分别为 8 / 16 / 24 像素 |
+| 数字或带单位的字符串 | 自定义间距，如 `12`、`"1.5rem"` |
+| 数组 | 依次表示横向与纵向间距 |
+
+## 分隔符
+
+`separator` 或 `separator` 插槽会在相邻元素之间插入内容，注意**末尾元素之后不会插入**。
+
+## API
+
+<api-table name="Space" />