使用信息表定义工具栏操作
使用 ToolbarAction 数据形状创建信息表以定义欲在工具栏上显示的操作。信息表中的每一行均对应工具栏上的一个操作。可通过以下方式创建信息表以配置小组件：
• 设置欲显示操作的数量和类型。
• 控制操作的顺序和位置。
• 根据条件或事件控制每个操作的可见性。
• 设置每个操作的最大宽度。
以下过程概述了添加和配置工具栏小组件的步骤。
1. 设置功能要求，然后设计欲在工具栏上显示的操作。
2. 在 Composer 中，创建使用 ToolbarAction 数据形状格式化的工具栏配置服务。
3. 在 Mashup Builder 中，将工具栏小组件添加至混搭，然后使用工具栏配置服务添加实体。
4. 将工具栏服务的“所有数据”属性绑定至小组件 ActionsData 属性。
 |
工具栏上每个操作的可绑定属性将以下列格式显示在“属性”面板上：
• <ActionID>_<PropertyName>
|
5. 在“属性”面板上配置小组件，然后创建与其他小组件或功能的绑定。
有关小组件属性的详细信息，请参阅工具栏小组件 (可应用主题)。
常用字段定义
• actionID - 信息表中操作的 ID。该值用于在 Mashup Builder 中的“属性”面板上配置小组件时标识各个操作。
• actionMaxWidth - 用于指定最大自定义操作宽度的字段定义。默认情况下，工具栏上所显示的每个操作的最大宽度为 100 像素。
• actionTooltip - 定义工具提示消息的内容。还可使用 actionTooltipIcon 属性将图标添加至工具提示。
• actionVisible - 控制工具栏上操作的可见性。
• actionDisabled - 禁用操作。可通过编程方式控制此值，以根据混搭中的条件来启用或禁用操作。
• actionLabel - 欲针对工具栏上操作显示的标签。对于按钮和切换按钮操作，标签将显示于操作中。
• alignRight - 将操作与右侧区域对齐。
除常用属性外，数据形状还包含可用于配置“按钮”、“切换按钮”、“链接”和“下拉列表”操作的字段定义。以下部分列出了可用于每个操作类型的属性并附有相关示例。
按钮
buttonIcon - 通过参考媒体实体名称指定欲在按钮中显示的图标。
可显示 SVG 图标库中的 SVG 图标，此时需使用以下语法 cds:<icon_name>
有关可用图标的详细信息，请参阅使用 SVG 图标。
buttonType - 指定欲用于按钮的可视样式。选项：primary、secondary、tertiary、danger、transparent。
切换按钮
toggleChipIcon - 指定是否显示指示切换按钮状态的图标。选项：true、false。
toggleLabelPosition - 控制标签相对于图标的位置。选项：left、right。
链接
linkTargetWindow - 指定链接 URL 的打开方式。选项：new、same、popup。
linkType - 链接类型。
下拉列表
• dropdownData - 用于定义列表项的数据。例如：
[{label:"Item 1", value: "value1"}, {label:"Item 2", value: "value2"}, {label:"Item 3", value: "value3"}]
• dropdownSeelctedText - 用于在默认情况下使用值文本选择下拉列表中的一个项。例如，默认情况下使用以下表达式选择 Item 2：
dropdownSeelctedText: "value2";
• dropdownLabelPosition - 指定下拉列表标签的位置。选项：top、left
添加数据筛选器
可使用小组件属性在工具栏的左侧或右侧添加和配置筛选器。有关详细信息，请参阅工具栏小组件 (可应用主题)。
排列工具栏上的操作
使用小组件数据服务信息表排列工具栏上的操作。操作将根据其在信息表中的顺序进行排序。此外，可使用 alignRight 选项将操作对齐至工具栏的右侧。
ToolbarAction 数据形状
下表列出了 ToolbarAction 数据形状的字段定义。
字段定义 | 说明 | 基本类型 | ||
|---|---|---|---|---|
actionMaxWidth | 工具栏上操作的最大宽度。 | NUMBER | ||
toggleState | 切换开关的状态。 | BOOLEAN | ||
toggleChipIcon | 显示或隐藏用于指示选择的数据片段图标。 | BOOLEAN | ||
actionTooltip | 操作工具提示。 | STRING | ||
Visible | 控制操作可见性。 | BOOLEAN | ||
alignRight | 将操作与工具栏的右侧对齐。要将操作与左侧对齐，请将值设置为 false 或空值。 | BOOLEAN | ||
actionLabel | 操作标签。 | STRING | ||
actionTooltipIcon | 操作工具提示中显示的图标。 | IMAGELINK | ||
actionType | 要为工具栏操作 (按钮、链接、下拉列表或切换按钮) 显示的元素类型。 | STRING | ||
linkDestination | 链接的 URL。 | STRING | ||
buttonIcon | 要在按钮上显示的图标。 | IMAGELINK | ||
actionDisabled | 控制操作为交互式操作还是予以禁用。 | BOOLEAN | ||
buttonType | 要显示的按钮变型。可选择“一级”(默认)、“二级”、“三级”、“危险”或“透明”。 | STRING | ||
dropdownData | 一个 JSON 值，其中包含每个下拉列表项的数据。每个项由包含项标签、值和状态 (可选) 的 JSON 对象表示。 | JSON | ||
actionId
| 信息表中每一行的唯一标识符。每个 ID 均可用作 Mashup Builder 中“属性”面板上可绑定操作属性的前缀。 | STRING | ||
linkTargetWindow | 控制链接目标窗口的打开方式。可在新窗口、当前窗口或弹出式对话框 (“新建”、“同一”或“弹窗”) 中打开链接。 | STRING | ||
linkType | 链接类型。 | STRING | ||
dropdownSeelctedText | 要在下拉列表中选择的项的字符串值。 | STRING | ||
toggleLabelPosition | 控制切换按钮标签相对于状态图标的位置。选项：left、right | STRING |