更新记录

1.0.0(2026-03-11) 下载此版本

一个可复用的优惠券展示组件,支持金额券/折扣券、状态展示、按钮插槽、自定义主题色与缺口背景色。


平台兼容性

uni-app(3.7.0)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟

其他

多语言 暗黑模式 宽屏模式
× ×

x-coupon 优惠券组件

一个可复用的优惠券展示组件,支持金额券/折扣券、状态展示、按钮插槽、自定义主题色与缺口背景色。

引入方式

在页面中手动引入:

<script>
import xCoupon from '@/components/x-coupon/x-coupon.vue'

export default {
  components: { xCoupon }
}
</script>

基本用法

<template>
  <view style="padding: 24rpx; background: #f5f5f5;">
    <x-coupon
      value="100"
      condition="满500可用"
      title="全场通用券"
      desc="仅限服饰类商品"
      validity="2026.12.31 到期"
      @click="onUse"
    />
  </view>
</template>

<script>
import xCoupon from '@/components/x-coupon/x-coupon.vue'

export default {
  components: { xCoupon },
  methods: {
    onUse() {
      uni.showToast({ title: '使用优惠券', icon: 'none' })
    }
  }
}
</script>

折扣券

<x-coupon
  type="discount"
  value="8.5"
  title="会员专享折扣"
  condition="无门槛"
  color="#FF9800"
/>

状态展示

<x-coupon value="50" title="新人券" status="used" disabled />
<x-coupon value="20" title="限时券" status="expired" disabled />

自定义按钮(插槽)

<x-coupon value="30" title="外卖券">
  <template #action>
    <view style="padding: 8rpx 22rpx; border-radius: 999rpx; background: #111; color: #fff; font-size: 24rpx;">
      去使用
    </view>
  </template>
</x-coupon>

Props

参数 说明 类型 默认值
type 券类型:money 金额券 / discount 折扣券 String money
value 面值(金额或折扣值) Number | String 必填
currency 金额币种符号(仅 money 时展示) String ¥
condition 使用条件文案 String ''
title 标题 String 优惠券
desc 描述文案 String ''
validity 有效期文案 String ''
color 左侧主题色(也用于默认按钮色) String #ff5a5f
backgroundColor 卡券背景色 String #ffffff
cutoutColor 缺口圆背景色(通常传页面背景色;需要透明可传 transparent String #f5f5f5
disabled 是否禁用点击(禁用时不会触发 click) Boolean false
status 状态:available / used / expired String available
btnText 默认按钮文字(未使用 action 插槽时) String 立即使用
showBtn 是否显示默认按钮 Boolean true

Events

事件 说明 回调参数
click 点击卡券(仅 status=available 且未禁用时触发)

Slots

名称 说明
action 右侧操作区域插槽(自定义按钮/图标等)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。