Vant4 Space 間距

2023-02-16 17:54 更新

介紹

設(shè)置元素之間的間距,從 ?v3.6.0? 版本開始支持。

引入

通過以下方式來全局注冊組件,更多注冊方式請參考組件注冊。

import { createApp } from 'vue';
import { Space } from 'vant';

const app = createApp();
app.use(Space);

代碼演示

基礎(chǔ)用法

Space 組件會(huì)在各個(gè)子組件之間設(shè)置一定的間距,默認(rèn)間距為 ?8px?。

<van-space>
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
</van-space>

垂直排列

將 ?direction? 屬性設(shè)置為 ?vertical?,可以設(shè)置垂直方向排列的間距。

<van-space direction="vertical" fill>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
</van-space>

自定義間距

通過調(diào)整 ?size? 的值來控制間距的大小。傳入 ?number? 類型時(shí),會(huì)默認(rèn)使用 ?px? 單位;也可以傳入 ?string? 類型,比如 ?2rem? 或 ?5vw? 等帶有單位的值。

<!-- 20px -->
<van-space :size="20">
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
</van-space>

<!-- 2rem -->
<van-space size="2rem">
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
  <van-button type="primary">按鈕</van-button>
</van-space>

對齊方式

通過調(diào)整 ?align? 的值來設(shè)置子元素的對齊方式, 可選值為 ?start?, ?center? ,?end? ,?baseline?,在水平模式下的默認(rèn)值為 ?center?。

<van-radio-group
  v-model="align"
  direction="horizontal"
  style="margin-bottom: 16px"
>
  <van-radio name="start">start</van-radio>
  <van-radio name="center">center</van-radio>
  <van-radio name="end">end</van-radio>
  <van-radio name="baseline">baseline</van-radio>
</van-radio-group>

<van-space :align="align" style="padding: 16px; background: #f3f2f5">
  <van-button type="primary">{{ align }}</van-button>
  <div style="padding: 40px 20px; background: #fff">Block</div>
</van-space>
import { ref } from 'vue';

export default {
  setup() {
    const align = ref('center');
    return { align };
  },
};

自動(dòng)換行

在水平模式下, 通過 ?wrap? 屬性來控制子元素是否自動(dòng)換行。

<van-space wrap>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
  <van-button type="primary" block>按鈕</van-button>
</van-space>

API

Props

參數(shù) 說明 類型 默認(rèn)值
direction 間距方向 vertical | horizontal horizontal
size 間距大小,如 20px 2em,默認(rèn)單位為 px,支持?jǐn)?shù)組形式來分別設(shè)置橫向和縱向間距 number | string | number[] | string[] 8px
align 設(shè)置子元素的對齊方式 start | end | center | baseline -
wrap 是否自動(dòng)換行,僅適用于水平方向排列 boolean false
fill 是否讓 Space 變?yōu)橐粋€(gè)塊級元素,填充整個(gè)父元素 boolean false

Slots

名稱 說明
default 間距組件內(nèi)容

類型定義

組件導(dǎo)出以下類型定義:

import type { SpaceProps, SpaceSize, SpaceAlign } from 'vant';


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號