“仪表”小组件
“仪表”小组件可显示指针仪表，用于将特定范围内的单个值进行可视化。可通过以下方法配置小组件：
• 定义仪表具有多少个部分或间隔。
• 控制值标签的可见性和格式。
• 设置孔径和参考角度值，以控制数据范围的显示方式。
• 显示描述数据的图例。
• 用于控制：刻度标记、指针、中心点和仪表边界的大小设定。
将数据绑定到“仪表”小组件
要在“仪表”小组件上显示数据，必须将数字属性绑定到其 Data 属性。
1. 在 Mashup Builder 中，将数字属性从服务绑定到小组件 Data 属性。
2. 在“属性”面板上，配置以下属性：
◦ 要设置仪表的范围，请使用 MinValue 和 MaxValue 属性。
◦ 要对小组件的值和标签进行格式设置，请使用 ValueDecimals 和 LabelDecimals 属性。
◦ 要设置值范围的孔径，请使用 Aperture 属性。默认情况下，孔径设置为 255。
3. 单击“保存”，然后单击“查看混搭”。
在运行时执行绑定的数据服务时，将显示仪表值。
在 ThingWorx 9.4 及更高版本中，可以将数据源绑定到 ValueDecimals 和 LabelDecimals 属性，以动态设置小数位数。不同类型的数据可能需要对值和标签小数设置特定格式。例如，当仪表显示来自多个源的数据时，可以将值格式与当前数据类型进行匹配。
配置仪表值标签
默认情况下，小组件使用仪表指针显示当前值。可以使用小组件 ValueDisplayMode 属性显示值。以下是可用的选项：
• “无”- 隐藏值标签（默认）。
• “内部”- 仪表内。
• “上”- 仪表上方。
• “下”- 仪表下方。
小组件属性
 | 下表不包括样式和常用的小组件属性。 |
属性名称 | 说明 | 基本类型 | 默认值 | 是否可绑定? (Y/N) | 是否可本地化? (Y/N) | ||
|---|---|---|---|---|---|---|---|
CustomClass | 用户定义的 CSS 类，应用于小组件顶层 div。可以输入多个类，以空格作为分隔符。 | STRING | 不可用 | Y | N | ||
Data | 小组件数据源。必须绑定单个数字值。
| NUMBER | 不可用 | Y | N | ||
MinValue | 仪表的最小值 | NUMBER | 0 | Y | N | ||
MaxValue | 仪表的最大值 | NUMBER | 100 | Y | N | ||
ValueFormatter | 仪表指针和值的显示的样式规则。 | STATEFORMATTING | 状态格式 | N | N | ||
FormatNeedle | 将状态格式应用到指针。 | BOOLEAN | True | N | N | ||
Intervals | 仪表间隔数 (影响刻度、标签和指示符环)。 | NUMBER | 10 | N | N | ||
IntervalsPerLabel | 每个标签的仪表间隔数 (影响标签的数量)。 | NUMBER | 2 | N | N | ||
LabelDisplayMode | 显示标签的位置 (内部、外部或无) | BOOLEAN | 内部 | N | N | ||
ShowDataLoading | 在数据加载时显示数据。 | BOOLEAN | True | N | N | ||
MinorTicks | 主要刻度之间的次要刻度数。 | NUMBER | 4 | N | N | ||
TickLength | 主要刻度的长度。 | NUMBER | 8 | N | N | ||
MinorTickLength | 次要刻度的长度。 | NUMBER | 4 | N | Y | ||
ValueDisplayMode | 显示值的位置 (顶部、底部、内部或无) | STRING | 底部 | N | N | ||
LabelDigits | 用于显示标签值的数字位数。 | NUMBER | 3 | N | N | ||
LabelDecimals | 用于显示标签值的小数位数。 | NUMBER | 0 | Y | N | ||
ValueDigits | 用于显示值的数字位数。 | NUMBER | 3 | N | N | ||
ValueDecimals | 用于显示值的小数位数。 | NUMBER | 0 | Y | N | ||
LegendDisplayMode | 显示图例的位置 (顶部、底部或无)。 | STRING | 底部 | N | N | ||
Legend | 仪表图例的文本。 | STRING | 不可用 | Y | Y | ||
ReferenceAngle | 控制仪表方向的角度 (度)。 | NUMBER | 225 | N | N | ||
Aperture | 控制仪表大小的角度 (度)。 | NUMBER | 270 | N | N | ||
NeedleDiameter | 仪表指针的直径 (像素)。 | NUMBER | 10 | N | N | ||
CenterDiameter | 仪表中心的直径 (像素)。 | NUMBER | 20 | N | N | ||
GaugeBorder | 仪表边界的宽度/厚度 (像素)。 | NUMBER | 20 | N | N | ||
RingWidth | 仪表环的宽度/厚度 (像素)。 | NUMBER | 10 | N | N | ||
ToolTipField | 可选工具提示，在运行时将光标悬停在小组件上时显示。 | STRING | 不可用 | Y | Y | ||
ShowDataLoading | 显示数据加载。 | BOOLEAN | True | N | N | ||
Visible | 设置小组件在运行时的可见性。 | BOOLEAN | True | Y | N |