评分

1. 组件概述

评分是一个数据输入组件，用于收集用户的评价或打分。它以星星（或自定义图标）的形式展示，用户通过点击来选择分数。评分组件支持半星选择、自定义颜色、描述文字等功能，适用于需要用户给出量化评价的场景，如满意度调查、内容评价、难度评估等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 答疑满意度评价。在 AI 答疑助手应用中，当 AI 回答完用户问题后，展示评分组件让用户对回答质量打分。可以设置”描述”配置，为不同分数添加说明文字（如 1 分”不满意”、3 分”一般”、5 分”非常满意”），帮助用户理解各分数的含义。收集的评分数据可用于优化 AI 回答质量。

• 场景二：学习内容难度反馈。在学习辅导类应用中，学生完成一道题目或一个知识点学习后，使用评分组件让学生评价内容难度。开启”允许半星”可以获得更精细的反馈。工作流可以根据学生的难度评分，动态调整后续推送的学习内容难度。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	组件的变量名，用户选择的评分值会存储到该变量中。其他组件可以绑定此变量来显示评分值，调用工作流时此变量的值也会传递给工作流。
标题	评分组件左侧显示的标签文字，用于说明该评分项的用途，如”满意度”、“难度评价”。
最大值	评分的最大分数，即显示多少颗星星。默认为 5，可设置 1-10 之间的整数。例如设置为 10 可用于百分制评分场景。
可清除	开启后，用户可以再次点击已选中的星星来清除评分，将值重置为空。适用于允许用户取消评分的场景。
允许半星	开启后，用户可以选择半颗星，实现更精细的评分。例如最大值为 5 时，可以选择 0.5、1、1.5…4.5、5 等分数。适用于需要更细致评价的场景。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置评分标准说明等帮助信息。
控件提示	在评分控件旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
描述	为不同分数设置对应的描述文字。点击添加按钮可以添加多条描述，每条包含一个分数值（Key）和对应的描述内容。例如设置 1 对应”很差”、3 对应”一般”、5 对应”很好”，当用户选择对应分数时会显示相应的描述文字。

事件折叠组

配置项	说明
添加事件	支持”值变化”事件，当用户选择或更改评分时触发。可以配合”调用工作流”动作，将用户的评分实时传递给后端进行处理，例如根据评分结果给出不同的反馈内容。

设计

表单项折叠组

该折叠组包含表单项的通用样式配置。

图标折叠组

配置项	说明
自定义	开启后可以自定义评分图标的字符。默认使用星星图标，可以替换为其他字符，如心形、笑脸等，让评分组件更符合应用场景的视觉风格。
未选中色值	未被选中的星星的颜色。默认为浅灰色（#e7e7e8），可以根据页面整体配色进行调整。
选中色值	为不同分数段设置不同的选中颜色。点击添加按钮可以添加多条配置，每条包含一个分数值（Key）和对应的颜色。例如设置 2 分及以下为灰色、3 分为深灰色、5 分为金黄色，可以通过颜色直观地区分评分高低。默认配置为：2 分灰色、3 分深灰色、5 分金黄色。

描述折叠组

配置项	说明
位置	描述文字相对于评分图标的显示位置，可选”左侧”或”右侧”。默认显示在右侧。

高级

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见。
隐藏	控制组件是否隐藏。与”可见”相反。
禁用	控制组件是否禁用。禁用后星星变灰且不可点击，但仍显示当前值。适用于查看历史评分等只读场景。
只读	开启后组件变为只读状态，用户无法修改评分值。与禁用类似，但视觉上不会变灰。适用于展示已有评分的场景。

校验折叠组

配置项	说明
必填	开启后，该评分项必须填写才能提交表单。适用于必须收集用户评价的场景。