Vant Cell 單元格

2022-05-31 11:56 更新

引入

import Vue from 'vue';
import { Cell, CellGroup } from 'vant';

Vue.use(Cell);
Vue.use(CellGroup);

代碼演示

基礎用法

Cell可以單獨使用,也可以與CellGroup搭配使用。CellGroup可以為Cell提供上下外邊框

<van-cell-group>
  <van-cell title="單元格" value="內(nèi)容" />
  <van-cell title="單元格" value="內(nèi)容" label="描述信息" />
</van-cell-group>

單元格大小

通過size屬性可以控制單元格的大小

<van-cell title="單元格" value="內(nèi)容" size="large" />
<van-cell title="單元格" value="內(nèi)容" size="large" label="描述信息" />

展示圖標

通過icon屬性在標題左側(cè)展示圖標

<van-cell title="單元格" icon="location-o" />

只設置 value

只設置value時,內(nèi)容會靠左對齊

<van-cell value="內(nèi)容" />

展示箭頭

設置is-link屬性后會在單元格右側(cè)顯示箭頭,并且可以通過arrow-direction屬性控制箭頭方向

<van-cell title="單元格" is-link />
<van-cell title="單元格" is-link value="內(nèi)容" />
<van-cell title="單元格" is-link arrow-direction="down" value="內(nèi)容" />

頁面導航

可以通過url屬性進行 URL 跳轉(zhuǎn),或通過to屬性進行路由跳轉(zhuǎn)

<van-cell title="URL 跳轉(zhuǎn)" is-link url="/vant/mobile.html" />
<van-cell title="路由跳轉(zhuǎn)" is-link to="index" />

分組標題

通過CellGroup的title屬性可以指定分組標題

<van-cell-group title="分組1">
  <van-cell title="單元格" value="內(nèi)容" />
</van-cell-group>
<van-cell-group title="分組2">
  <van-cell title="單元格" value="內(nèi)容" />
</van-cell-group>

使用插槽

如以上用法不能滿足你的需求,可以使用插槽來自定義內(nèi)容

<van-cell value="內(nèi)容" is-link>
  <!-- 使用 title 插槽來自定義標題 -->
  <template slot="title">
    <span class="custom-title">單元格</span>
    <van-tag type="danger">標簽</van-tag>
  </template>
</van-cell>

<van-cell title="單元格" icon="shop-o">
  <!-- 使用 right-icon 插槽來自定義右側(cè)圖標 -->
  <van-icon
    slot="right-icon"
    name="search"
    style="line-height: inherit;"
  />
</van-cell>

垂直居中

通過center屬性可以讓Cell的左右內(nèi)容都垂直居中

<van-cell center title="單元格" value="內(nèi)容" label="描述信息" />

API

CellGroup Props

參數(shù)說明類型默認值
title分組標題string-
border是否顯示外邊框booleantrue

Cell Props

參數(shù)說明類型默認值
icon左側(cè) 圖標名稱 或圖片鏈接string-
title左側(cè)標題number | string-
value右側(cè)內(nèi)容number | string-
label標題下方的描述信息string-
size單元格大小,可選值為 largestring-
url點擊后跳轉(zhuǎn)的鏈接地址string-
to點擊后跳轉(zhuǎn)的目標路由對象,同 vue-router 的 to 屬性string | object-
border是否顯示內(nèi)邊框booleantrue
replace是否在跳轉(zhuǎn)時替換當前頁面歷史booleanfalse
clickable是否開啟點擊反饋booleanfalse
is-link是否展示右側(cè)箭頭并開啟點擊反饋booleanfalse
required是否顯示表單必填星號booleanfalse
center是否使內(nèi)容垂直居中booleanfalse
arrow-direction箭頭方向,可選值為 left up downstringright
title-style左側(cè)標題額外樣式any-
title-class左側(cè)標題額外類名any-
value-class右側(cè)內(nèi)容額外類名any-
label-class描述信息額外類名any-

Cell Events

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

CellGroup Slots

名稱說明
default默認插槽
title自定義分組標題

Cell Slots

名稱說明
default自定義右側(cè)內(nèi)容
title自定義左側(cè)標題
label自定義標題下方描述
icon自定義左側(cè)圖標
right-icon自定義右側(cè)按鈕,默認為arrow


實例演示

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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號