qrcode
扫描二维码查看 H5 演示效果
qrcode
扫描二维码查看演示效果
taro-ui, 非 taro-ui-vue3
wxapp

Rate 评分组件


评分组件,可自定义评分图标的大小、间隔、评分数、图标类型、图标颜色

使用指南

在 Taro 文件中引入组件

import { AtRate } from 'taro-ui-vue3'

组件依赖的样式文件(仅按需引用时需要)

@import "taro-ui-vue3/dist/style/components/rate.scss";

一般用法

说明:

  • 该组件为受控组件,开发者可通过 onChange 事件或 v-model:value 来更新 value 值变化。不使用 v-model 时,valueonChange 函数必填

  • 由于小程序组件化的限制,AtRate 嵌套在 AtForm 或原生小程序组件 Form 中的时候,onSubmit 事件获得的 event 中的 event.detail.value 始终为空对象,开发者要获取数据,可以自行在页面的 state 中获取

更新 value 的值

<!-- 使用 onChange 事件 -->
<at-rate :value="rateValue" @change="(e) => rateValue = e"/>

<!-- 使用 v-model:value -->
<at-rate v-model:value="rateValue" />

自定义图标大小

<example-item>
  <at-rate :size="15" />
</example-item>

自定义评分数

<example-item>
  <at-rate :max="10" />
</example-item>

自定义图标间隔

<example-item>  
  <at-rate :margin="10" />
</example-item>

只读

<example-item>
  <view>评分: 3.5</view>
  <at-rate :value="3.5" />
</example-item>

自定义图标颜色

<example-item>
  <at-rate color="teal" />
</example-item>

自定义图标类型

支持 AtIcon 中的 star-2heart-2 图标,对应的图标类型为 at-icon-star-2at-icon-heart-2

因此,icon 属性只能传入 'star' | 'heart'

<example-item>
  <!-- 图标类型默认为 star -->
  <at-rate />
  <at-rate icon="heart" />
</example-item>

参数

参数说明类型可选值默认值
value当前评分,开发者可通过 onChange 事件或 v-model:value 来更新 value 值,必填Number-0
max最大评分Number | String-5
size评分图标大小Number | String-20
margin图标间隔,单位根据环境自动转为 rpxremNumber | String-5
color图标颜色,css 支持的颜色值String-#FFCA3E
icon图标类型String'star' | 'heart''star'

事件

事件名称说明返回参数
onChange输入框值改变时触发的事件,开发者可通过 onChange 事件来更新 value 值变化,但不填写 onChange 函数时,该组件只读当前值 value
onUpdate:value使用 v-model:value 时自动触发当前值 value