当前位置：首页 > news >正文

vue element plus Space 间距

news 2025/8/21 3:55:20

虽然我们拥有 Divider 组件，但很多时候我们需要不是一个被 Divider 组件分割开的页面结构，因此我们会重复的使用很多的 Divider 组件，这在我们的开发效率上造成了一定的困扰。 间距组件就是为了解决这种困扰应运而生的。

基础用法#

最基础的用法，通过这个组件来给组件之间提供统一的间距。

通过间距组件来给多个组件之间提供间距

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

垂直布局#

使用 direction 来控制布局的方式, 背后实际上是利用了 flex-direction 来控制.

我们也提供垂直布局方式。

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

控制间距的大小#

通过调整 size 的值来控制间距的大小

使用内置的 small、default、large 来设置间距大小，分别对应 8px、12px 和 16px 的间距。默认的间距大小为 small，也就是 8px。

您也可以通过自定义的 size 来控制大小，参见下一个部分。

largedefaultsmall

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

自定义 Size#

很多时候，内建的大小不满足设计师的要求，我们可以通过传入自己定义的大小 (数值类型) 来设置。

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

TIP

不要让 ElSpace 与使用依赖父元素百分比宽度（或高度）的元素一起使用（例如 ElSlider），这样会造成光标不同步。

自动换行#

在 水平 (horizontal) ** 模式下, 通过控制 wrap（布尔类型）**来控制是否自动换行

利用 wrap 属性控制换行

Text button

行间分隔符#

有时候，仅仅在行间加空白并不能满足我们的日常需求，此时分隔符 (spacer) 就可以发挥非常好的作用了。

字母数字类型分隔符#

button 1

button 2

分隔符还可以是 VNode 类型#

button 1

button 2

对齐方式#

设置该值可以调整所有子节点在容器内的对齐方式，可设置的值与 align-items一致。

使用 alignment 属性来对齐

string

button

header

body

string

button

header

body

string

button

header

body

填充容器#

通过 fill**（布尔类型）**参数，您可以控制子节点是否自动填充容器。

下面的例子中，当设置为 fill 时，子节点的宽度会自动适配容器的宽度。

用 fill 属性让子节点自动填充容器

fill:

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

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

需要注意的是，水平布局和垂直布局的表现形式稍有不同，具体的效果可以查看下面的例子

用 fillRatio 自定义填充比例

direction: horizontalvertical

fillRatio:

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

Card nameOperation button

List item 1

List item 2

List item 3

List item 4

API#

Attributes#

属性名	说明	类型	默认值
alignment	对齐的方式	`enum` align-items	center
class	类名	`string` / `object` / `array`	—
direction	排列的方向	`enum`	horizontal
prefix-cls	给 space-items 的类名前缀	`string`	—
style	额外样式	`string` / `object`	—
spacer	间隔符	`string` / `number` / `VNode`	—
size	间隔大小	`enum` / `number` / `array`	small
wrap	设置是否自动折行	`boolean`	false
fill	子元素是否填充父容器	`boolean`	false
fill-ratio	填充父容器的比例	`number`	100