Coupon - Vant 4

Coupon

Intro

Used for redemption and selection of coupons.

Install

Register component globally via app.use, refer to Component Registration for more registration ways.

import { createApp } from'vue'; import { CouponCell, CouponList } from'vant'; const app = createApp(); app.use(CouponCell); app.use(CouponList);

Usage

Basic Usage

import { ref } from'vue'; exportdefault { setup() { const coupon = { available: 1, originCondition: 0, reason: '', value: 150, name: 'Coupon name', startAt: 1489104000, endAt: 1514592000, valueDesc: '1.5', unitDesc: 'Ԫ', }; const coupons = ref([coupon]); const showList = ref(false); const chosenCoupon = ref(-1); constonChange = (index) => { showList.value = false; chosenCoupon.value = index; }; constonExchange = (code) => { coupons.value.push(coupon); }; return { coupons, showList, onChange, onExchange, chosenCoupon, disabledCoupons: [coupon], }; }, };

API

CouponCell Props

Attribute	Description	Type	Default
title	Cell title	string	Coupon
chosen-coupon	Index of chosen coupon	*number	number[]*
coupons	Coupon list	Coupon[]	[]
editable	Cell editable	boolean	true
border	Whether to show inner border	boolean	true
currency	Currency symbol	string	��

CouponList Props

Attribute	Description	Type	Default
v-model	Current exchange code	string	-
chosen-coupon	Index of chosen coupons, support multiple selection (type is [])	*number	number[]*
coupons	Coupon list	CouponInfo[]	[]
disabled-coupons	Disabled coupon list	CouponInfo[]	[]
enabled-title	Title of coupon list	string	Available
disabled-title	Title of disabled coupon list	string	Unavailable
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
input-placeholder	Input placeholder	string	Coupon code
currency	Currency symbol	string	��
empty-image	Placeholder image when list is empty	string	-
show-count	Whether to show coupon count in tab title	boolean	true

CouponList Events

Event	Description	Arguments
change	Emitted when chosen coupon changed	index: index of chosen coupon
exchange	Emitted when exchanging coupon	code: exchange code

CouponList Slots

Name	Description
list-footer	Coupon list bottom
disabled-list-footer	Unavailable coupons list bottom
list-button	Customize the bottom button

Data Structure of CouponInfo

Key	Description	Type
id	Id	string
name	Name	string
condition	Condition	string
startAt	Start time (Timestamp, unit second)	number
endAt	End time (Timestamp, unit second)	number
description	Description	string
reason	Unavailable reason	string
value	Value	number
valueDesc	Value Text	string
unitDesc	Unit Text	string

Types

The component exports the following type definitions:

importtype { CouponCellProps, CouponListProps, CouponInfo } from'vant';

Theming

CSS Variables

The component provides the following CSS variables, which can be used to customize styles. Please refer to ConfigProvider component.

Name	Default Value	Description
--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)	-