vant/docs/examples-docs/coupon.md
2017-09-08 10:18:18 +08:00

4.4 KiB
Raw Blame History

Coupon 优惠券选择器

使用指南

import { CouponCell, CouponList } from 'vant';

Vue.component(CouponCell.name, CouponCell);
Vue.component(CouponList.name, CouponList);

代码演示

基础用法

:::demo 基础用法

<!-- 优惠券单元格 -->
<van-coupon-cell
  :coupons="coupons"
  :chosen-coupon="chosenCoupon"
  @click="showList = true"
></van-coupon-cell>

<!-- 优惠券列表 -->
<van-coupon-list
  v-model="showList"
  :coupons="coupons"
  :chosen-coupon="chosenCoupon"
  :disabled-coupons="disabledCoupons"
  @change="onChange"
  @exchange="onExchange"
></van-coupon-list>
const coupon = {
  available: 1,
  discount: 0,
  denominations: 150,
  origin_condition: 0,
  reason: '',
  value: 150,
  condition: '下单立减 1.50 元',
  name: '新手专用优惠券',
  start_at: 1489104000,
  end_at: 1514592000
};

export default {
  data() {
    return {
      chosenCoupon: -1,
      coupons: [coupon],
      disabledCoupons: [coupon]
    }
  },

  methods: {
    onChange(index) {
      this.chosenCoupon = index;
    },
    onExchange(code) {
      this.coupons.push(coupon);
    }
  }
}

:::

CouponCell API

参数 说明 类型 默认值 必须
title 单元格标题 String 优惠 -
chosenCoupon 当前选中优惠券的索引 Number -1 -
coupons 可用优惠券列表 Array [] -
editable 能否切换优惠券 Boolean true -

CouponList API

参数 说明 类型 默认值 必须
v-model 是否展示优惠券列表 Boolean false -
chosenCoupon 当前选中优惠券的索引 Number -1 -
coupons 可用优惠券列表 Array [] -
disabledCoupons 不可用优惠券列表 Array [] -
exchangeButtonText 兑换按钮文字 String 兑换 -
exchangeButtonDisabled 是否禁用兑换按钮 Boolean false -
displayedCouponIndex 滚动至特定优惠券位置 Number - -
closeButtonText 列表底部按钮文字 String 不使用优惠 -
disabledListTitle 不可用券列表标题 String 不可用优惠 -
inputPlaceholder 输入框文字提示 String 请输入优惠码 -

CouponList Event

事件名 说明 参数
change 优惠券切换回调 index, 选中优惠券的索引
exchange 兑换优惠券回调 code, 兑换码

数据格式

优惠券字段说明

key 说明 类型
id 优惠券 id String
name 优惠券名称 String
available 是否可用, 1:可用,0:不可用 Number
discount 折扣0为满减券88=>8.8折 Number
denominations 面值0为折扣券单位分 Number
origin_condition 满减条件0为无门槛满XX元可用单位分 Number
start_at 卡有效开始时间 Number
end_at 卡失效日期 Number
reason 不可用原因 String
value 订单优惠金额,单位分 Number
condition 格式化输出 value String