For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt, and this page is available as Markdown at https://docs.halo.run/developer-guide/plugin/api-reference/ui/base-components/space.md.

VSpace 间距

VSpace 用于给一组元素设置统一的间距,避免手动添加 margin。

引入

import { VSpace } from "@halo-dev/components";

示例

水平排列

<script lang="ts" setup>
import { VButton, VSpace } from "@halo-dev/components";
</script>

<template>
  <VSpace>
    <VButton>按钮</VButton>
    <VButton>按钮</VButton>
    <VButton>按钮</VButton>
  </VSpace>
</template>

垂直排列

<script lang="ts" setup>
import { VButton, VSpace } from "@halo-dev/components";
</script>

<template>
  <VSpace direction="column" align="start">
    <VButton>第一个按钮</VButton>
    <VButton>第二个按钮</VButton>
    <VButton>第三个按钮</VButton>
  </VSpace>
</template>

不同间距

<script lang="ts" setup>
import { VButton, VSpace } from "@halo-dev/components";
</script>

<template>
  <VSpace direction="column" align="start">
    <VSpace spacing="xs">
      <VButton size="sm">xs</VButton>
      <VButton size="sm">xs</VButton>
    </VSpace>
    <VSpace spacing="sm">
      <VButton size="sm">sm</VButton>
      <VButton size="sm">sm</VButton>
    </VSpace>
    <VSpace spacing="md">
      <VButton size="sm">md</VButton>
      <VButton size="sm">md</VButton>
    </VSpace>
    <VSpace spacing="lg">
      <VButton size="sm">lg</VButton>
      <VButton size="sm">lg</VButton>
    </VSpace>
  </VSpace>
</template>

对齐方式

<script lang="ts" setup>
import { VButton, VSpace } from "@halo-dev/components";
</script>

<template>
  <VSpace align="start">
    <VButton size="lg">大按钮</VButton>
    <VButton size="sm">小按钮</VButton>
  </VSpace>
</template>

Props

属性类型默认值说明
spacing"xs" | "sm" | "md" | "lg""xs"元素间距,对应 10、12、16、20 像素
direction"row" | "column""row"排列方向
align"start" | "end" | "center" | "stretch""center"交叉轴对齐方式

Slots

插槽说明
default需要设置间距的元素