# Rate 评分
该组件一般用于满意度调查,星型评分的场景。
# 平台差异说明
App(vue) | App(nvue) | H5 | 小程序 |
---|---|---|---|
√ | √ | √ | √ |
# 基本使用
- 通过
count
参数设置总共有多少颗星星可选择 - 通过
v-model
双向绑定初始化时默认选中的星星数量
<template>
<up-rate :count="count" v-model="value"></up-rate>
</template>
<script setup>
import { ref } from 'vue';
const count = ref(4);
const value = ref(2);
</script>
# 自定义样式
- 通过
active-color
设置选中的星星的颜色 - 通过
inactive-color
设置未选中时星星的颜色 - 通过
gutter
设置星星的间距,左右内边距各占gutter
的一半
<up-rate active-color="#FA3534" inactive-color="#b2b2b2" gutter="20"></up-rate>
# 自定义图标
- 通过
active-icon
设置激活的图标 - 通过
inactive-icon
设置未激活的图标
下方示例为使用心形图标替代默认的星星图标:
<up-rate activeIcon="heart-fill" inactiveIcon="heart"></up-rate>
# 最少选中的数量
<up-rate :minCount="5"></up-rate>
# 禁用状态
禁用下,无法点击或者滑动选择,但是可以通过value
设置默认选中的数量,禁用状态下用来展示分数,允许出现半星
<up-rate :value="3.7" disabled></up-rate>
# 只读状态
只读下,无法点击或者滑动选择,但是可以通过value
设置默认选中的数量,禁用状态下用来展示分数,允许出现半星
<up-rate :value="3.7" readonly></up-rate>
# 右侧演示页面源代码地址
# API
# Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
modelValue | 双向绑定选择星星的数量 | String | Number | 1 | - |
count | 最多可选的星星数量 | String | Number | 5 | - |
disabled | 是否禁止用户操作 | Boolean | false | true |
readonly 2.0.30 | 是否只读 | Boolean | false | true |
size | 星星的大小,单位rpx | String | Number | 18 | - |
inactiveColor | 未选中星星的颜色 | String | #b2b2b2 | - |
activeColor | 选中的星星颜色 | String | #FA3534 | - |
gutter | 星星之间的距离 | String | Number | 4 | - |
minCount | 最少选中星星的个数 | String | Number | 1 | - |
allowHalf | 是否允许半星选择 | Boolean | false | true |
activeIcon | 选中时的图标名,只能为uview-plus的内置图标 | String | star-fill | - |
inactiveIcon | 未选中时的图标名,只能为uview-plus的内置图标 | String | star | - |
touchable | 是否可以通过滑动手势选择评分 | Boolean | true | false |
# Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 选中的星星发生变化时触发 | value:当前选中的星星的数量,如果使用v-model 双向绑定方式,无需监听此事件 |