产品定价 立即试用
云平台
欧洲地区
文档 > 白标定制 > 自定义菜单
入门
指南 API 常见问题
目录

自定义菜单

文档信息图标
ThingsBoard PE 功能

专业版支持Custom Menu功能。
请使用ThingsBoard Cloud自行安装平台实例。

在ThingsBoard中自定义菜单可根据需求调整导航菜单,快速访问最常用的功能和仪表板。 您可以添加新菜单项、显示或隐藏现有项。

菜单自定义选项:

  • 添加新菜单项:可为菜单添加新项,包括链接到指定仪表板或外部网页;

  • 修改图标和名称:可为每个菜单项自定义图标和名称,更好体现其功能与价值;

  • 调整菜单顺序:可拖拽并重排菜单项顺序,按工作流优化界面;

  • 个性化设置:可为每个租户、客户或其用户单独自定义菜单,提供更高层级的个性化。

 

添加自定义菜单

在ThingsBoard中添加自定义菜单前,需先根据最终用户(租户或客户)确定其适用范围。

租户范围选项:

  • 未分配 - 表示自定义菜单未分配给任何租户用户。适用于菜单配置阶段,之后可分配给所需租户用户;
  • 所有租户用户 - 选择此项表示租户级所有用户均可访问该菜单;
  • 用户列表 - 可创建有权访问该菜单的用户列表。

客户范围选项:

  • 未分配 - 表示自定义菜单未分配给任何客户或客户用户。适用于菜单配置阶段,之后可分配给所需客户或客户用户;
  • 所有客户用户 - 选择此项可将自定义菜单应用到所有客户及其用户;
  • 用户列表 - 可将自定义菜单应用到指定客户用户或客户用户列表;
  • 客户列表 - 可将自定义菜单应用到指定客户或客户列表及其用户。

添加新自定义菜单

添加新自定义菜单的步骤:

  • 前往“白标”页面的“自定义菜单”选项卡,点击“加号”图标;
  • 在新窗口中输入自定义菜单名称;
  • 选择范围:租户或客户;
  • 指定将此自定义菜单分配给谁;
  • 完成所有设置后点击“添加”;

自定义菜单已添加。

自定义菜单配置

添加新菜单项

可添加链接到指定仪表板或外部网页(如文档页)的菜单项。

文档信息图标

请注意:
在项目中使用URL前,请确认该页面允许在iframe中嵌入。 可检查 X-Frame-Options HTTP头的取值。若为DENY或SAMEORIGIN,表示该页面无法在其他域的iframe中嵌入或仅限同域。若需将您的域名列入可嵌入列表,必须在响应头中明确指定。 建议检查域名是否在响应头或内容安全策略(CSP)的允许列表中,以避免页面在iframe中显示时出现异常。

添加新菜单项步骤:

  • 点击页面底部的“添加自定义菜单项”按钮;
  • 输入菜单项名称。保持项类型为“链接”,指定操作:打开仪表板或URL,点击“添加”;
  • 新菜单项将添加至列表底部。从左侧拖拽可调整上下顺序;
  • 点击“保存”应用菜单更改。

点击新菜单项将打开指定仪表板或网页(以设置中配置为准)。


也可在现有项之间插入新项:

  • 将鼠标悬停在两个菜单项之间,点击“添加自定义菜单项”;
  • 输入菜单项名称,保持项类型为“链接”,指定操作:打开仪表板或URL,点击“添加”;
  • 新菜单项将插入到现有项之间;
  • 点击“保存”应用菜单更改。

点击新菜单项即可进入指定仪表板。

添加子项

可将多个菜单项归入一个分组。例如,“实体”分组包含设备、资产和实体视图。

示例:添加一个分组并在其中放置两个子项。

  • 先添加分组。添加新菜单项,命名为“我的仪表板”,选择“分组”类型,点击“添加”;
  • 已添加“分组”类型的自定义项。“我的仪表板”分组下出现“+ 添加子项”按钮,点击为该分组添加子项;
  • 输入菜单项名称“仪表板A”,指定对应仪表板;
  • 子项已添加,已按层级归属于“我的仪表板”分组;
  • 再添加一个菜单项,命名为“仪表板B”并指定第二个仪表板,保存更改;

左侧菜单中会出现名为“我的仪表板”的分组,点击展开后可见两个指向仪表板的子项。点击“仪表板A”菜单项可打开对应仪表板。 再点击“仪表板B”菜单项可进入第二个仪表板。

编辑菜单项

编辑菜单项时,点击要编辑的菜单项行中的“铅笔”图标。完成修改后点击“应用”并保存,菜单项配置即已更新。

文档信息图标

请注意: 只能为自定义菜单项修改操作。

恢复默认菜单

可点击“恢复默认菜单”按钮将所有更改重置为默认状态,然后点击“保存”应用更改。

将菜单项恢复为默认

可点击菜单项行中的“扫帚”图标将该项恢复为默认,然后点击“保存”应用更改。

隐藏现有菜单项

若要在ThingsBoard用户界面中隐藏菜单项,在该菜单项行中将“隐藏/可见”开关切换为“隐藏”。

若要再次显示已隐藏的菜单项,将该菜单项行的“隐藏/可见”开关切换为“可见”并保存。


隐藏所有菜单项

若要从零开始配置菜单,可点击窗口顶部的“隐藏所有菜单项”按钮以隐藏所有菜单项。

文档信息图标

请注意: 唯一无法隐藏的菜单项是“首页”。

显示隐藏项

默认情况下,自定义菜单配置窗口中会显示隐藏的菜单项。要隐藏它们,可将“显示隐藏项”开关设为“关闭”。

删除菜单项

删除自定义菜单项时,点击要移除的菜单项行中的“垃圾桶”图标,然后保存更改。

文档信息图标

请注意: 只能删除自定义项。默认项不可删除,只能隐藏

编辑自定义菜单名称

编辑自定义菜单名称时,点击该自定义菜单行中的“铅笔”图标,修改名称后点击“保存”。

管理自定义菜单分配对象

管理分配到此自定义菜单的用户时,点击该用户菜单行中的对应图标,从下拉菜单中更改分配类型并保存。分配类型已更新。

删除自定义菜单

删除自定义菜单时,点击该用户菜单行中的对应图标,点击“是”确认删除。

下一步