在 SAP UI5 的控件体系里,sap.m.ProgressIndicator 是一个用来可视化进度与完成度的经典控件。它通过一条横向色条与数值文本,传达对象当前状态或目标完成比例。相对于 sap.m.BusyIndicator 这种强调临时占位与不确定等待时间的控件,sap.m.ProgressIndicator 更适合表达一个静态或缓慢变化的可量化状态,例如订单履约率、项目完成度、库存达成率等。
sap.m.ProgressIndicator 的视觉本质是一条逐步填充的进度条与一段可选的文本。核心属性如下,括号中给出默认值与要点,便于查阅:
-
percentValue:进度百分比,数值型,范围通常为 0 到 100(默认 0)。决定色条填充长度。
-
displayValue:条内或条旁显示的文本。如果不给,控件会用 percentValue 的百分比文本作为默认展示,比如 42%。这让你轻松切换为 8 / 10 这种绝对值表达。
-
showValue:是否显示 displayValue(默认 true)。
-
state:语义状态,枚举 sap.ui.core.ValueState,可取 None、Success、Warning、Error。不同取值对应不同语义颜色,None 通常为蓝色。用语义色可快速传达好坏。
-
width:控件宽度,CSS 尺寸(默认 100%),常按容器自适应。
-
height:控件高度,CSS 尺寸。文档建议常用高度约 2.5rem,而用于较紧凑头部区域可用更矮的高度。
-
e