更新记录
0.1.1(2026-08-01)
下载此版本
- 修复 Android 端
nax-space-item 注入使用 null 默认值时被推断为 Void,导致 ComputedRef 强转崩溃的问题;通过 APP-ANDROID 让父组件提供普通 Ref 状态,并让子组件使用同类型默认值,其它端行为保持不变。
平台兼容性
uni-app x(4.25)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| √ |
√ |
√ |
- |
√ |
√ |
其他
nax-space
间距容器:横向 / 纵向排列子项,并统一间距。
因 uni-app x 样式隔离 2.0,父组件无法给任意子节点加 margin。请用 nax-space-item 包裹每个子项(与 nax-grid / nax-grid-item 同模式)。
用法
<nax-space size="md">
<nax-space-item>
<nax-button type="primary" label="主要"></nax-button>
</nax-space-item>
<nax-space-item>
<nax-button label="默认"></nax-button>
</nax-space-item>
<nax-space-item>
<nax-button variant="tertiary" label="次要"></nax-button>
</nax-space-item>
</nax-space>
<!-- 纵向 -->
<nax-space direction="vertical" size="sm" fill>
<nax-space-item>
<nax-button block label="按钮 A"></nax-button>
</nax-space-item>
<nax-space-item>
<nax-button block label="按钮 B"></nax-button>
</nax-space-item>
</nax-space>
nax-space Props
| 属性 |
类型 |
默认 |
说明 |
| direction |
string |
horizontal |
horizontal / vertical(兼容 row / column) |
| size |
string |
md |
间距:xs/sm/md/lg/xl,或 token 档 1~10,或纯数字 px |
| wrap |
boolean |
false |
横向是否换行 |
| align |
string |
center |
交叉轴:start / center / end / baseline / stretch |
| justify |
string |
start |
主轴:start / center / end / between / around / evenly |
| fill |
boolean |
false |
子项拉伸(纵向时 item 宽 100%) |
| custom-class |
string |
'' |
根节点扩展 class |
size 对照
| size |
像素 |
对应 token |
xs / 1 |
4 |
--nax-space-1 |
sm / 2 |
8 |
--nax-space-2 |
md / 3 |
12 |
--nax-space-3 |
lg / 4 |
16 |
--nax-space-4 |
xl / 5 |
20 |
--nax-space-5 |
6 / 8 / 10 |
24 / 32 / 40 |
对应 token |
"10" / "12px" |
按数值 |
自定义 |
nax-space-item
| 属性 |
类型 |
默认 |
说明 |
| custom-class |
string |
'' |
根节点扩展 class |
插槽 default:实际内容。
依赖
nax-ui-theme(可选,设计 token 文档对齐)