用于优惠券的兑换和选择。
通过以下方式来全局注册组件,更多注册方式请参考组件注册。
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],
};
},
};
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
title | 单元格标题 | string | 优惠券
|
chosen-coupon | 当前选中优惠券的索引 | number | string | -1
|
coupons | 可用优惠券列表 | Coupon[] | []
|
editable | 能否切换优惠券 | boolean | true
|
border | 是否显示内边框 | boolean | true
|
currency | 货币符号 | string | ¥
|
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
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
|
事件名 | 说明 | 回调参数 |
---|---|---|
change | 优惠券切换回调 | index, 选中优惠券的索引 |
exchange | 兑换优惠券回调 | code, 兑换码 |
名称 | 说明 |
---|---|
list-footer v3.0.18
|
优惠券列表底部 |
disabled-list-footer v3.0.18
|
不可用优惠券列表底部 |
键名 | 说明 | 类型 |
---|---|---|
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) | - |
介绍用于从一组相关联的数据集合中进行选择。实例演示引入通过以下方式来全局注册组件,更多注册方式请参考组件注册。import { c...
我们对字体进行统一规范,力求在各个操作系统下都有最佳展示效果。中文字体英文/数字字体Font-family 代码font-family: "Helvet...
用于选择或输入日期选择日以「日」为基本单位,基础的日期选择控件基本单位由type属性指定。快捷选项需配置shortcuts,禁用日期...