Rate 评分

该组件一般用于满意度调查,星型评分的场景。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过count参数设置总共有多少颗星星可选择
  • 通过current设置初始化时默认选中的星星数量
  1. <template>
  2. <u-rate count="count" current="2"></u-rate>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. count: 4
  9. }
  10. }
  11. }
  12. </script>

自定义样式

  • 通过active-color设置选中的星星的颜色
  • 通过inactive-color设置未选中时星星的颜色
  • 通过gutter设置星星的间距,左右内边距各占gutter的一半
  1. <u-rate active-color="#FA3534" inactive-color="#b2b2b2" gutter="20"></u-rate>

自定义图标

  • 通过active-icon设置激活的图标
  • 通过inactive-icon设置未激活的图标

这里的使用的图标,只能是uView自带的图标名称,详见Icon 图标

下方示例为使用心形图标替代默认的星星图标:

  1. <u-rate active-icon="heart-fill" inactive-icon="heart"></u-rate>

最少选中的数量

  1. <u-rate min-count="5"></u-rate>

禁用状态

禁用下,无法点击或者滑动选择,但是可以通过current设置默认选中的数量

  1. <u-rate :disabled="true"></u-rate>

API

Props

参数说明类型默认值可选值
count最多可选的星星数量String | Number5-
current默认选中的星星数量String | Number0-
disabled是否禁止用户操作Booleanfalsetrue
size星星的大小,单位rpxString | Number32-
inactive-color未选中星星的颜色String#b2b2b2-
active-color选中的星星颜色String#FA3534-
gutter星星之间的距离String | Number10-
min-count最少选中星星的个数String | Number0-
active-icon选中时的图标名,只能为uView的内置图标Stringstar-fill-
inactive-color未选中时的图标名,只能为uView的内置图标Stringstar-

Events

事件名说明回调参数版本
change选中的星星发生变化时触发value:当前选中的星星的数量-