评分条使用指导

评分条使用指导

一排星星，用户点击或拖动打分（商品评价、服务满意度、问卷），也可以设为只读显示平均分（支持半星，比如 4.5 分）。用户打完分后触发评分改变（评分）（RatingChanged）；在代码里设置评分不会触发。

快速上手：提交评价

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

when 评分条1.RatingChanged(评分) {
  标签1.Text = join("你打了 ", 评分, " 分")
}

when 按钮_提交.Click() {
  if 评分条1.Rating == 0 {
    对话框1.ShowAlert("请先打分")
  } else {
    Web客户端1.PostText(join("score=", 评分条1.Rating))
  }
}

显示平均分：只读勾选为真、步长设为 0.5，再把算好的平均分赋给评分，例如 评分条1.Rating = 4.5。

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

案例：展示只读评分

放评分条、编辑和锁定按钮及标签。先设半星步长，再设置初始评分。

when Screen1.Initialize() {
  评分条1.StepSize = 0.5
  评分条1.Rating = 3.5
  评分条1.ReadOnly = true
}
when 按钮_编辑.Click() {
  评分条1.ReadOnly = false
}
when 按钮_锁定.Click() {
  评分条1.ReadOnly = true
}
when 评分条1.RatingChanged(评分) {
  标签1.Text = join("评分：", 评分)
}

评分范围受星星数量限制；ReadOnly 用于展示平均分，关闭后才允许用户拖动评分。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

入口	用途
未点亮颜色（`EmptyColor`）	未点亮星星的颜色，默认浅灰。
星星个数（`NumStars`）	星星个数（1 到 10），默认 5。
评分（`Rating`）	当前评分，0 到星星个数之间，按「步长」取整。
只读（`ReadOnly`）	只读：只显示评分（如商品平均分），用户不能改。
星星颜色（`StarColor`）	已点亮星星的颜色，默认琥珀色。
星星大小（`StarSize`）	每颗星星的大小（像素），默认 28。
步长（`StepSize`）	评分步长：1 为整颗星（默认），0.5 可打半星。
评分改变（评分）（`RatingChanged`）	用户点击或拖动改分后触发（手指抬起时），rating 是新的评分。代码里设置评分不触发。

常见问题与验收

检查项	操作与预期
初始化	对照案例检查是否已经调用加载、注册、连接或显示方法；仅拖入组件不会替你执行这些步骤。
结果返回	将成功事件和失败事件都接到标签，记录事件参数；异步操作完成前不读取结果属性。
输入配置	检查素材名大小写、网址是否为直接资源地址、文件是否存在、编号和索引是否在范围内。
平台与权限	按组件参考中的平台说明测试；授权被拒绝时应有明确提示，不继续假定操作成功。
最小案例	先验证页面中的最小案例，再验证第二个场景；重复操作、取消、返回屏幕后结果应符合事件说明。

完整 .aia 源码与操作指导

下载 .aia 源码

导入 RatingBarAllFeatures.aia。屏幕顶部显示评分条，下方滚动区域提供全部操作。初始化为 6 颗星、2.5 分、半分步长、非只读。

属性 / 事件	操作入口	预期结果
评分（Rating）读取／设置	点击星星，或拖动评分滑动条	显示当前评分；超过星数时由组件限制范围
星星个数（NumStars）读取／设置	切换星数	5 与 6 星切换，评分滑动条上限同步
步长（StepSize）读取／设置	切换步长	整分与半分评分切换
只读（ReadOnly）读取／设置	勾选只读，再点击星星／拖动滑动条	手指不能修改只读评分；程序赋值仍可改变
星星大小（StarSize）读取／设置	切换大小	30 与 38 切换
点亮颜色／未点亮颜色（StarColor / EmptyColor）读取／设置	切换颜色	蓝色／浅蓝与橙色／浅橙切换
评分改变（RatingChanged）	实际改变评分	事件区显示事件评分值、当前属性与计数
恢复所有设置	先改变星数、步长、颜色及可见性，再恢复	回到 6 星、2.5 分、半分、蓝色、非只读、固定尺寸；滑动条上限回到 6

公共属性 / 功能	操作入口	预期结果
可见（Visible）读取／设置	隐藏／恢复	控件隐藏后按钮仍能恢复；属性区同步显示
宽度／高度（Width / Height）读取／设置	固定尺寸	恢复固定宽高，读取实际尺寸
宽度百分比／高度百分比（WidthPercent / HeightPercent）	百分比尺寸	使用百分比尺寸，可回到固定尺寸
左侧／顶部位置（Left / Top）读取／设置	位置属性	切换并读取属性；普通排列仍按容器布局定位，此项不提供自由拖动
所有设计器配置	导入查看设计器	配置已保存在归档中；初始化会与操作界面同步
错误反馈	屏幕“发生错误时”	显示操作、错误码和原因

覆盖检查 37/37。归档、正式编辑器首次导入／保存重开（0 错误）、变量下拉绑定、真实后台导入、安装包编译通过；本轮没有真机／伴侣实测。

评分条

评分条使用指导

评分条使用指导

快速上手：提交评价

搭建与测试

案例：展示只读评分

属性、方法与事件速查

常见问题与验收

完整 .aia 源码与操作指导

评分条

您的改进建议

联系方式：

意见反馈（300字以内）：

App Inventor 2 中文网