# Rate 评分

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

# 平台差异说明

App（vue） App（nvue） H5 小程序
√ √ √ √

# 基本使用

  • 通过count参数设置总共有多少颗星星可选择
  • 通过v-model双向绑定初始化时默认选中的星星数量
<template>
	<zx-rate :count="count" v-model="value"></zx-rate>
</template>

<script>
	export default {
		data() {
			return {
				count: 4,
				value: 2
			}
		}
	}
</script>

# 自定义样式

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

# 自定义图标

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

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

<zx-rate activeIcon="heart-fill" inactiveIcon="heart"></zx-rate>

# 最少选中的数量

<zx-rate :minCount="5"></zx-rate>

# 禁用状态

禁用下，无法点击或者滑动选择，但是可以通过value设置默认选中的数量，禁用状态下用来展示分数，允许出现半星

<zx-rate :value="3.7" disabled></zx-rate>

# 只读状态

只读下，无法点击或者滑动选择，但是可以通过value设置默认选中的数量，禁用状态下用来展示分数，允许出现半星

<zx-rate :value="3.7" readonly></zx-rate>

# API

# Props

参数 说明 类型 默认值 可选值
value 双向绑定选择星星的数量 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的内置图标 String star-fill -
inactiveIcon 未选中时的图标名，只能为uView的内置图标 String star -
touchable 是否可以通过滑动手势选择评分 Boolean true false

# Events

事件名 说明 回调参数
change 选中的星星发生变化时触发 value：当前选中的星星的数量，如果使用v-model双向绑定方式，无需监听此事件