Business

SaleItem商品卡片

适用于列表商品展示的场景。

适用于列表商品展示的场景。

示例图

基础用法

页面 .json 文件 usingComponents 中引入组件

// json
{
    "usingComponents": {
        "mx-sale-item": "/components/mxwui/sale-item/index"
    }
}

页面 .wxml 文件中使用组件

<mx-sale-item cover="" title="" />

更多用法示例

下标值 index

属性:index,主要用于确认是哪个saleitem触发的事件。

<mx-sale-item index="0" />

商品封面 cover

属性:cover,图片地址,必填。

<mx-sale-item cover="图片地址" />

标题 title

属性:title,标题内容,必填。

<mx-sale-item title="标题" />

标题文本色 titleColor

属性:titleColor,默认 #040A23,支持任何合法的颜色值。

<mx-sale-item titleColor="#1677FF" />

标题显示行数 lineClamp

属性:lineClamp,默认 1,数字。

<mx-sale-item lineClamp="2" />

标题前标签 label

属性:label,标签内容。

<mx-sale-item label="促销" />

标题前标签文本色 labelColor

属性:labelColor,默认 #FFFFFF,支持任何合法的颜色值。

<mx-sale-item labelColor="#1677FF" />

标题前标签背景色 labelBgColor

属性:labelBgColor,默认 #CA0E2D,支持任何合法的颜色值。

<mx-sale-item labelBgColor="#1677FF" />

价格单位 priceUnit

属性:priceUnit,默认 ¥,默认人民币符号。

<mx-sale-item priceUnit="$" />

价格 price

属性:price,默认 0,数字。

<mx-sale-item price="520" />

价格颜色 priceColor

属性:priceColor,默认 #CA0E2D,支持任何合法的颜色值。

<mx-sale-item priceColor="#1677FF" />

价格后扩展文本 extendText

属性:extendText,可用于显示原价或其他信息。

<mx-sale-item extendText="文本" />

扩展文本颜色 extendColor

属性:extendColor,默认 #9AA0B1,支持任何合法的颜色值。

<mx-sale-item extendColor="#1677FF" />

扩展文本是否有删除线 lineThrough

属性:lineThrough,默认 false,没有删除线。

  • 显示删除线
<mx-sale-item lineThrough />

<mx-sale-item lineThrough="{{true}}" />
  • 不显示删除线
<mx-sale-item />

<mx-sale-item lineThrough="{{false}}" />

属性标签组 tags

属性:tags,数组。

参数:text,标签文案,必填。

参数:textColor,标签文案文本色,默认 #CA0E2D,支持任何合法的颜色值。

参数:borderColor,标签边框色,默认 #CA0E2D,支持任何合法的颜色值。

参数:bgColor,标签背景色,默认 #FFFFFF,支持任何合法的颜色值。

data: {
    tags: [
        {
            text: '包邮',
            textColor: '#FFFFFF',
            borderColor: '#1677FF',
            bgColor: '#1677FF'
        }
    ]
}
<mx-sale-item tags="tags" />

按钮文案 btnText

属性:btnText,按钮文案,有则展示按钮。

<mx-sale-item btnText="购买" />

按钮文本色 btnTextColor

属性:btnTextColor,默认 #FFFFFF,支持任何合法的颜色值。

<mx-sale-item btnTextColor="#1677FF" />

按钮边框颜色 btnBorderColor

属性:btnBorderColor,默认 #CA0E2D,支持任何合法的颜色值。

<mx-sale-item btnBorderColor="#1677FF" />

按钮背景色 btnBgColor

属性:btnBgColor,默认 #CA0E2D,支持任何合法的颜色值。

<mx-sale-item btnBgColor="#1677FF" />

自定义事件

事件:bind:sale_item_tap,卡片点击事件,返回 event.detail.index。

事件:bind:sale_item_btn_tap,按钮点击事件,返回 event.detail.index。

<mx-sale-item 
    bind:sale_item_tap="handleItem" 
    bind:sale_item_btn_tap="handleBtn" 
/>

参数

参数 类型 必填 可选值 默认值 参数描述
index Number 数字 下标值
cover String 是 商品封面
title String 是 标题
titleColor String 颜色值 #040A23 标题文本色,支持任何合法的颜色值
lineClamp Number 数字 1 标题显示行数
label String 标题前标签
labelColor String 颜色值 #FFFFFF 标题前标签文本色,支持任何合法的颜色值
labelBgColor String 颜色值 #CA0E2D 标题前标签背景色,支持任何合法的颜色值
priceUnit String ¥ 价格单位
price Number 数字 0 价格
priceColor String 颜色值 #CA0E2D 价格颜色,支持任何合法的颜色值
extendText String 价格后扩展文本
extendColor String 颜色值 #9AA0B1 扩展文本颜色,支持任何合法的颜色值
lineThrough Boolean true、false false 扩展文本是否有删除线
tags Array 属性标签组
btnText String 按钮文案
btnTextColor String 颜色值 #FFFFFF 按钮文本色,支持任何合法的颜色值
btnBorderColor String 颜色值 #CA0E2D 按钮边框颜色,支持任何合法的颜色值
btnBgColor String 颜色值 #CA0E2D 按钮背景色,支持任何合法的颜色值

tags 属性标签组

参数 类型 必填 可选值 默认值 参数描述
text String 标签文本
textColor String 颜色值 #CA0E2D 标签文本色,支持任何合法的颜色值
borderColor String 颜色值 #CA0E2D 标签边框色,支持任何合法的颜色值
bgColor String 颜色值 #FFFFFF 标签背景色,支持任何合法的颜色值

事件

事件名称 类型 返回值 事件说明
bind:sale_item_tap Click event 卡片点击事件,返回 event.detail.index
bind:sale_item_btn_tap Click event 按钮点击事件,返回 event.detail.index

其他说明

无