用例开发WorkshopCore concepts微件

注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

微件

微件向Workshop用户展示内容,是模块用户界面的核心构建块。常用微件包括筛选列表、对象表和按钮组微件。模块搭建者通过将微件放置在模块的设计中,并配置微件所需的输入和输出变量、显示选项以及应用案例所需的操作来在Workshop中构建应用程序。

要向模块添加微件,请在任何空白部分选择 + 添加微件 按钮,或在部分或模块标题中选择 + 按钮。然后,从打开的微件选择器模式中选择所需的微件。

微件选择器模式的截图

微件配置

将微件添加到Workshop模块后,选择微件以在屏幕右侧显示其配置选项。下面的示例将解释Workshop微件的一般核心概念,同时展示如何配置筛选列表微件。

微件设置

微件的核心配置选项位于 微件设置 选项卡中。模块搭建者在此配置微件的输入和输出变量(即,最初填充微件的数据以及在适用时由微件生成和输出的数据),以及任何其他配置和显示选项。

下面的截图显示了新添加且尚未配置的筛选列表微件的初始状态:

筛选列表微件的空配置截图

在上面的筛选列表微件示例中,核心配置选项如下:

  • 对象集: 这是筛选列表微件的输入变量,决定可用的筛选选项。此配置接受在此Workshop模块中定义的现有对象集变量或要创建的新对象集变量。
  • 筛选列表: 这决定了将在微件中显示的筛选选项。此配置选项在 对象集 填充后会更详细地显示;它将显示初始对象集中的属性类型,并允许在所有属性上按关键字搜索和按链接对象存在进行筛选。
  • 允许用户添加和删除筛选器: 此选项为微件添加一个用户界面,允许模块用户添加和删除显示的筛选器。
  • 筛选输出: 该选项是微件的对象集筛选变量输出。此筛选器可以应用于另一个对象集变量,以筛选指定变量中的对象。默认情况下,在将筛选列表微件添加到模块时,将创建一个输出变量。

下面的截图显示了配置后的筛选列表的 微件设置 选项卡示例:

筛选列表微件的完整配置截图

元数据

元数据 选项卡允许您重命名微件并访问微件的原始JSON配置。

编辑 微件名称 选项将影响当前微件在Workshop中的引用方式,最显著的是在 设计 面板中作为组件以及在默认变量名称中。

原始微件配置 显示当前微件的设置如何以JSON格式存储,并为高级模块搭建者提供快速查看、编辑或复制此配置的选项。

显示

显示 选项卡允许配置当前微件的大小,并允许模块搭建者在自动(最大)、绝对和弹性大小之间切换。

  • 自动(最大): 根据微件的内容自动缩放高度,同时设置最大高度。此选项不能用于在列设计中设置微件的宽度。
  • 绝对: 为微件指定固定的像素大小。
  • 弹性: 指定此微件的高度或宽度与当前模块中其他微件的比例,以便微件在屏幕尺寸或分辨率发生变化时适当缩放。

重用微件

配置微件后,您可以复制它以在模块中的任何地方重用。此功能对于重新创建复杂的微件配置特别有用;但是,如果微件配置可能经常更改,则可能更适合使用嵌入的Workshop模块微件。要复制微件以供重用,请选择微件并使用 Cmd+C(macOS)或 Ctrl+C(Windows)。使用 Cmd+V(macOS)或 Ctrl+V(Windows)将微件粘贴到左侧面板 设计 部分底部的 未使用的微件 区域。通过选择 + 添加微件 将微件添加到模块中,然后在微件选择器模式的 未使用的微件 选项卡中找到它。

在微件选择器模式中找到粘贴的未使用微件。

或者,可以使用复制部分的控件来复制、剪切和粘贴微件。

输入和输出变量

输入和输出变量控制数据在Workshop模块中的流动。

输入变量定义传递到给定微件的数据,通常然后显示在微件中。输入变量的一个示例是传递到对象表、筛选列表、图表和地图微件的对象集输入。

输出变量定义从给定微件传出的数据,然后由后续下游微件或其他变量使用。输出变量的示例包括由对象表微件生成的“选定对象”对象集输出或由字符串下拉列表微件生成的“选定值”字符串输出。

上述微件配置示例包括对象表微件的输入变量(对象集)和输出变量(活动对象和选定对象)的可配置详细信息。有关变量的一般详细信息,请参阅变量文档

微件类型

微件提供多种用途,从可视化信息到在Workshop模块中触发事件和数据输出。以下类别大致分解了Workshop微件的功能: