mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-04-06 03:57:59 +08:00
100 lines
2.4 KiB
Markdown
100 lines
2.4 KiB
Markdown
## Cell
|
|
|
|
### Install
|
|
``` javascript
|
|
import { Cell, CellGroup } from 'vant';
|
|
|
|
Vue.use(Cell).use(CellGroup);
|
|
```
|
|
|
|
### Usage
|
|
|
|
#### Basic Usage
|
|
|
|
```html
|
|
<van-cell-group>
|
|
<van-cell title="Cell title" value="Content" />
|
|
<van-cell title="Cell title" value="Content" label="Description" />
|
|
</van-cell-group>
|
|
```
|
|
|
|
#### Value only
|
|
|
|
```html
|
|
<van-cell-group>
|
|
<van-cell value="Content" />
|
|
</van-cell-group>
|
|
```
|
|
|
|
#### Left Icon
|
|
|
|
```html
|
|
<van-cell-group>
|
|
<van-cell title="Cell title" icon="location" />
|
|
</van-cell-group>
|
|
```
|
|
|
|
#### Link
|
|
|
|
```html
|
|
<van-cell-group>
|
|
<van-cell title="Cell title" is-link />
|
|
<van-cell title="Cell title" is-link value="Content" />
|
|
</van-cell-group>
|
|
```
|
|
|
|
#### Advanced Usage
|
|
|
|
```html
|
|
<van-cell-group>
|
|
<van-cell value="Content" icon="shop" is-link>
|
|
<template slot="title">
|
|
<span class="van-cell-text">Cell title</span>
|
|
<van-tag type="danger">Tag</van-tag>
|
|
</template>
|
|
</van-cell>
|
|
<van-cell title="Cell title" icon="location" is-link />
|
|
<van-cell title="Cell title">
|
|
<van-icon slot="right-icon" name="search" class="van-cell__right-icon" />
|
|
</van-cell>
|
|
</van-cell-group>
|
|
```
|
|
|
|
### CellGroup API
|
|
|
|
| Attribute | Description | Type | Default |
|
|
|-----------|-----------|-----------|-------------|
|
|
| border | Whether to show outer border | `Boolean` | `true` |
|
|
|
|
### Cell API
|
|
|
|
| Attribute | Description | Type | Default |
|
|
|-----------|-----------|-----------|-------------|
|
|
| icon | Left Icon | `String` | - |
|
|
| title | Title | `String | Number` | - |
|
|
| value | Right text | `String | Number` | - |
|
|
| label | Description below the title | `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 | `String` | `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` |
|
|
|
|
### Cell Event
|
|
|
|
| Event | Description | Arguments |
|
|
|-----------|-----------|-----------|
|
|
| click | Triggered when click cell | - |
|
|
|
|
### Cell Slot
|
|
|
|
| name | Description |
|
|
|-----------|-----------|
|
|
| - | Default slot |
|
|
| icon | Custom icon |
|
|
| title | Custom title |
|
|
| right-icon | Custom right icon |
|