Skip to content

评分组件

评分组件

评分组件用于对事物进行评级操作,支持自定义图标、颜色、半选等功能。

基础用法

基础的评分组件用法,通过 v-model 绑定评分值。

基础评分

当前值: 3

禁用状态

显示代码箭头
复制GitHub

不同尺寸

评分组件支持三种尺寸:small、default 和 large。

小尺寸

默认尺寸

大尺寸

显示代码箭头
复制GitHub

自定义图标

可以通过 icon 属性自定义评分组件的图标,包括未选中图标、半选图标和选中图标。

自定义图标示例1

自定义图标示例2

显示代码箭头
复制GitHub

自定义颜色

通过 color 属性可以自定义不同分值下的颜色。

默认颜色

自定义颜色

显示代码箭头
复制GitHub

最大评分值

通过 max 属性设置评分组件的最大分值,默认为 5。

默认最大值 (5)

自定义最大值 (3)

自定义最大值 (10)

显示代码箭头
复制GitHub

半选模式

评分组件默认支持半选模式,可以通过 is-half 属性控制是否启用半选。

支持半选(默认)

当前值: 2.5

禁用半选

当前值: 3
显示代码箭头
复制GitHub

自定义间距

通过 gap 属性可以设置评分图标之间的间距,默认为 5px。

小间距 (2px)

默认间距 (5px)

大间距 (15px)

显示代码箭头
复制GitHub

事件处理

评分组件提供了 change 事件,在评分值变化时触发。

事件记录:
显示代码箭头
复制GitHub

评分组件 API

属性

属性名说明类型可选值默认值
v-model绑定值number
size尺寸stringsmall / default / largedefault
color评分颜色配置{ [key in number]?: string }
icon自定义图标配置{ empty?: string, half?: string, show?: string }
gap图标间距number5
max最大评分值number5
is-half是否支持半选booleantrue
disabled是否禁用booleanfalse

事件

事件名说明回调参数
change评分值变化时触发(value: number)

样式变量

评分组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$theme-color-primary主题色-主要
$font-size-small字体大小-小
$font-size-default字体大小-默认
$font-size-large字体大小-大

基于MIT许可发布