使用小组件 > 2D > 标签
  
标签
这个小组件有什么功能?
“标签”可以像窗体标签一样使用或者用作区域标题,具体取决于您如何使用文本对齐方式和应用样式。
何时会用到这个小组件?
当您想要在体验中加入文本时,会用到“标签”小组件。标签不仅可用于简单的一个字或两个字的标签,也可用于大量的文字。
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
下表列出了这个小组件的专用属性、服务和事件。
属性
JavaScript
类型
说明
启用基于状态的格式
enableStateFormatting
boolean
允许您根据 ThingWorx 中定义的状态定义设置小组件的格式。
选中此复选框,则会显示以下属性:
从属字段
状态定义
例如,如果标签的“状态定义”的值为 error,则标签将变成红色。
有关 ThingWorx 中的样式和状态定义的更多信息,请参阅 ThingWorx 帮助中心中的“样式和状态定义”
从属字段
* 
启用“启用基于状态的格式”时可见。
stateFormatValue
string
如果选中“启用基于状态的格式”复选框,则此属性可见。有关 ThingWorx 中的样式和状态定义的更多信息,请参阅 ThingWorx 帮助中心中的“样式和状态定义”
状态定义
* 
启用“启用基于状态的格式”时可见。
stateFormat
boolean
如果选中“启用基于状态的格式”复选框,则此属性可见。有关 ThingWorx 中的样式和状态定义的更多信息,请参阅 ThingWorx 帮助中心中的“样式和状态定义”
标签文本换行
wrap
boolean
当选中此复选框时,标签文本可以换行。
小组件的显示效果
以下是小组件的显示效果示例!
使用时的必要步骤
显示效果
1. “标签”小组件拖放到工作区中。在本示例中,我们将标签放置在“网格布局”小组件的单元格中。
2. “文本”字段中输入您想要显示的文本。
* 
为了设置标签的样式,我们在体验中添加了以下内容:
“项目”窗格中的“样式” > “应用程序”的下面 -
.my-label {
font-family: Century Gothic;
font-color: black;
font-size: 12pt;
font-weight: normal;
font-style: normal;
}
在每个标签的“类”字段中—my-label
使用 CSS 设置小组件样式
您可以使用 CSS 设置小组件样式!下面是您可以创建和应用的 CSS 类的示例:
* 
请注意,最好为您的类指定唯一名称,以避免与其他类或预装属性发生冲突。
CSS 示例
显示效果
.ptc-label {
font-size: 16px;
font-family: Century Gothic;
font-weight: bold;
color: Red;
};
有关实现 CSS 类的详细信息,请参阅应用程序样式