管理组件模板


组件模板是可以应用于仪表盘页面和单页应用页面的标准化公共单元。通过将配置好的组件保存为模板,可以实现组件的高效复用与跨页面同步更新,从而大幅提升多页面大屏及应用的构建与维护效率。

本文介绍如何在模板中心管理组件模板,以及如何在页面编辑界面中使用和同步组件模板。

前提条件


已加入某个分组,并拥有该分组的相应权限。查看、编辑、使用组件模板,以及在分组内管理文件夹,均需要对应的 分组权限。更多信息,参见 管理分组。如需申请权限,请联系分组管理员。

访问组件模板列表


  1. 在 DTV 中心 右侧进入 模板中心。

  2. 切换到 组件模板 标签页。

  3. 左侧导航区:展示你有权限访问的 分组 和 文件夹 列表。组件模板严格受分组权限隔离,你只能看到具备权限的分组。

  4. 右侧内容区:选择左侧的分组和文件夹后,右侧将以卡片形式显示文件夹内的所有组件模板。你可以通过 新建文件夹 对组件模板进行分类归类。

创建和保存组件模板


组件模板无法直接在模板中心从零创建,而是在 仪表盘 或 单页应用 的实际编辑界面中,由已有组件转化而来。

  1. 打开任意 仪表盘 或 单页应用 的编辑界面。

  2. 选中你已经配置好的某个组件,图表和容器均支持。

  3. 在组件左上角的 … 下拉菜单中,选择 另存为模板。

  4. 在弹窗中配置以下基础信息:

  • 所属分组:选择将其保存到你拥有权限的对应分组。

  • 文件夹名称:选择分组内已有文件夹,或在下拉框中选择 + 添加 新建文件夹。

  • 模板名称:为组件模板命名,支持国际化。

  • 标签(选填):为组件模板添加标签,便于分类查询。选择分组内已有标签,或在下拉框中选择 + 添加 新建标签。


Widget Template


保存成功后,该组件将作为一个独立的模板呈现在 模板中心 > 组件模板 列表中。

管理组件模板


在 模板中心 > 组件模板 标签页中,将鼠标悬停在对应的组件模板卡片上,你可以执行以下管理操作。

修改基础配置


点击组件模板卡片上的 配置 config 图标,你可以进行以下操作:

  • 编辑模板基本信息:在下拉菜单中选择 配置,在弹窗中编辑模板的名称、标签、可见范围。

  • 查看模板影响范围:在下拉菜单中选择 配置,在弹窗中进入 模板影响范围 标签页,查看模板关联的页面。

  • 移动模板:在下拉菜单中选择 移动,将该组件模板移动到当前分组下的其他文件夹,或跨分组移动(需同时拥有目标分组的编辑权限)。

  • 删除模板:在下拉菜单中选择 删除,永久删除该组件模板。注意:删除模板不会自动删除页面中已引用的组件,但这些组件将失去与模板的关联关系,无法再进行同步更新。

更新关联页面


当组件模板的内容、样式或数据配置发生变更后,你需要将这些变更推送到所有绑定了该模板的页面中。

  1. 点击组件模板卡片上的 配置 config 图标,选择 更新关联页面 选项。

  2. 弹窗中自动列出当前系统内所有已引用该组件模板的仪表盘页面和单页应用页面。

  3. 选需要同步的页面,点击 确定。系统将把组件模板的最新配置自动批量覆盖并应用到所选页面的对应组件中。

使用组件模板


组件模板的核心价值在于“一次配置,多处复用”。你可以在 仪表盘编辑界面 和 单页应用编辑界面 中通过以下方式使用组件模板。

基于模板添加组件


  1. 进入仪表盘或单页应用的编辑界面。

  2. 在添加组件的弹窗中,选择 组件模板 标签页。

  3. 浏览你拥有权限的模板,选择目标组件模板。

  4. 在添加时,系统会弹出提示,要求你选择 是否跟随模板同步更新:

  • 跟随:该组件与模板建立强绑定。一旦该组件模板被修改并执行了“更新关联页面”操作,当前组件内容将自动应用并同步更新。

  • 不跟随:该组件仅复制模板当前的配置,作为一个完全独立的组件存在。后续模板的任何修改均不会影响此组件。

取消关联模板


当页面中的某个组件选择 跟随 组件模板,但在特定业务场景下需要对该组件进行个性化调整(如修改样式、自定义配置等)时,你需要先将其与模板进行解绑。

  1. 在页面编辑界面中,选中已绑定模板的组件。

  2. 此时,右侧组件配置面板顶部提示:“本组件已绑定 “XXX” 组件模板,如需自定义组件配置,请先解绑组件模板。”

  3. 点击提示下方的 解绑 按钮。

  4. 解绑后,该组件将恢复为独立组件,你可以自由编辑其所有配置。解绑后的组件将彻底失去与原组件模板的联动,未来模板更新时,该组件不会同步发生任何变化。