vant/src/cell

Cell

Install

import { Cell, CellGroup } from 'vant';

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

Usage

Basic Usage

<van-cell-group>
  <van-cell title="Cell title" value="Content" />
  <van-cell title="Cell title" value="Content" label="Description" />
</van-cell-group>

Size

<van-cell-group>
  <van-cell title="Cell title" value="Content" size="large" />
  <van-cell title="Cell title" value="Content" size="large" label="Description" />
</van-cell-group>

Left Icon

<van-cell-group>
  <van-cell title="Cell title" icon="location-o" />
</van-cell-group>

Value only

<van-cell-group>
  <van-cell value="Content" />
</van-cell-group>

Link

<van-cell-group>
  <van-cell title="Cell title" is-link />
  <van-cell title="Cell title" is-link value="Content" />
  <van-cell title="Cell title" is-link arrow-direction="down" value="Content" />
</van-cell-group>

Router

<van-cell-group>
  <van-cell title="Cell title" is-link url="//youzan.github.io/vant/mobile.html" />
  <van-cell title="Cell title" is-link to="index" />
</van-cell-group>

Group Title

<van-cell-group title="Group 1">
  <van-cell title="Cell title" value="Content" />
</van-cell-group>
<van-cell-group title="Group 2">
  <van-cell title="Cell title" value="Content" />
</van-cell-group>

Advanced Usage

<van-cell value="Content" is-link>
  <template slot="title">
    <span class="custom-title">Cell title</span>
    <van-tag type="danger">Tag</van-tag>
  </template>
</van-cell>

<van-cell title="Cell title" icon="shop-o">
  <van-icon
    slot="right-icon"
    name="search"
    style="line-height: inherit;"
  />
</van-cell>

API

CellGroup Props

Attribute	Description	Type	Default
title	Group title	string	-
border	Whether to show outer border	boolean	true

Cell Props

Attribute	Description	Type	Default
icon	Left Icon	string	-
title	Title	`string	number`
value	Right text	`string	number`
label	Description below the title	string	-
size	Size，can be set to large	string	-
border	Whether to show inner border	boolean	true
center	Whether to center content vertically	boolean	true
url	Link URL	string	-
to	Target route of the link, same as to of vue-router	`string	object`
replace	If true, the navigation will not leave a history record	boolean	false
clickable	Whether to show click feedback when clicked	boolean	false
is-link	Whether to show link icon	boolean	false
required	Whether to show required mark	boolean	false
arrow-direction	Can be set to left up down	string	-
title-style	Title style	any	-
title-class	Title className	any	-
value-class	Value className	any	-
label-class	Label className	any	-

Cell Events

Event	Description	Arguments
click	Triggered when click cell	event: Event

Cell Slots

Name	Description
default	Default slot
icon	Custom icon
title	Custom title
label	Custom label
right-icon	Custom right icon