Skip to content

Space 间距

设置组件之间的间距。

基础用法

设置组件之间的间距,默认为水平方向,间距大小为 small (8px)。

基础用法

垂直布局

通过 direction 属性设置为 vertical

垂直布局

不同间距

通过 size 属性设置间距大小,可选值为 mini (4px)、small (8px)、medium (16px)、large (24px),也支持传入数字自定义像素大小,或数组 [horizontal, vertical]

不同间距

对齐方式

通过 align 属性设置对齐方式。

居中对齐:
Box
对齐方式

主轴对齐

通过 justify 属性设置主轴对齐方式,需配合 fill 属性使用。

主轴对齐

自动换行

通过 wrap 属性设置是否自动换行。

自动换行

填充容器

通过 fill 属性让间距组件撑满父容器宽度。

填充容器

分隔符

通过 spacer 属性传入分隔符文本,或使用 #spacer 插槽自定义分隔符。

分隔符

在 Nuxt 中使用

Space 组件完全支持 Nuxt 3/4 的 SSR 渲染。间距的布局在服务端即可计算完成,首屏即呈现正确的间距效果,无需等待客户端激活。

Nuxt 中使用

SSR 注意事项

  • ✅ 间距方向 (direction)、大小 (size)、对齐 (align) 首屏即生效
  • ✅ 自动换行 (wrap) 与填充 (fill) 支持 SSR
  • ✅ 分隔符 (spacer) 在服务端正确渲染
  • 💡 动态间距变化将在客户端激活后通过响应式系统自动完成

Nuxt 自动导入

在安装 @yh-ui/nuxt 模块后,YhSpace 组件会被自动注册,无需手动导入。

API

Props

属性名说明类型默认值
direction间距方向'horizontal' | 'vertical''horizontal'
size间距大小'mini' | 'small' | 'medium' | 'large' | number | [SpaceSize, SpaceSize]'small'
align交叉轴对齐方式'start' | 'end' | 'center' | 'baseline' | 'stretch''center'
justify主轴对齐方式'start' | 'end' | 'center' | 'space-around' | 'space-between' | 'space-evenly''start'
wrap是否自动换行(仅水平方向有效)booleanfalse
fill是否撑满父容器booleanfalse
spacer间隔符文本string | number
theme-overrides主题覆盖变量ComponentThemeVars

Slots

插槽名说明
default间距内的子元素
spacer自定义分隔符内容

主题变量

变量名说明默认值
--yh-space-spacer-padding分隔符内边距2px

Released under the MIT License.