rate-button

我的收藏

基础库从 2.68.0.0 开始支持本组件。

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

组件说明

•

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

•

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

•

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

使用指南

团购订单使用该组件时无需修改，可跳过“使用指南”这个步骤

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

package.json

{ 
  "ttPlugins": {
    "dependencies": {
      // 配置插件名，版本等信息
      "microapp-trade-plugin": {
        "version": "1.2.8",
        "isDynamic": true
      }
    }
  }
}

app.json

{ 
  "pages": [
    "pages/index/index",
    // 评价填写页
    "ext://microapp-trade-plugin/rate-submit",
    // 评价查看页
    "ext://microapp-trade-plugin/rate-detail"
  ]
}

属性说明

属性名	类型	默认值	必填	说明	最低支持版本
order-id	string	无	是	开发者订单id	2.68.0.0
bind:init	EventHandle	无	否	按钮得到初始化状态时触发详见 bind:init 说明	2.68.0.0
bind:success	EventHandle	无	否	从评价填写页面返回订单详情页时已评价时触发详见 bind:success 说明	2.68.0.0
bind:error	EventHandle	无	否	组件内部失败回调详见 bind:error 说明	2.68.0.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	无法跳转到正确的页面

效果示例

去评价

操作效果：点击后跳转填写评价页面。

查看评价

操作效果：点击后跳转查看评价页面。

不支持评价/无法查看评价

代码示例

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

rate-button

​组件说明​

​使用指南​

​package.json​

​app.json​

​属性说明​

​bind:init 说明​

​bind:success 说明​

​bind:error 说明​

​bind:error 错误码​

​效果示例​

​去评价​

​查看评价​

​不支持评价/无法查看评价​

​代码示例​