mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-04-06 03:57:59 +08:00
115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
## Coupon
|
|
|
|
### Install
|
|
``` javascript
|
|
import { CouponCell, CouponList } from 'vant';
|
|
|
|
Vue.use(CouponCell).use(CouponList);
|
|
```
|
|
|
|
### Usage
|
|
|
|
#### Basic Usage
|
|
|
|
```html
|
|
<!-- Coupon Cell -->
|
|
<van-coupon-cell
|
|
:coupons="coupons"
|
|
:chosen-coupon="chosenCoupon"
|
|
@click="showList = true"
|
|
/>
|
|
|
|
<!-- Coupon List -->
|
|
<van-popup v-model="showList" position="bottom">
|
|
<van-coupon-list
|
|
:coupons="coupons"
|
|
:chosen-coupon="chosenCoupon"
|
|
:disabled-coupons="disabledCoupons"
|
|
@change="onChange"
|
|
@exchange="onExchange"
|
|
/>
|
|
</van-popup>
|
|
```
|
|
|
|
```javascript
|
|
const coupon = {
|
|
available: 1,
|
|
discount: 0,
|
|
denominations: 150,
|
|
origin_condition: 0,
|
|
reason: '',
|
|
value: 150,
|
|
name: 'Coupon name',
|
|
start_at: 1489104000,
|
|
end_at: 1514592000
|
|
};
|
|
|
|
export default {
|
|
data() {
|
|
return {
|
|
chosenCoupon: -1,
|
|
coupons: [coupon],
|
|
disabledCoupons: [coupon]
|
|
}
|
|
},
|
|
|
|
methods: {
|
|
onChange(index) {
|
|
this.showList = false;
|
|
this.chosenCoupon = index;
|
|
},
|
|
onExchange(code) {
|
|
this.coupons.push(coupon);
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### CouponCell API
|
|
|
|
| Attribute | Description | Type | Default | Accepted Values |
|
|
|-----------|-----------|-----------|-------------|-------------|
|
|
| title | Cell title | `String` | `Coupon` | - |
|
|
| chosen-coupon | Index of chosen coupon | `Number` | `-1` | - |
|
|
| coupons | Coupon list | `Array` | `[]` | - |
|
|
| editable | Cell editable | `Boolean` | `true` | - |
|
|
|
|
### CouponList API
|
|
|
|
| Attribute | Description | Type | Default | Accepted Values |
|
|
|-----------|-----------|-----------|-------------|-------------|
|
|
| v-model | Current exchange code | `String` | - | - |
|
|
| chosen-coupon | Index of chosen coupon | `Number` | `-1` | - |
|
|
| coupons | Coupon list | `Array` | `[]` | - |
|
|
| disabled-coupons | Disabled voupon list | `Array` | `[]` | - |
|
|
| exchange-button-text | Exchange button text | `String` | `Exchange` | - |
|
|
| exchange-button-loading | Whether to show loading in exchange button | `Boolean` | `false` | - |
|
|
| exchange-button-disabled | Whether to disable exchange button | `Boolean` | `false` | - |
|
|
| exchange-min-length | Min length to enable exchange button | `Number` | `1` | - |
|
|
| displayed-coupon-index | Index of displayed coupon | `Number` | - | - |
|
|
| close-button-text | Close button text | `String` | `Close` | - |
|
|
| disabled-list-title | Disabled list title | `String` | `Unavailable` | - |
|
|
| input-placeholder | Input placeholder | `String` | `Coupon code` | - |
|
|
|
|
### CouponList Event
|
|
|
|
| Event | Description | Arguments |
|
|
|-----------|-----------|-----------|
|
|
| change | Triggered when change chosen coupon | index: index of chosen coupon |
|
|
| exchange | Triggered when exchange coupon | code: exchange code |
|
|
|
|
### Coupon Item Data Structure
|
|
|
|
| key | Description | Type |
|
|
|-----------|-----------|-----------|
|
|
| id | Id | `String` |
|
|
| name | Name | `String` |
|
|
| discount | Discount | `Number` |
|
|
| denominations | Denominations | `Number` |
|
|
| origin_condition | Condition | `Number` |
|
|
| start_at | Start time (Timestmap, unit second) | `Number` |
|
|
| end_at | End time (Timestmap, unit second) | `Number` |
|
|
| reason | Unavailable reason | `String` |
|
|
| value | Value | `Number` |
|
|
|