Space 间距

尽管我们有分割线,但有时我们需要不止一条分割线来分隔元素,所以我们将每个元素堆叠在分割线上,但这样做不仅使我们的代码变得丑陋,而且也使其难以维护。Space就是这样一种组件,为我们提供了生产力和优雅。

基础用法

基本用法是使用此组件在每个组件之间提供统一的间距

使用 Space 提供间距

卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4

垂直布局

使用 direction 属性来控制布局,我们使用 flex-direction 来实现。

我们也提供垂直布局。

卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4

控制间距大小

通过 size API 控制间距大小。

您可以使用内置尺寸 smalldefaultlarge 来设置大小,这些尺寸分别对应 8px12px16px。默认大小是 small,即 8px

你也可以使用自定义尺寸来覆盖它。请参考下一部分。

卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4

自定义尺寸

有时内置的尺寸不能满足业务需求,我们可以使用自定义尺寸(数字类型)来控制项目之间的间距。

卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4

提示

请勿将 ElSpace 与依赖于父级宽度(高度)的组件(例如 ElSlider)一起使用,在这种情况下,当您拖动触发按钮时,滑块条会增长,导致光标和触发按钮之间发生错位。

自动换行

水平 模式下,使用 wrap布尔类型)来控制自动换行行为。

使用 wrap 控制换行

分隔符

有时我们想要的不只是空白,所以我们有(分隔符)来帮助我们。

字面量类型的分隔符

|

分隔符也可以是 VNode

对齐方式

设置此属性可以调整子节点的对齐方式,期望值可以在 align-items 找到。

使用 alignment

string
header
body
string
header
body
string
header
body

填充容器

通过 fill (布尔类型) 参数,可以控制子节点是否自动填充容器。

在下面的示例中,当设置为 fill 时,子节点的宽度将自动适应容器的宽度。

使用 fill 自动用子节点填充容器

填充色
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4

您也可以使用 fillRatio 参数自定义填充比例。默认值为 100,代表以 100% 的父容器宽度为基准进行填充。

需要注意的是,水平布局和垂直布局的表达方式略有不同,具体效果可以在下面的示例中查看。

使用 fillRatio 自定义填充比例

direction
填充比例
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4
卡片名称
列表项 1
列表项 2
列表项 3
列表项 4

API

属性

名称描述类型默认值
对齐方式控制项目的对齐方式枚举 align-itemscenter
class类名string / object / array
direction排列方向枚举horizontal
前缀类间距项的前缀string
样式额外的样式规则string / object
分隔符分隔符string / number / VNode
size间距大小枚举 / number / array
换行自动换行booleanfalse
填充色是否填充容器booleanfalse
填充比例填充的比例number100

插槽

名称description
default需要间隔的项

来源

组件样式文档

贡献者