Rate 评分

介绍

用于对事物进行评级操作。

引入

  1. import { createApp } from 'vue';
  2. import { Rate } from 'vant';
  3. const app = createApp();
  4. app.use(Rate);

代码演示

基础用法

  1. <van-rate v-model="value" />
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const value = ref(3);
  5. return { value };
  6. },
  7. };

自定义图标

  1. <van-rate v-model="value" icon="like" void-icon="like-o" />

自定义样式

  1. <van-rate
  2. v-model="value"
  3. :size="25"
  4. color="#ffd21e"
  5. void-icon="star"
  6. void-color="#eee"
  7. />

半星

  1. <van-rate v-model="value" allow-half void-icon="star" void-color="#eee" />
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const value = ref(2.5);
  5. return { value };
  6. },
  7. };

自定义数量

  1. <van-rate v-model="value" :count="6" />

禁用状态

  1. <van-rate v-model="value" disabled />

只读状态

  1. <van-rate v-model="value" readonly />

监听 change 事件

  1. <van-rate v-model="value" @change="onChange" />
  1. import { ref } from 'vue';
  2. import { Toast } from 'vant';
  3. export default {
  4. setup() {
  5. const value = ref(3);
  6. const onChange = (value) => {
  7. Toast('当前值:' + value);
  8. };
  9. return {
  10. value,
  11. onChange,
  12. };
  13. },
  14. };

API

Props

参数说明类型默认值
v-model当前分值number-
count图标总数number | string5
size图标大小,默认单位为pxnumber | string20px
gutter图标间距,默认单位为pxnumber | string4px
color选中时的颜色string#ee0a24
void-color未选中时的颜色string#c8c9cc
disabled-color禁用时的颜色string#c8c9cc
icon选中时的图标名称或图片链接stringstar
void-icon未选中时的图标名称或图片链接stringstar-o
icon-prefix v2.5.3图标类名前缀,同 Icon 组件的 class-prefix 属性stringvan-icon
allow-half是否允许半选booleanfalse
readonly是否为只读状态 booleanfalse
disabled是否禁用评分booleanfalse
touchable是否可以通过滑动手势选择评分booleantrue

Events

事件名说明回调参数
change当前分值变化时触发的事件当前分值

样式变量

组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制

名称默认值描述
@rate-icon-size20px-
@rate-icon-gutter@padding-base-
@rate-icon-void-color@gray-5-
@rate-icon-full-color@red-
@rate-icon-disabled-color@gray-5-

Rate 评分 - 图1