使用小组件 > 2D > 列表
  
列表
这个小组件有什么功能?
“列表”小组件可让您在单列列表视图中显示任何数据集。
何时会用到这个小组件?
当想要在数据集中显示特定属性的值时,会用到“列表”小组件。例如,如果您拥有一个卡车车队,并想要显示所有卡车的油位,则可以使用“列表”小组件并绑定车队中所有卡车共享事物的 OilLevel 属性。
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
下表列出了该小组件的专用属性。
属性
JavaScript
类型
说明
启用基于状态的格式
enableStateFormatting
boolean
允许您根据 ThingWorx 中定义的状态定义设置小组件的格式。
选中此复选框,则会显示以下属性:
从属字段
状态定义
例如,如果标签的“状态定义”的值为 error,则标签将变成红色。
有关 ThingWorx 中的样式和状态定义的更多信息,请参阅 ThingWorx 帮助中心中的“样式和状态定义”
从属字段
* 
启用“启用基于状态的格式”时可见。
stateFormatValue
string
如果选中“启用基于状态的格式”复选框,则此属性可见。有关 ThingWorx 中的样式和状态定义的更多信息,请参阅 ThingWorx 帮助中心中的“样式和状态定义”
状态定义
* 
启用“启用基于状态的格式”时可见。
stateFormat
boolean
如果选中“启用基于状态的格式”复选框,则此属性可见。有关 ThingWorx 中的样式和状态定义的更多信息,请参阅 ThingWorx 帮助中心中的“样式和状态定义”
显示字段
label
string
指定出现在“列表”小组件中的字段。通常,该属性与“值”字段相同,但也可能不同。
当小组件与 ThingWorx 数据绑定时,该字段会自动填充选项。
列表项内边距
itempadding
string
内容和边框之间的空间。输入一个数字,后面紧跟着受支持的格式 (例如,10px):
px
%
in
mm
cm
ex
em
pt
pc
小组件的显示效果
以下是小组件的显示效果示例!
使用时的必要步骤
显示效果
1. “列表”小组件拖放到工作区。
2. “数据”窗格中,添加您想要从实体中检索数据所使用的服务。
3. 添加了服务之后,将“所有项”拖放到小组件上,然后选择“选择绑定目标”窗口中的“列表”
4. “详细信息”窗格中的“显示字段”下面,选择您想要在列表中显示的属性。
绑定 ThingWorx 数据后的辅助配置字段
ThingWorx 数据绑定到小组件之后,某些字段会被下拉列表中的选项所填充。例如,如果您将“所有项”绑定到“列表”小组件,并在“选择绑定目标”窗口中选择了“列表”,则“显示字段”属性将被可用的选项填充。