基础库 3.5.5 开始支持，低版本需做兼容处理。

微信鸿蒙 OS 版：支持

相关文档: 微信小店指引

渲染框架支持情况：Skyline （使用最新 Nightly 工具调试）、WebView

功能描述

小程序内嵌微信小店商品，展示小店商品，并进行跳转交易。支持小店优选联盟带货跟佣功能。

通用属性

属性

类型

默认值

必填

说明

最低版本

appid

string

是

小店appid。获取方式：小店后台 - 店铺管理 - 基础信息 - 账号信息 - 微信小店ID。

3.5.5

product-id

string

是

商品id。获取小店商品id，可以通过API获取(参考链接)或通过小店后台 - 商品管理 - 商品列表 - 规格/编码获取。

3.5.5

product-promotion-link

string

否

带货商品跟佣信息。若需要商品售卖时使用小店优选联盟带货跟佣功能，可以通过API获取带货商品跟佣信息(参考链接)。

3.5.5

media-id

string

否

媒体文件id。可以通过API获取(参考链接)。

3.7.1

custom-style

object

否

自定义样式。支持自定义的样式请查看custom-style。

3.7.1

custom-content

boolean

false

否

开启自定义插槽。开启后可自行控制卡片内容。

3.7.2

open-page

string

product-detail

否

设置点击打开的页面(同时开启 custom-content 属性后生效)。

3.7.4

合法值	说明	最低版本
product-detail	商品详情页	3.7.4
gift-product-detail	送礼商品详情页	3.7.7
buy	下单页，只能支持「热招品牌且关联小店」商家	3.7.4
gift	送礼下单页，只能支持「热招品牌且关联小店」商家	3.15.1

logo-position

string

bottom-left

否

设置小店标识的位置，不允许隐藏(同时开启 custom-content 属性后生效)。

3.7.2

合法值	说明
bottom-left	左下方
bottom-right	右下方

bind:entersuccess

eventhandle

否

跳转小店成功的回调。

3.7.1

bind:entererror

eventhandle

否

跳转小店失败的回调，event.detail={code,message}。

3.7.1

自定义样式(custom-style)

键名	说明	允许自定义的属性
card	卡片样式	background-color
title	标题样式	color
price	价格样式	color
buy-button	购买按钮样式	width、border-radius、color、background-color
buy-button-disabled	购买按钮禁用态样式	width、border-radius、color、background-color

自定义样式(custom-style)示例代码

<store-product appid="xxx" product-id="xxx" custom-style="{{customStyle}}" />

Page({
  data: {
    customStyle: {
      card: {
        'background-color': '#FAFAFA',
      },
      title: {
        color: 'rgba(0, 0, 0, 0.8)',
      },
      price: {
        color: '#FF6146'
      },
      'buy-button': {
        width: '100px',
        'border-radius': '30px',
        'background-color': 'rgba(0,0,0,0.9)',
        color: '#FFD48D',
      },
      'buy-button-disabled': {
        width: '100px',
        'border-radius': '30px',
        'background-color': 'rgba(0,0,0,0.9)',
        color: '#FFD48D',
      },
    },
  }
})

使用自定义插槽(custom-content)示例代码

<store-product appid="xxx" product-id="xxx" custom-content="{{true}}">
  <view>自定义卡片内容</view>
</store-product>

detail 对象

属性名	类型	说明
code	Number	状态码
message	String	错误信息

code 有效值

值	说明
-1	系统失败，请重试
0	成功
10001	无效的media-id
10002	无效的media-id
10003	文件正在上传中，请等待
10004	上传的文件存在风险，请重新上传
20001	该商品因违规已下架
60001	正在加载中
60002	正在渲染中
60004	加载异常
60005	加载失败

Bug & Tip

tip：请保持组件的小店标识内容完整展示。
tip：参数 product-promotion-link、media-id 请在组件首次加载时传入，暂不支持在组件加载完成后调整参数
tip：暂不支持在微信 Windows 版和微信 Mac 版的小程序上使用本组件。