Rate评分 - 图1

Rate 评分

评分组件。

何时使用

  • 对评价进行展示。
  • 对事物进行快速的评级操作。

代码演示

  • Rate评分 - 图2

    Rate评分 - 图3

  • Rate评分 - 图4

    Rate评分 - 图5

  • Rate评分 - 图6

    Rate评分 - 图7

  • Rate评分 - 图8

    Rate评分 - 图9

  • Rate评分 - 图10

    Rate评分 - 图11

基本用法

最简单的用法。

  1. <template>
  2. <a-rate v-model:value="value" />
  3. </template>
  4. <script lang="ts">
  5. import { defineComponent, ref } from 'vue';
  6. export default defineComponent({
  7. setup() {
  8. const value = ref<number>(2);
  9. return {
  10. value,
  11. };
  12. },
  13. });
  14. </script>
  • Rate评分 - 图12

    Rate评分 - 图13

  • Rate评分 - 图14

    Rate评分 - 图15

  • Rate评分 - 图16

    Rate评分 - 图17

  • Rate评分 - 图18

    Rate评分 - 图19

  • Rate评分 - 图20

    Rate评分 - 图21

normal

文案展现

给评分组件加上文案展示。

  1. <template>
  2. <span>
  3. <a-rate v-model:value="value" :tooltips="desc" />
  4. <span class="ant-rate-text">{{ desc[value - 1] }}</span>
  5. </span>
  6. </template>
  7. <script lang="ts">
  8. import { defineComponent, ref } from 'vue';
  9. export default defineComponent({
  10. setup() {
  11. const value = ref<number>(3);
  12. const desc = ref<string[]>(['terrible', 'bad', 'normal', 'good', 'wonderful']);
  13. return {
  14. value,
  15. desc,
  16. };
  17. },
  18. });
  19. </script>

Rate评分 - 图22

清除

支持允许或者禁用清除。

  1. <template>
  2. <div>
  3. <a-rate v-model:value="value1" />
  4. <span class="ant-rate-text">allowClear: true</span>
  5. <br />
  6. <a-rate :allow-clear="false" v-model:value="value2" />
  7. <span class="ant-rate-text">allowClear: false</span>
  8. </div>
  9. </template>
  10. <script lang="ts">
  11. import { defineComponent, ref } from 'vue';
  12. export default defineComponent({
  13. setup() {
  14. const value1 = ref<number>(3);
  15. const value2 = ref<number>(3);
  16. return {
  17. value1,
  18. value2,
  19. };
  20. },
  21. });
  22. </script>
  • Rate评分 - 图23

    Rate评分 - 图24

  • Rate评分 - 图25

    Rate评分 - 图26

  • Rate评分 - 图27

    Rate评分 - 图28

  • Rate评分 - 图29

    Rate评分 - 图30

  • Rate评分 - 图31

    Rate评分 - 图32

半星

支持选中半星。

  1. <template>
  2. <a-rate v-model:value="value" allow-half />
  3. </template>
  4. <script lang="ts">
  5. import { defineComponent, ref } from 'vue';
  6. export default defineComponent({
  7. setup() {
  8. const value = ref<number>(2.5);
  9. return {
  10. value,
  11. };
  12. },
  13. });
  14. </script>
  • Rate评分 - 图33

    Rate评分 - 图34

  • Rate评分 - 图35

    Rate评分 - 图36

  • Rate评分 - 图37

    Rate评分 - 图38

  • Rate评分 - 图39

    Rate评分 - 图40

  • Rate评分 - 图41

    Rate评分 - 图42

只读

只读,无法进行鼠标交互。

  1. <template>
  2. <a-rate :value="2" disabled />
  3. </template>
  4. <script lang="ts">
  5. import { defineComponent } from 'vue';
  6. export default defineComponent({});
  7. </script>

Rate评分 - 图43

其他字符

可以将星星替换为其他字符,比如字母,数字,字体图标甚至中文。

  1. <template>
  2. <div>
  3. <a-rate v-model:value="value1" allowHalf>
  4. <template #character>
  5. <heart-outlined />
  6. </template>
  7. </a-rate>
  8. <br />
  9. <a-rate v-model:value="value2" character="A" allow-half style="font-size: 36px" />
  10. <br />
  11. <a-rate v-model:value="value3" character="好" allow-half />
  12. <br />
  13. </div>
  14. </template>
  15. <script lang="ts">
  16. import { HeartOutlined } from '@ant-design/icons-vue';
  17. import { defineComponent, ref } from 'vue';
  18. export default defineComponent({
  19. setup() {
  20. const value1 = ref<number>(2);
  21. const value2 = ref<number>(2.5);
  22. const value3 = ref<number>(0.5);
  23. return {
  24. value1,
  25. value2,
  26. value3,
  27. };
  28. },
  29. components: {
  30. HeartOutlined,
  31. },
  32. });
  33. </script>

API

属性说明类型默认值
allowClear是否允许再次点击后清除booleantrue
allowHalf是否允许半选booleanfalse
autofocus自动获取焦点booleanfalse
character自定义字符String or slot=”character”<StarOutlined />
countstar 总数number5
disabled只读,无法进行交互booleanfalse
tooltips自定义每项的提示信息string[]-
value(v-model)当前数,受控值number-

事件

事件名称说明回调参数
blur失去焦点时的回调Function()
change选择时的回调Function(value: number)
focus获取焦点时的回调Function()
hoverChange鼠标经过时数值变化的回调Function(value: number)
keydown按键回调Function(event)

方法

名称描述
blur()移除焦点
focus()获取焦点