Mashup Builder > 小组件
小组件
ThingWorx 小组件是 ThingWorx 混搭页面的可视化元件。小组件可以是高级的数据呈现器 (如图表)，也可以是多个实用工具元件 (如按钮或导航链接)。数据呈现小组件具有传入数据绑定。执行数据服务时，系统会将数据结果集绑定到要呈现的小组件。其他小组件 (如按钮) 可能不具有传入数据绑定，但可能具有传出事件绑定。例如，可以将“按钮”小组件的 Clicked 事件绑定到数据服务。单击此按钮后，系统会在服务器上执行数据服务。
8.4.X 的小组件类别
ThingWorx Platform 中的 78 个小组件分为三大类。
• “标准”：在 Mashup Builder 中有 64 个小组件被列为“标准”小组件。这些小组件是 ThingWorx Platform 中的现有小组件。
• “测试版”：有 13 个新的小组件被列为“测试版”小组件。它们也可作为 web 组件，可从 SDK 导入。
• “旧式”：仅“重复器”小组件列出为“旧式”。此小组件将在以后的版本中弃用。
还有其他小组件可用作扩展。 扩展中列出了其中一些扩展。 PTC 软件下载页面中提供了一些扩展，用户可将这些扩展导入到 ThingWorx 并加以使用。这些导入的扩展在 Mashup Builder 的“导入的”类别中列出。
8.5.X 及更高版本的小组件类别
这些小组件在平台中分为五大类。单击 ThingWorx Composer“设计”页面中“小组件”面板上“类别”旁边的箭头，选择小组件类别。以下是对各类别中所包括内容的说明：
• “全部”：全部小组件。
• “标准”：“Web 组件”小组件以及 ThingWorx Platform 中没有 Web 组件可作为替代品的现有小组件。
* 
部分小组件称为 web 组件，因为它们可以在 ThingWorx Platform 中找到，也可从 SDK 导入。
• “可应用主题”：可应用样式主题的小组件。这些小组件在先前版本中被归类为“测试版”。
• “旧式”：具有标准小组件替代品的小组件。未来版本将会弃用这些旧式小组件。
• “导入的”：导入到 ThingWorx Platform 中的小组件会列于此类别下。 扩展中列出了其中一些扩展。 PTC 软件下载页面中提供了一些扩展，用户可将这些扩展导入到 ThingWorx 并加以使用。
此面板中提供了多个子类别，可帮助您根据小组件的功能来查找小组件。执行相似函数的小组件一并列于各个子类别下。例如，“图表”会显示可呈现图表的所有小组件的列表。您可以选择以下子类别来查找要在混搭中使用的小组件：“图表”、“协作”、“常用”、“组件”、“容器”、“数据”和“导航”
小组件放置
可以将小组件拖动到混搭上的某个位置。例如，可以将小组件拖动到混搭根，或拖动到容器对象，例如面板或字段集。
小组件属性
所有小组件都具有用于在页面上配置特定小组件实例的属性。属性将在 Mashup Builder 的小组件属性窗格中进行编辑。可以手动设置属性，也可以将其绑定到混搭中的其他数据服务或事件。如果属性可绑定，则在属性名称旁边将会有一个输入表面加工箭头 (可以从另一个源设置属性值) 和/或输出表面加工箭头 (属性值可以是另一个属性或参数值的源。每个小组件均共享以下属性：
• Id - ThingWorx 内部使用的唯一标识符。
• Type - 小组件类型。
• DisplayName - 用于标识小组件的易用型用户定义名称。
• Description - 用户定义的说明。
• Top - 小组件位置“上”的 Y 坐标。
• Left - 小组件位置“左”的 X 坐标。
• Width - 宽度 (像素)。
• Height - 高度 (像素)。
• Z-index - 分层小组件的排序。通常情况下，小组件会按照 Z 索引从高到低的顺序进行排列。
• ShowDataLoading - 数据加载时显示数据。
• Visible - 查看混搭时显示小组件。
当手动设置属性值时，属性行背景将会突出显示。如果该属性具有绑定，则会填充相关输入箭头。
小组件配置
可通过以下方式之一打开小组件配置对话框：
• 将鼠标悬停在小组件容器左上角的下拉箭头上，然后从列表中选取“配置绑定”。
• 选择小组件，然后单击“属性”面板中的 命令。
配置对话框中即会列出小组件的所有可绑定属性。可以查看或设置每个属性的绑定源和绑定目标。此对话框可作为绑定操作标准拖放方法的替代方法。某些小组件 (例如“高级栅格”) 均具有各自的配置对话框，您可以在此对话框设置特定于这些小组件的选项。
应用程序的本地化
单击文本属性旁边的 图标时，文本将不再设置为静态，而是基于本地化标记。单击魔术拾取器，以便您可以选择一个现有的本地化标记或创建一个新的本地化标记。当添加新的本地化标记时，您添加了一个具有命名空间的标记名称，以避免与来自其他源的标记发生冲突，并且只允许开发人员和翻译人员使用特定于应用程序的标记。在“字符串值”字段中，请输入默认的文本值。定义应用程序所需的所有标记后，可以对标记名称进行筛选，以便在“本地化标记”页面上查看这些标记。您应该为每个标记添加使用情况和上下文信息。
要翻译成其他语言，请确认这些语言的本地化表已存在。您可以使用导入/导出菜单将实体导出为 XML 文件。请输入具有命名空间的本地化标记作为标记前缀。在 XML 输出文件中，其他语言的翻译应该添加到空的 <Rows/> 元素中。翻译准备就绪且已确认本地化表属性 name、description、languageCommon 和 languageNative 正确，则可以将其导入到 ThingWorx 中，并将其与现有的语言本地化表合并。
请考虑以下方面：
• 如果引入新语言，许多小组件将使用系统本地化表中的标记。这些标记也需要翻译；然而，不存在可将这组标记限制为已使用标记的捷径。因此，此为手动筛选步骤。对于现有的语言，请检查系统标记是否已翻译。
• 导出和编辑 XML 文件时，请确保保留 UTF-8 编码。重新导入文件时，编码问题可能会显示为错误，或者显示为带问号或其他不需要的字符 (代替重音字母) 的本地化字符串。应将 ThingWorx 设置为使用 utf-8 作为默认文件编码。指定启动时的 Java 选项 -Dfile.encoding=UTF-8。
小组件事件
许多小组件除具有属性外，还具有事件。事件可用于触发数据服务。如果一个小组件具有一个或多个事件，则可在“属性”面板 (带有闪电图标) 中通过单击菜单进行访问。您可以将小组件事件从单击菜单中拖动到数据服务。
小组件样式
样式定义是用于控制小组件外观和显示的系统定义实体。某些小组件也支持状态定义，因此可以根据数据值动态应用样式。有关详细信息，请参阅各个小组件部分。有关设置用于小组件样式的属性面板的信息，请参阅 主题。