## Space 间距

虽然我们拥有 [Divider 组件](#/zh-CN/component/divider), 但很多时候我们需要不是一个被 [Divider 组件](#/zh-CN/component/divider) 分割开的页面结构, 因此我们会重复的使用很多的 [Divider 组件](#/zh-CN/component/divider), 这在我们的开发效率上造成了一定的困扰, **间距组件**就是为了解决这种困扰应运而生的.

### 基础用法

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

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

```html
<template>
  <el-space wrap>
    <el-card class="box-card" style="width: 250px" v-for="i in 3" :key="i">
      <template #header>
        <div class="card-header">
          <span>Card name</span>
          <el-button class="button" type="text">Operation button</el-button>
        </div>
      </template>
      <div v-for="o in 4" :key="o" class="text item">
        {{ 'List item ' + o }}
      </div>
    </el-card>
  </el-space>
</template>
```

:::

### 垂直布局

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

:::demo 当然也提供垂直布局的方式

```html
<template>
  <el-space direction="vertical">
    <el-card class="box-card" style="width: 250px" v-for="i in 2" :key="i">
      <template #header>
        <div class="card-header">
          <span>Card name</span>
          <el-button class="button" type="text">Operation button</el-button>
        </div>
      </template>
      <div v-for="o in 4" :key="o" class="text item">
        {{ 'List item ' + o }}
      </div>
    </el-card>
  </el-space>
</template>
```

:::

### 控制间距的大小

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

可供选择的内建的值有 `mini`, `small`, `medium`, `large`, 分别对应 `4px`, `8px`, `12px`, `16px`. 默认的间距大小为 `small` 也就是 `8px`

您也可以通过自定义的 `size` 来控制大小，详见下一部分
:::demo 使用 `size` 属性控制大小

```html
<template>
  <el-space direction="vertical" alignment="start" :size="30">
    <el-radio-group v-model="size">
      <el-radio :label="'mini'">迷你</el-radio>
      <el-radio :label="'small'">小</el-radio>
      <el-radio :label="'medium'">中等</el-radio>
      <el-radio :label="'large'">大号</el-radio>
    </el-radio-group>

    <el-space wrap :size="size">
      <el-card class="box-card" style="width: 250px" v-for="i in 3" :key="i">
        <template #header>
          <div class="card-header">
            <span>Card name</span>
            <el-button class="button" type="text">Operation button</el-button>
          </div>
        </template>
        <div v-for="o in 4" :key="o" class="text item">
          {{ 'List item ' + o }}
        </div>
      </el-card>
    </el-space>
  </el-space>
</template>

<script>
  export default {
    data() {
      return {
        size: 'mini',
      }
    },
  }
</script>
```

:::

### 自定义 Size

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

:::demo

```html
<template>
  <el-slider v-model="size" />
  <el-space wrap :size="size">
    <el-card class="box-card" style="width: 250px" v-for="i in 2" :key="i">
      <template #header>
        <div class="card-header">
          <span>Card name</span>
          <el-button class="button" type="text">Operation button</el-button>
        </div>
      </template>
      <div v-for="o in 4" :key="o" class="text item">
        {{ 'List item ' + o }}
      </div>
    </el-card>
  </el-space>
</template>

<script>
  export default {
    data() {
      return {
        size: 20,
      }
    },
  }
</script>
```

:::

:::tip
不要与使用依赖父元素百分比宽度 (高度) 的元素一起使用, 例如 `ElSlider`, 这样会造成光标不同步
:::

### 自动换行

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

:::demo 利用 `wrap` 控制换行

```html
<el-space wrap>
  <div v-for="i in 20" :key="i">
    <el-button type="text"> 文字按钮 </el-button>
  </div>
</el-space>
```

:::

### 行间分隔符

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

#### 字符串 或 数字类型的分隔符

:::demo

```html
<template>
  <el-space :size="size" spacer="|">
    <div v-for="i in 2" :key="i">
      <el-button> button {{ i }} </el-button>
    </div>
  </el-space>
</template>

<script>
  export default {
    data() {
      return {
        size: 10,
      }
    },
  }
</script>
```

:::

#### 分隔符还可以是 VNode 类型

:::demo

```html
<template>
  <el-space :size="size" :spacer="spacer">
    <div v-for="i in 2" :key="i">
      <el-button> button {{ i }} </el-button>
    </div>
  </el-space>
</template>

<script>
  import { h, resolveComponent } from 'vue'
  import { ElDivider } from 'element-plus'
  export default {
    data() {
      return {
        size: 10,
        spacer: h(ElDivider, { direction: 'vertical' }),
      }
    },
  }
</script>
```

:::

### 对齐方式

设置该值可以调整所有子节点在容器内的对齐方式, 可设置的值与 [align-items](https://developer.mozilla.org/zh-CN/docs/Web/CSS/align-items) 一致

:::demo 用 alignment 来控制对齐

```html
<template>
  <div
    style="width: 240px;margin-bottom: 20px;padding: 8px;border: 1px solid #ccc;"
  >
    <el-space>
      string
      <el-button> button </el-button>
      <el-card>
        <template #header> header </template>
        body
      </el-card>
    </el-space>
  </div>
  <div
    style="width: 240px;margin-bottom: 20px;padding: 8px;border: 1px solid #ccc;"
  >
    <el-space alignment="flex-start">
      string
      <el-button> button </el-button>
      <el-card>
        <template #header> header </template>
        body
      </el-card>
    </el-space>
  </div>
  <div
    style="width: 240px;margin-bottom: 20px;padding: 8px;border: 1px solid #ccc;"
  >
    <el-space alignment="flex-end">
      string
      <el-button> button </el-button>
      <el-card>
        <template #header> header </template>
        body
      </el-card>
    </el-space>
  </div>
</template>
```

:::

### 自动填充容器

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

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

:::demo 用 fill 让子节点自动填充容器

```html
<template>
  <div>
    <div style="margin-bottom:15px">
      fill: <el-switch v-model="fill"></el-switch>
    </div>
    <el-space :fill="fill" wrap>
      <el-card class="box-card" v-for="i in 3" :key="i">
        <template #header>
          <div class="card-header">
            <span>Card name</span>
            <el-button class="button" type="text">Operation button</el-button>
          </div>
        </template>
        <div v-for="o in 4" :key="o" class="text item">
          {{ 'List item ' + o }}
        </div>
      </el-card>
    </el-space>
  </div>
</template>

<script>
  export default {
    data() {
      return { fill: true }
    },
  }
</script>
```

:::

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

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

:::demo 用 fillRatio 自定义填充比例

```html
<template>
  <div>
    <div style="margin-bottom: 15px">
      direction:
      <el-radio v-model="direction" label="horizontal">horizontal</el-radio>
      <el-radio v-model="direction" label="vertical">vertical</el-radio>
    </div>
    <div style="margin-bottom: 15px">
      fillRatio:<el-slider v-model="fillRatio"></el-slider>
    </div>
    <el-space
      fill
      wrap
      :fillRatio="fillRatio"
      :direction="direction"
      style=" width: 100%"
    >
      <el-card class="box-card" v-for="i in 5" :key="i">
        <template #header>
          <div class="card-header">
            <span>Card name</span>
            <el-button class="button" type="text">Operation button</el-button>
          </div>
        </template>
        <div v-for="o in 4" :key="o" class="text item">
          {{ 'List item ' + o }}
        </div>
      </el-card>
    </el-space>
  </div>
</template>

<script>
  export default {
    data() {
      return { direction: 'horizontal', fillRatio: 30 }
    },
  }
</script>
```

:::

### Space Attributes

| 参数      | 说明                      | 类型                                      | 可选值                                                                      | 默认值     |
| --------- | ------------------------- | ----------------------------------------- | --------------------------------------------------------------------------- | ---------- |
| alignment | 对齐的方式                | string                                    | [align-items](https://developer.mozilla.org/zh-CN/docs/Web/CSS/align-items) | 'center'   |
| class     | 类名                      | string / Array<Object \| String> / Object | -                                                                           | -          |
| direction | 排列的方向                | string                                    | vertical/horizontal                                                         | horizontal |
| prefixCls | 给 space-items 的类名前缀 | string                                    | el-space                                                                    | -          |
| style     | 额外样式                  | string / Array<Object \| String> / Object | -                                                                           | -          |
| spacer    | 间隔符                    | string / number / VNode                   | -                                                                           | -          |
| size      | 间隔大小                  | string / number / [number, number]        | -                                                                           | 'small'    |
| wrap      | 设置是否自动折行          | boolean                                   | true / false                                                                | false      |
| fill      | 子元素是否填充父容器      | boolean                                   | true / false                                                                | false      |
| fillRatio | 填充父容器的比例          | number                                    | -                                                                           | 100        |

### Space Slot

| name    | 说明               |
| ------- | ------------------ |
| default | 需要添加间隔的元素 |