mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-05-06 15:46:34 +08:00
140 lines
3.5 KiB
Markdown
140 lines
3.5 KiB
Markdown
# SwipeCell
|
|
|
|
### Install
|
|
|
|
```js
|
|
import Vue from 'vue';
|
|
import { SwipeCell } from 'vant';
|
|
|
|
Vue.use(SwipeCell);
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Basic Usage
|
|
|
|
```html
|
|
<van-swipe-cell>
|
|
<template #left>
|
|
<van-button square type="primary" text="Select" />
|
|
</template>
|
|
<van-cell :border="false" title="Cell" value="Cell Content" />
|
|
<template #right>
|
|
<van-button square type="danger" text="Delete" />
|
|
<van-button square type="primary" text="Collect" />
|
|
</template>
|
|
</van-swipe-cell>
|
|
```
|
|
|
|
### Custom Content
|
|
|
|
```html
|
|
<van-swipe-cell>
|
|
<van-card
|
|
num="2"
|
|
price="2.00"
|
|
desc="Description"
|
|
title="Title"
|
|
class="goods-card"
|
|
thumb="https://img.yzcdn.cn/vant/cat.jpeg"
|
|
/>
|
|
<template #right>
|
|
<van-button square text="Delete" type="danger" class="delete-button" />
|
|
</template>
|
|
</van-swipe-cell>
|
|
|
|
<style>
|
|
.goods-card {
|
|
margin: 0;
|
|
background-color: @white;
|
|
}
|
|
|
|
.delete-button {
|
|
height: 100%;
|
|
}
|
|
</style>
|
|
```
|
|
|
|
### Before Close
|
|
|
|
```html
|
|
<van-swipe-cell :before-close="beforeClose">
|
|
<template #left>
|
|
<van-button square type="primary" text="Select" />
|
|
</template>
|
|
<van-cell :border="false" title="Cell" value="Cell Content" />
|
|
<template #right>
|
|
<van-button square type="danger" text="Delete" />
|
|
</template>
|
|
</van-swipe-cell>
|
|
```
|
|
|
|
```js
|
|
export default {
|
|
methods: {
|
|
beforeClose({ position, instance }) {
|
|
switch (position) {
|
|
case 'left':
|
|
case 'cell':
|
|
case 'outside':
|
|
instance.close();
|
|
break;
|
|
case 'right':
|
|
Dialog.confirm({
|
|
message: 'Are you sure to delete?',
|
|
}).then(() => {
|
|
instance.close();
|
|
});
|
|
break;
|
|
}
|
|
},
|
|
},
|
|
};
|
|
```
|
|
|
|
## API
|
|
|
|
### Props
|
|
|
|
| Attribute | Description | Type | Default |
|
|
| --- | --- | --- | --- |
|
|
| name `v2.0.4` | Identifier of SwipeCell | _number \| string_ | - |
|
|
| left-width | Width of the left swipe area | _number \| string_ | `auto` |
|
|
| right-width | Width of the right swipe area | _number \| string_ | `auto` |
|
|
| before-close `v2.3.0` | Callback function before close | _Function_ | - |
|
|
| disabled | Whether to disabled swipe | _boolean_ | `false` |
|
|
| stop-propagation `v2.1.0` | Whether to stop touchmove event propagation | _boolean_ | `false` |
|
|
|
|
### Slots
|
|
|
|
| Name | Description |
|
|
| ------- | ------------------------------- |
|
|
| default | custom content |
|
|
| left | content of left scrollable area |
|
|
| right | content of right scrollabe area |
|
|
|
|
### Events
|
|
|
|
| Event | Description | Arguments |
|
|
| --- | --- | --- |
|
|
| click | Triggered when clicked | Click positon (`left` `right` `cell` `outside`) |
|
|
| open | Triggered when opened | { position: 'left' \| 'right' , name: string } |
|
|
| close | Triggered when closed | { position: string , name: string } |
|
|
|
|
### beforeClose Params
|
|
|
|
| Attribute | Description | Type |
|
|
| --------- | ----------------------------------------------- | ----------- |
|
|
| name | Name | _string_ |
|
|
| position | Click positon (`left` `right` `cell` `outside`) | _string_ |
|
|
| instance | SwipeCell instance | _SwipeCell_ |
|
|
|
|
### Methods
|
|
|
|
Use [ref](https://vuejs.org/v2/api/#ref) to get SwipeCell instance and call instance methods
|
|
|
|
| Name | Description | Attribute | Return value |
|
|
| ----- | --------------- | ------------------------ | ------------ |
|
|
| open | open SwipeCell | position: `left | right` | - |
|
|
| close | close SwipeCell | - | - |
|