组件/表单组件

ERate 评分

import EUI 1.0

示例与代码

评分

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(640, parent.width) spacing: 16 ERate { value: 3 showText: true allowHalf: true texts: [qsTr("较差"), qsTr("一般"), qsTr("不错"), qsTr("很好"), qsTr("出色")] colors: ["#909399", "#E6A23C", "#E6A23C", "#e6a23c", "#e6a23c"] } ERate { value: 4.5 readOnly: true showScore: true scoreTemplate: "{value}/5" } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

半星评分

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ERate { value: 3.5 allowHalf: true clearable: true }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

activeColorcolor

激活或选中状态的颜色。

默认值动态绑定

allowHalfbool

允许半星评分。

默认值false

clearablebool

显示清除操作；评分中允许再次点击当前分数清零。

默认值false

colorsvar

按评分区间组织的图标、颜色或提示文字数组/映射。

默认值[]

disabledVoidColorcolor

未选中评分图标的颜色；disabledVoidColor 用于禁用状态。

默认值voidColor

disabledVoidIconint

组件使用的图标。

EIcons.*
0（无图标）

默认值voidIcon

enabledbool

是否允许交互；false 时控件禁用。

默认值true

halfIconint

组件使用的图标。

EIcons.*
0（无图标）

默认值EIcons.STAR_FILL

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

highThresholdreal

低分和高分区间的分界值。

默认值4

hoverValuereal

当前悬停日期或评分，用于预览。

默认值-1

iconsvar

按评分区间组织的图标、颜色或提示文字数组/映射。

默认值[]

lowThresholdreal

低分和高分区间的分界值。

默认值2

maxint

可评最大分值和星形图标数量。

默认值5

readOnlybool

禁止用户编辑或评分，仍可通过属性设置值。

默认值false

scoreTemplatestring

评分显示模板，{value} 替换为当前分数。

默认值"{value}"

showScorebool

显示评分文字或分数。

默认值false

showTextbool

显示进度或评分文字。

默认值false

sizeint

控件尺寸；默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

textColorcolor

文字颜色。

默认值动态绑定

textsvar

按评分区间组织的图标、颜色或提示文字数组/映射。

默认值[]

validateEventbool

值变化时是否向所属表单派发校验请求。

默认值true

valuereal

当前值；通过属性绑定读写，数组形式用于多选或范围选择。

默认值0

visiblebool

是否显示组件。

默认值true

voidColorcolor

未选中评分图标的颜色；disabledVoidColor 用于禁用状态。

默认值动态绑定

voidIconint

组件使用的图标。

EIcons.*
0（无图标）

默认值EIcons.STAR

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

currentColorcolor只读

根据主题、当前状态及自定义配色确定的实际颜色。

默认值由运行时计算

currentIconint只读

当前评分区间对应的图标。

EIcons.*
0：不指定图标

默认值由运行时计算

currentScorereal只读

包含鼠标预览的当前评分。

默认值由运行时计算

信号

签名作用

rated(real value)

用户完成评分时触发，value 为选中的分数。

方法

签名作用

resetCurrentValue()

结束评分预览，恢复到已选评分。

setCurrentValue(nextValue)

设置当前悬停预览的评分值。

setRating(nextValue)

设置评分值，并应用评分组件的范围与精度限制。