Coupon 优惠券选择器
介绍
用于优惠券的兑换和选择。
引入
通过以下方式来引入组件。
js
import { createApp } from 'vue';
import { CouponCell, CouponList } from '@szhn/dh-design-mobile';
const app = createApp();
app.use(CouponCell);
app.use(CouponList);代码演示
基础用法
html
<!-- 优惠券单元格 -->
<van-coupon-cell
:coupons="coupons"
:chosen-coupon="chosenCoupon"
@click="showList = true"
/>
<!-- 优惠券列表 -->
<van-popup
v-model:show="showList"
round
position="bottom"
style="height: 90%; padding-top: 4px;"
>
<van-coupon-list
:coupons="coupons"
:chosen-coupon="chosenCoupon"
:disabled-coupons="disabledCoupons"
@change="onChange"
@exchange="onExchange"
/>
</van-popup>js
import { ref } from 'vue';
export default {
setup() {
const coupon = {
available: 1,
condition: '无门槛\n最多优惠12元',
reason: '',
value: 150,
name: '优惠券名称',
startAt: 1489104000,
endAt: 1514592000,
valueDesc: '1.5',
unitDesc: '元',
};
const coupons = ref([coupon]);
const showList = ref(false);
const chosenCoupon = ref(-1);
const onChange = (index) => {
showList.value = false;
chosenCoupon.value = index;
};
const onExchange = (code) => {
coupons.value.push(coupon);
};
return {
coupons,
showList,
onChange,
onExchange,
chosenCoupon,
disabledCoupons: [coupon],
};
},
};API
CouponCell Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| title | 单元格标题 | string | 优惠券 |
| chosen-coupon | 当前选中优惠券的索引 | number | number[] | -1 |
| coupons | 可用优惠券列表 | Coupon[] | [] |
| editable | 能否切换优惠券 | boolean | true |
| border | 是否显示内边框 | boolean | true |
| currency | 货币符号 | string | ¥ |
CouponList Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| v-model:code | 当前输入的兑换码 | string | - |
| chosen-coupon | 当前选中优惠券的索引,支持多选（类型为 []） | number | number[] | -1 |
| coupons | 可用优惠券列表 | CouponInfo[] | [] |
| disabled-coupons | 不可用优惠券列表 | CouponInfo[] | [] |
| 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 | - |
| show-count | 是否展示可用 / 不可用数量 | boolean | true |
CouponList Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 优惠券切换回调 | index, 选中优惠券的索引 |
| exchange | 兑换优惠券回调 | code, 兑换码 |
CouponList Slots
| 名称 | 说明 |
|---|---|
| list-footer | 优惠券列表底部 |
| disabled-list-footer | 不可用优惠券列表底部 |
| list-button | 自定义底部按钮 |
CouponInfo 数据结构
| 键名 | 说明 | 类型 |
|---|---|---|
| id | 优惠券 id | string |
| name | 优惠券名称 | string |
| condition | 满减条件 | string |
| startAt | 卡有效开始时间 (时间戳, 单位秒) | number |
| endAt | 卡失效日期 (时间戳, 单位秒) | number |
| description | 描述信息，优惠券可用时展示 | string |
| reason | 不可用原因，优惠券不可用时展示 | string |
| value | 折扣券优惠金额，单位分 | number |
| valueDesc | 折扣券优惠金额文案 | string |
| unitDesc | 单位文案 | string |
类型定义
组件导出以下类型定义：
ts
import type { CouponCellProps, CouponListProps, CouponInfo } from '@szhn/dh-design-mobile';主题定制
样式变量
组件提供了下列 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-content-text-color | var(--van-text-color) | 优惠券内容区域的文字颜色 |
| --van-coupon-background | var(--van-background-2) | 优惠券的背景色 |
| --van-coupon-active-background | var(--van-active-color) | 激活状态下优惠券的背景色 |
| --van-coupon-radius | var(--van-radius-lg) | 优惠券的圆角大小 |
| --van-coupon-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-text-color-2) | 禁用状态下优惠券的文字颜色 |
| --van-coupon-description-padding | var(--van-padding-xs) var(--van-padding-md) | 优惠券描述区域的内边距 |
| --van-coupon-description-border-color | var(--van-border-color) | 优惠券描述区域的边框颜色 |
| --van-coupon-checkbox-color | var(--van-danger-color) | 复选框的颜色 |
| --van-coupon-list-background | var(--van-background) | 优惠券列表的背景色 |
| --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-tip-color | var(--van-text-color-2) | 列表为空时提示文字的颜色 |
| --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) | 优惠券单元格选中状态的文字颜色 |