Vant Grid 宮格

2022-05-31 13:39 更新

介紹

宮格可以在水平方向上把頁面分隔成等寬度的區(qū)塊,用于展示內(nèi)容或進(jìn)行頁面導(dǎo)航

引入

import Vue from 'vue';
import { Grid, GridItem } from 'vant';

Vue.use(Grid);
Vue.use(GridItem);

代碼演示

基本用法

通過icon屬性設(shè)置格子內(nèi)的圖標(biāo),text屬性設(shè)置文字內(nèi)容

<van-grid>
  <van-grid-item icon="photo-o" text="文字" />
  <van-grid-item icon="photo-o" text="文字" />
  <van-grid-item icon="photo-o" text="文字" />
  <van-grid-item icon="photo-o" text="文字" />
</van-grid>

自定義列數(shù)

默認(rèn)一行展示四個格子,可以通過column-num自定義列數(shù)

<van-grid :column-num="3">
  <van-grid-item
    v-for="value in 6"
    :key="value"
    icon="photo-o"
    text="文字"
  />
</van-grid>

自定義內(nèi)容

通過插槽可以自定義格子展示的內(nèi)容

<van-grid :border="false" :column-num="3">
  <van-grid-item>
    <van-image src="https://img.yzcdn.cn/vant/apple-1.jpg" rel="external nofollow"  />
  </van-grid-item>
  <van-grid-item>
    <van-image src="https://img.yzcdn.cn/vant/apple-2.jpg" rel="external nofollow"  />
  </van-grid-item>
  <van-grid-item>
    <van-image src="https://img.yzcdn.cn/vant/apple-3.jpg" rel="external nofollow"  />
  </van-grid-item>
</van-grid>

正方形格子

設(shè)置square屬性后,格子的高度會和寬度保持一致

<van-grid square>
  <van-grid-item
    v-for="value in 8"
    :key="value"
    icon="photo-o"
    text="文字"
  />
</van-grid>

格子間距

通過gutter屬性設(shè)置格子之間的距離

<van-grid :gutter="10">
  <van-grid-item
    v-for="value in 8"
    :key="value"
    icon="photo-o"
    text="文字"
  />
</van-grid>

頁面導(dǎo)航

通過to屬性設(shè)置vue-router跳轉(zhuǎn)鏈接,通過url屬性設(shè)置 URL 跳轉(zhuǎn)鏈接

<van-grid clickable :column-num="2">
  <van-grid-item icon="home-o" text="路由跳轉(zhuǎn)" to="/" />
  <van-grid-item icon="search" text="URL 跳轉(zhuǎn)" url="/vant/mobile.html" />
</van-grid>

提示信息

設(shè)置dot屬性后,會在圖標(biāo)右上角展示一個小紅點(diǎn)。設(shè)置info屬性后,會在圖標(biāo)右上角展示相應(yīng)的徽標(biāo)

<van-grid :column-num="2">
  <van-grid-item icon="home-o" text="文字" dot />
  <van-grid-item icon="search" text="文字" info="99+" />
</van-grid>

API

Grid Props

參數(shù)說明類型默認(rèn)值
column-num v2.0.4列數(shù)number | string4
icon-size v2.2.6圖標(biāo)大小,默認(rèn)單位為pxnumber | string28px
gutter格子之間的間距,默認(rèn)單位為pxnumber | string0
border是否顯示邊框booleantrue
center是否將格子內(nèi)容居中顯示booleantrue
square是否將格子固定為正方形booleanfalse
clickable是否開啟格子點(diǎn)擊反饋booleanfalse

GridItem Props

參數(shù)說明類型默認(rèn)值
text文字string-
icon圖標(biāo)名稱 或圖片鏈接string-
dot v2.2.1是否顯示圖標(biāo)右上角小紅點(diǎn)booleanfalse
info v2.2.1圖標(biāo)右上角徽標(biāo)的內(nèi)容number | string-
url點(diǎn)擊后跳轉(zhuǎn)的鏈接地址string-
to點(diǎn)擊后跳轉(zhuǎn)的目標(biāo)路由對象,同 vue-router 的 to 屬性string | object-
replace是否在跳轉(zhuǎn)時替換當(dāng)前頁面歷史booleanfalse

GridItem Events

事件名說明回調(diào)參數(shù)
click點(diǎn)擊格子時觸發(fā)event: Event

GridItem Slots

名稱說明
default自定義宮格的所有內(nèi)容
icon自定義圖標(biāo)
text自定義文字


實(shí)例演示

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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號