Vant3 Coupon 优惠券选择器

2021-09-14 11:01 更新

介绍

用于优惠券的兑换和选择。

实例演示

引入

通过以下方式来全局注册组件,更多注册方式请参考组件注册

import { createApp } from 'vue';
import { CouponCell, CouponList } from 'vant';

const app = createApp();
app.use(CouponCell);
app.use(CouponList);

代码演示

基础用法

<!-- 优惠券单元格 -->
<van-coupon-cell
  :coupons="state.coupons"
  :chosen-coupon="state.chosenCoupon"
  @click="state.showList = true"
/>
<!-- 优惠券列表 -->
<van-popup
  v-model="state.showList"
  round
  position="bottom"
  style="height: 90%; padding-top: 4px;"
>
  <van-coupon-list
    :coupons="state.coupons"
    :chosen-coupon="state.chosenCoupon"
    :disabled-coupons="disabledCoupons"
    @change="onChange"
    @exchange="onExchange"
  />
</van-popup>
import { reactive } from 'vue';

const coupon = {
  available: 1,
  condition: '无使用门槛\n最多优惠12元',
  reason: '',
  value: 150,
  name: '优惠券名称',
  startAt: 1489104000,
  endAt: 1514592000,
  valueDesc: '1.5',
  unitDesc: '元',
};

export default {
  setup() {
    const state = reactive({
      coupons: [coupon],
      showList: false,
      chosenCoupon: -1,
    });

    const onChange = (index) => {
      state.showList = false;
      state.chosenCoupon = index;
    };
    const onExchange = (code) => {
      state.coupons.push(coupon);
    };

    return {
      state,
      onChange,
      onExchange,
      disabledCoupons: [coupon],
    };
  },
};

API

CouponCell Props

参数 说明 类型 默认值
title 单元格标题 string 优惠券
chosen-coupon 当前选中优惠券的索引 number | string -1
coupons 可用优惠券列表 Coupon[] []
editable 能否切换优惠券 boolean true
border 是否显示内边框 boolean true
currency 货币符号 string ¥

CouponList Props

参数 说明 类型 默认值
v-model:code 当前输入的兑换码 string -
chosen-coupon 当前选中优惠券的索引 number -1
coupons 可用优惠券列表 Coupon[] []
disabled-coupons 不可用优惠券列表 Coupon[] []
enabled-title 可用优惠券列表标题 string 可使用优惠券
disabled-title 不可用优惠券列表标题 string 不可使用优惠券
exchange-button-text 兑换按钮文字 string 兑换
exchange-button-loading 是否显示兑换按钮加载动画 boolean false
exchange-button-disabled 是否禁用兑换按钮 boolean false
exchange-min-length 兑换码最小长度 number 1
displayed-coupon-index 滚动至特定优惠券位置 number -
show-close-button 是否显示列表底部按钮 boolean true
close-button-text 列表底部按钮文字 string 不使用优惠
input-placeholder 输入框文字提示 string 请输入优惠码
show-exchange-bar 是否展示兑换栏 boolean true
currency 货币符号 string ¥
empty-image 列表为空时的占位图 string https://img.yzcdn.cn/vant/coupon-empty.png
show-count 是否展示可用 / 不可用数量 boolean true

CouponList Events

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

CouponList Slots

名称 说明
list-footer v3.0.18 优惠券列表底部
disabled-list-footer v3.0.18 不可用优惠券列表底部

Coupon 数据结构

键名 说明 类型
id 优惠券 id string
name 优惠券名称 string
condition 满减条件 string
startAt 卡有效开始时间 (时间戳, 单位秒) number
endAt 卡失效日期 (时间戳, 单位秒) number
description 描述信息,优惠券可用时展示 string
reason 不可用原因,优惠券不可用时展示 string
value 折扣券优惠金额,单位分 number
valueDesc 折扣券优惠金额文案 string
unitDesc 单位文案 string

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件

名称 默认值 描述
--van-coupon-margin 0 var(--van-padding-sm) var(--van-padding-sm) -
--van-coupon-content-height 84px -
--van-coupon-content-padding 14px 0 -
--van-coupon-background-color var(--van-white) -
--van-coupon-active-background-color var(--van-active-color) -
--van-coupon-border-radius var(--van-border-radius-lg) -
--van-coupon-box-shadow 0 0 4px rgba(0, 0, 0, 0.1) -
--van-coupon-head-width 96px -
--van-coupon-amount-color var(--van-danger-color) -
--van-coupon-amount-font-size 30px -
--van-coupon-currency-font-size 40% -
--van-coupon-name-font-size var(--van-font-size-md) -
--van-coupon-disabled-text-color var(--van-gray-6) -
--van-coupon-description-padding var(--van-padding-xs) var(--van-padding-md) -
--van-coupon-description-border-color var(--van-border-color) -
--van-coupon-corner-checkbox-icon-color var(--van-danger-color) -
--van-coupon-list-background-color var(--van-background-color) -
--van-coupon-list-field-padding 5px 0 5px var(--van-padding-md) -
--van-coupon-list-exchange-button-height 32px -
--van-coupon-list-close-button-height 40px -
--van-coupon-list-empty-image-size 200px -
--van-coupon-list-empty-tip-color var(--van-gray-6) -
--van-coupon-list-empty-tip-font-size var(--van-font-size-md) -
--van-coupon-list-empty-tip-line-height var(--van-line-height-md) -
--van-coupon-cell-selected-text-color var(--van-text-color) -


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号