Skip to content

mms-rate 评分

简述

星级/档位评分展示与点击选择,用于订单评价、内容打分等场景。文案与符号均为自研实现。

注意

注意: 请以 uni_modules/mms-unix 与本文为准;各端差异以 uni-app 与各平台官方文档为准。涉及隐私能力(相册、定位、剪贴板、手机号等)需在 manifest 与后台完成配置。

平台差异说明

App(vue)App(nvue)H5小程序

基本使用

  • 路径:pages_demo/ext/rate/rate(分包 pages_demo

双向绑定

写法说明
v-model:current推荐。当前选中档位数(0~quantity,0 表示未选)
:current + @change手动同步;change 载荷见下表

Props

属性类型默认值说明
quantityNumber5档位数(星数)
currentNumber0当前档位;超出范围在展示时按内部计算钳制
scoreNumber / String1预留,当前实现以 current 为准
disabledBooleanfalse禁用点击
sizeNumber20符号大小,单位 px
normalString#b2b2b2未选中颜色
activeString#EB0909已选中颜色
hollowBooleanfalse为 true 时未选档为「☆」,已选为「★」
paramsNumber / String0业务标识;change 中回传(数值可解析时按数字回传)

Events

事件载荷说明
update:currentnumberv-model:current 同步,值为新档位
change{ index, params }index 为点击档位(1 起计);params 为传入标识经解析后的数值

示例

html
<mms-rate v-model:current="score" :quantity="5" :disabled="false" />
html
<mms-rate
  v-model:current="score"
  :quantity="5"
  :params="1"
  @change="onRateChange"
/>

注意事项

  • 不提供半星、滑动选分;需要时在业务层扩展或使用其它交互。
  • params 为非数字字符串时,回传的 params 可能为 0,多实例区分建议用数字标识。

Released under the MIT License.