Rate 评分

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

基础用法

通过 来绑定当前评分值。

<van-rate v-model="value" />

import { ref } from 'vue';
export default {
    const value = ref(3);
    return { value };
  },
};

自定义图标

通过 icon 属性设置选中时的图标，void-icon 属性设置未选中时的图标。

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

自定义样式

<van-rate
  v-model="value"
  :size="25"
  color="#ffd21e"
  void-icon="star"
  void-color="#eee"
/>

设置 allow-half 属性后可以选中半星。

import { ref } from 'vue';
  setup() {
    const value = ref(2.5);
    return { value };
  },
};

自定义数量

通过 count 属性设置评分总数。

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

禁用状态

通过 disabled 属性来禁用评分。

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

只读状态

只读状态显示小数

设置 readonly 和 allow-half 属性后，Rate 组件可以展示任意小数结果。

import { ref } from 'vue';
export default {
  setup() {
    const value = ref(3.3);
    return { value };
  },
};

评分变化时，会触发 change 事件。

<van-rate v-model="value" @change="onChange" />

import { ref } from 'vue';
import { showToast } from 'vant';
export default {
  setup() {
    const value = ref(3);
    const onChange = (value) => showToast('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};

Props

Events

类型定义

组件导出以下类型定义：

样式变量