rate-button
更新时间 2024-07-24 02:58:49
收藏
我的收藏基础库从 2.68.0.0 开始支持本组件。
前端模板提供了一个入口组件
rate-button
,该组件是小程序基础库内置组件,通过这个组件实现从小程序跳转到评价模板页面,可直接使用。组件说明
- •团购订单不支持查看评价,已评价商品第二次进入后,按钮会显示暂不支持评价。
- •订单需核销后才能进行评价,且核销 60 天后不可评价。
- •目前仅支持查看自己对某个订单的评价。
使用指南
团购订单使用该组件时无需修改,可跳过“使用指南”这个步骤
修改小程序全局配置文件 package.json 和 app.json。
package.json
json复制{
"ttPlugins": {
"dependencies": {
// 配置插件名,版本等信息
"microapp-trade-plugin": {
"version": "1.2.8",
"isDynamic": true
}
}
}
}
app.json
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 | 无 | 否 | 按钮得到初始化状态时触发 | 2.68.0.0 |
bind:success | EventHandle | 无 | 否 | 从评价填写页面返回订单详情页时已评价时触发 | 2.68.0.0 |
bind:error | EventHandle | 无 | 否 | 组件内部失败回调 | 2.68.0.0 |
bind:init 说明
JavaScript复制// bind:init 使用示例
handleInit(event) {
const { status } = event.detail;
}
事件对象的 detail 为
object
类型,属性如下:属性名 | 类型 | 说明 | 最低支持版本 |
status | number | 按钮初始化时的状态回调
| 2.68.0.0 |
bind:success 说明
JavaScript复制// bind:success 使用示例
handleSuccess(event) {
const { result } = event.detail;
// 团购订单不支持查看评价,此时可决定按钮是否展示
}
事件对象的 detail 为
object
类型,属性如下:属性名 | 类型 | 说明 | 最低支持版本 |
result | boolean | 用户成功评价回调
| 2.68.0.0 |
bind:error 说明
- •当错误发生时触发。
- •错误原因可能是因为必填参数不合法,服务端请求错误等。
JavaScript复制// 错误信息含义见下文 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 | 无法跳转到正确的页面 |
效果示例
去评价
操作效果:点击后跳转填写评价页面。
查看评价
操作效果:点击后跳转查看评价页面。
不支持评价/无法查看评价
代码示例
HTML复制<rate-button
order-id="xxx"
bind:init="handleInit"
bind:success="handleSuccess"
/>
点击纠错