(即将废弃)coupon-card 优惠券卡片(按钮)
收藏
我的收藏

注意
本文档即将废弃,新文档请参见 coupon-card
Android 基础库 2.74.0.0 开始支持本组件
iOS 基础库 2.93.0.0 开始支持本组件
优惠券卡片(按钮),支持以卡片或者按钮的形式展示优惠券,优惠券有立即领取、立即使用、已过期、已使用四种状态,点击立即领取会进行优惠券的领取,点击立即使用则可以跳转店铺、商详页、单店购物车、小程序页面、自定义 schema 等。
使用限制:
仅在行业 SDK 上才支持,需要在代码中配置行业 SDK 的权限:行业 SDK 的权限配置。当完成行业 SDK 的权限配置后,可通过 tt.canIUse('coupon-card') 判断该组件是否可用。
另外在使用组件时需要在页面 json 文件中进行引入。
// index.json { "usingComponents": { "coupon-card": "ext://industry/coupon-card" } }

属性说明

属性名
类型
默认值
必填
说明
最低支持版本
shop-id
string
--
当前小程序绑定的抖音小店 id
Android 2.74.0.0
iOS 2.93.0.0
coupon-id
string
--
优惠券 id
Android 2.74.0.0
iOS 2.93.0.0
style
string
--
样式
Android 2.74.0.0
iOS 2.93.0.0
class
string
--
类名
Android 2.74.0.0
iOS 2.93.0.0
is-show-button-only
boolean
false
是否只展示 button
Android 2.74.0.0
iOS 2.93.0.0
title
string
专享优惠券
优惠券标题
Android 2.74.0.0
iOS 2.93.0.0
sub-title
string
领取后前往店铺使用
优惠券副标题
Android 2.74.0.0
iOS 2.93.0.0
button-options
ButtonOptions
--
按钮选项,包括各个状态的文字及背景颜色、文字颜色
Android 2.74.0.0
iOS 2.93.0.0
img-url
string
优惠券卡片图片 URL
Android 2.74.0.0
iOS 2.93.0.0
modal-options
ModalOptions
--
点击领取时弹窗的选项
Android 2.74.0.0
iOS 2.93.0.0
is-show-coupon-info
boolean
false
默认是否展示优惠券卡片中具体的优惠券信息
Android 2.74.0.0
iOS 2.93.0.0
bind:error
function
--
失败回调
Android 2.74.0.0
iOS 2.93.0.0

ButtonOptions类型说明

属性名
类型
默认值
必填
说明
最低支持版本
unappliedText
string
点击领取
未领取优惠券状态下 button 文字
Android 2.74.0.0
iOS 2.93.0.0
appliedText
string
立即使用
已领取优惠券状态下 button 文字
Android 2.74.0.0
iOS 2.93.0.0
expiredText
string
已过期
已过期优惠券状态下 button 文字
Android 2.74.0.0
iOS 2.93.0.0
usedText
string
已使用
已使用优惠券状态下 button 文字
Android 2.74.0.0
iOS 2.93.0.0
activeBackgroundColor
string
rgb(201, 54, 37)
激活状态下(未领取或已领取) button 背景颜色
Android 2.74.0.0
iOS 2.93.0.0
activeColor
string
white
激活状态下(未领取或已领取) button 文字颜色
Android 2.74.0.0
iOS 2.93.0.0
disableBackgroundColor
string
rgb(212, 153, 140)
未激活状态下(已过期或已使用) button 背景颜色
Android 2.74.0.0
iOS 2.93.0.0
disableColor
string
rgb(252, 247, 247)
未激活状态下(已过期或已使用) button 文字颜色
Android 2.74.0.0
iOS 2.93.0.0

ModalOptions类型说明

属性名
类型
默认值
必填
说明
最低支持版本
title
string
领取优惠券
Modal 标题
Android 2.74.0.0
iOS 2.93.0.0
content
string
是否确认领取优惠券
Modal 内容
Android 2.74.0.0
iOS 2.93.0.0
confirmText
string
确认领取
确认按钮文字
Android 2.74.0.0
iOS 2.93.0.0
confirmColor
string
#F85959
确认按钮文字颜色(必须用 16 进制形式)
Android 2.74.0.0
iOS 2.93.0.0
showCancel
boolean
true
是否展示返回按钮
Android 2.74.0.0
iOS 2.93.0.0
cancelText
string
我再想想
返回按钮文字
Android 2.74.0.0
iOS 2.93.0.0
cancelColor
string
#000000
返回按钮文字颜色(必须用 16 进制形式)
Android 2.74.0.0
iOS 2.93.0.0

效果示例

代码示例

// index.ts const app = getApp() Page({ data: { buttonOptions:{ unappliedText: "去领取", appliedText: "去使用", expiredText: "过期了", usedText: "用完了", activeBackgroundColor: "red", activeColor: "yellow", disableBackgroundColor: "blue", disableColor: "green", }, modalOptions:{ title: "确定领取嘛", content: "你真的确定领取嘛", confirmText: "确定啊", confirmColor: "#FF9B9B", showCancel: true, cancelText: "不确定", cancelColor: "#CBFFA9", } }, onLoad: function () { console.log('Welcome to Mini Code') }, })
<coupon-card shop-id="52142592" coupon-id="7254457569522712832" navigate-url="shop" product-id="3612232617103068027" class={styles.myClass} style="background-color:red;" title="优惠券111" sub-title="请到店铺使用" img-url={aPic} button-options="{{buttonOptions}}" modal-options="{{modalOptions}}" is-show-button-only={false} is-show-coupon-info={true} bind:error="handleCouponError" > </coupon-card>

bind:error 说明

    当错误发生时触发。
    错误原因可能为参数校验不合法、业务错误等,具体错误内容见本文 错误码说明

代码示例

// bind:error 代码示例 handleJoinMemberError(event) { const { errMsg ,errNo} = event.detail; }

错误码说明

errNo
errMsg
说明
最低支持版本
21501
Fail to fetch ecom open api
网络错误,请检查网络状况
Android 2.74.0.0
iOS 2.93.0.0
21502
Server error
返回数据错误
Android 2.74.0.0
iOS 2.93.0.0
15921
page not found
点击立即使用跳转页面出错
Android 2.74.0.0
iOS 2.93.0.0
13000
系统错误
服务内部错误,请稍后重试或是联系客服
Android 2.74.0.0
iOS 2.93.0.0
13001
关注太快了,先休息一下吧~
用户操作太频繁,请稍后再试
Android 2.74.0.0
iOS 2.93.0.0
21601
抖音小店 id 不合法,仅支持 0-9 的字符
Android 2.74.0.0
iOS 2.93.0.0
21603
当前抖音小店 id 不存在
当前抖音小店 id 无法获取,请检查是否正确
Android 2.74.0.0
iOS 2.93.0.0
21607
抖音小店 id 与当前小程序无绑定关系
抖音小店 id 与当前小程序未绑定,请检查当前小程序是否绑定抖音小店
Android 2.74.0.0
iOS 2.93.0.0
21608
小程序未绑定对应应用
当前小程序未在店铺后台授权,请到抖店开放平台进行授权
Android 2.74.0.0
iOS 2.93.0.0

Bug & Tip

Tip:使用该接口时需要用户身份信息,请确保在调用接口前,用户已经登录宿主 APP。