组件概述

基础内容

视图容器

表单

导航

媒体

画布

地图

开放能力

行业开放

交易系统

评价

rate-button

电商（即将废弃）

原生组件

拓展组件

rate-button

我的收藏

基础库从 2.68.0.0 开始支持本组件的交易类小程序评价，从3.63.0.0开始支持本组件的非交易类小程序评价。

前端模板提供了一个入口组件rate-button，该组件是小程序基础库内置组件，通过这个组件实现从小程序跳转到评价模板页面，可直接使用。

属性说明

评价组件可针对接入交易系统小程序（以下简称交易类小程序）的订单和未接入交易系统的小程序本身进行评价，交易类小程序的评价能力可前往交易产品评价能力查看详细信息。评价限制如下：

•

针对交易类小程序：

◦

团购订单不支持查看评价，已评价商品第二次进入后，按钮会显示暂不支持评价。

◦

订单需核销后才能进行评价，且核销 60 天后不可评价。

◦

目前仅支持查看自己对某个订单的评价。

•

针对非交易类小程序：

◦

当该用户近7天使用过该小程序至少1次，且单次停留时长大于3秒可评价。

使用指南

•团购订单使用该组件时无需修改，可跳过“使用指南”这个步骤
•即使不使用rate-button组件，只使用小程序“关于”页面的评价入口，也需要修改该配置

修改小程序全局配置文件 package.json。

package.json

{
  "industrySDK":true
}

属性说明

属性名	类型	默认值	必填	说明	最低支持版本
order-id	string	无	否	开发者订单id，交易类小程序必填	2.68.0
rate-type	string	'transaction'	否	评价类型 1.交易类小程序：'transaction' 2.非交易类小程序：'normal'	3.63.0
normal-rate-text	string	无	否	非交易类小程序的评价按钮文案	3.63.0
bind:init	EventHandle	无	否	按钮得到初始化时触发	2.68.0
bind:success	EventHandle	无	否	从评价填写页面返回订单详情页时已评价时触发	2.68.0
bind:error	EventHandle	无	否	组件内部失败回调	2.68.0

bind:init 说明

// bind:init 使用示例 
handleInit(event) {
    const { status } = event.detail;
}

事件对象的 detail 为 object 类型，属性如下：

属性名	类型	说明	最低支持版本
status	number	按钮初始化时的状态回调 •1 表示用户未评价 •2 表示用户已评价 •3 表示用户不能进行评价 •4 表示订单超时无法评价（泛知识订单才有该状态）	2.68.0.0

bind:success 说明

// bind:success 使用示例 
handleSuccess(event) {
    const { result } = event.detail;
    // 团购订单不支持查看评价，此时可决定按钮是否展示
    // 
}

事件对象的 detail 为 object 类型，属性如下：

属性名	类型	说明	最低支持版本
result	boolean	用户成功评价回调 •true 表示用户写完评价回到订单详细页，已评价	2.68.0.0

bind:error 说明

•

当错误发生时触发。

•

错误原因可能是因为必填参数不合法，服务端请求错误等。

// 错误信息含义见下文 bind:error报错信息 
handleError(event) {
    const { errMsg ，errNo} = event.detail;
    // errNo（错误码，对应某种具体报错原因）
    // errMsg（报错信息）
}

•

事件对象的detail 为 object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	组件内部错误信息，如传入属性类型错误等	2.68.0.0

bind:error 错误码

errNo（错误码）	含义
21522	order-id 非法
30001	订单不可评价
30002	超出评价时间
30003	获取评价选项失败，服务端参数校验不通过
30004	获取评价选项失败，服务端内部错误
30005	评价提交失败，服务端参数校验不通过
30006	评价提交失败，服务端内部错误
30007	获取评价详情失败，服务端参数校验不通过
30008	获取评价详情失败，服务端内部错误
30009	获取评价路由失败，服务端参数校验不通过
30010	获取评价路由失败，服务端内部错误
30011	获取评价状态失败，服务端参数校验不通过
30012	获取评价状态失败，服务端内部错误
30013	获取评价跳转 schema 失败，服务端参数校验不通过
30014	获取评价跳转 schema 失败，服务端内部错误
30015	无法跳转至评价插件页面
30016	无法跳转到正确的页面
30017	检查小程序是否能够评价失败，服务端内部错误
30018	非交易类小程序未达到使用时长限制
30019	交易类小程序不支持针对小程序自身进行评价

效果示例

交易类

去评价	查看评价	不支持评价/无法查看评价
操作效果：点击后跳转填写评价页面。	操作效果：点击后跳转查看评价页面。

非交易类

去评价	查看评价
	操作效果：进入评价详情页。

代码示例

交易类

<rate-button order-id="xxx" bind:init="handleInit" bind:success="handleSuccess"/>

非交易类

<rate-button rate-type="normal" rate-type-text="去评价" bind:init="handleInit" bind:success="handleSuccess"/>