注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
微件向Workshop用户展示内容,是模块用户界面的核心构建块。常用微件包括筛选列表、对象表和按钮组微件。模块搭建者通过将微件放置在模块的设计中,并配置微件所需的输入和输出变量、显示选项以及应用案例所需的操作来在Workshop中构建应用程序。
要向模块添加微件,请在任何空白部分选择 + 添加微件 按钮,或在部分或模块标题中选择 + 按钮。然后,从打开的微件选择器模式中选择所需的微件。
将微件添加到Workshop模块后,选择微件以在屏幕右侧显示其配置选项。下面的示例将解释Workshop微件的一般核心概念,同时展示如何配置筛选列表微件。
微件的核心配置选项位于 微件设置 选项卡中。模块搭建者在此配置微件的输入和输出变量(即,最初填充微件的数据以及在适用时由微件生成和输出的数据),以及任何其他配置和显示选项。
下面的截图显示了新添加且尚未配置的筛选列表微件的初始状态:
在上面的筛选列表微件示例中,核心配置选项如下:
下面的截图显示了配置后的筛选列表的 微件设置 选项卡示例:
元数据 选项卡允许您重命名微件并访问微件的原始JSON配置。
编辑 微件名称 选项将影响当前微件在Workshop中的引用方式,最显著的是在 设计 面板中作为组件以及在默认变量名称中。
原始微件配置 显示当前微件的设置如何以JSON格式存储,并为高级模块搭建者提供快速查看、编辑或复制此配置的选项。
显示 选项卡允许配置当前微件的大小,并允许模块搭建者在自动(最大)、绝对和弹性大小之间切换。
配置微件后,您可以复制它以在模块中的任何地方重用。此功能对于重新创建复杂的微件配置特别有用;但是,如果微件配置可能经常更改,则可能更适合使用嵌入的Workshop模块微件。要复制微件以供重用,请选择微件并使用 Cmd+C
(macOS)或 Ctrl+C
(Windows)。使用 Cmd+V
(macOS)或 Ctrl+V
(Windows)将微件粘贴到左侧面板 设计 部分底部的 未使用的微件 区域。通过选择 + 添加微件 将微件添加到模块中,然后在微件选择器模式的 未使用的微件 选项卡中找到它。
或者,可以使用复制部分的控件来复制、剪切和粘贴微件。
输入和输出变量控制数据在Workshop模块中的流动。
输入变量定义传递到给定微件的数据,通常然后显示在微件中。输入变量的一个示例是传递到对象表、筛选列表、图表和地图微件的对象集输入。
输出变量定义从给定微件传出的数据,然后由后续下游微件或其他变量使用。输出变量的示例包括由对象表微件生成的“选定对象”对象集输出或由字符串下拉列表微件生成的“选定值”字符串输出。
上述微件配置示例包括对象表微件的输入变量(对象集)和输出变量(活动对象和选定对象)的可配置详细信息。有关变量的一般详细信息,请参阅变量文档。
微件提供多种用途,从可视化信息到在Workshop模块中触发事件和数据输出。以下类别大致分解了Workshop微件的功能: