产品定价 立即试用
专业版
文档 > 仪表盘 > 布局
入门
指南 安装 架构 API 常见问题
目录

布局

仪表板布局决定部件在仪表板网格上的呈现方式。 每个仪表板状态可拥有自己的布局类型、设置和断点, 便于针对不同IoT用例和屏幕分辨率打造定制化的视觉呈现。

要修改特定状态的布局,请按以下步骤操作:

  1. 点击窗口右上角的“Edit mode”按钮进入仪表板编辑模式
  2. 点击仪表板窗口左上角的“Layouts”按钮。将打开布局管理窗口。

在“Manage layouts”窗口中,可选择适合需求的布局类型:

  • Default - 灵活的通用布局;
  • SCADA - 最适合显示SCADA HMI(人机界面);
  • Divider - 用于视觉分隔区块。


断点允许创建可适应不同屏幕尺寸的响应式布局。 可添加和配置断点,以确保仪表板在任何设备上都能完美呈现。 下文将详细讨论各布局类型的设置及断点配置。

布局类型

平台支持三种布局类型:Default、SCADA和Divider。每个仪表板状态仅配置一种布局类型。

默认布局

Default布局是适用于大多数仪表板的通用布局。 此布局类型支持响应式设计的屏幕断点。

SCADA

SCADA布局专为创建SCADA HMI(人机界面)设计。 SCADA HMI通常由名为SCADA符号的可缩放部件组成。 但也可在同一布局上将SCADA 符号与500多个ThingsBoard 部件结合使用。 此布局类型同样支持响应式设计的屏幕断点。

分隔布局

旧版Divider布局可将一个“Default”布局拆分为左右两个子布局。 可使用固定像素值或屏幕宽度百分比配置这些子布局的宽度。 “Default”布局的大多数布局参数同样适用于子布局。 但目前子布局不支持断点。

为展示效果,让我们以完全不同的方式配置左右布局。为左侧布局添加背景图,为右侧布局应用新的背景色。 并以一定百分比比例调整窗口大小(仅为示例,非推荐做法)。设置参数后,点击Layouts窗口中的“Save”按钮查看更改。

断点

ThingsBoard 3.8.0引入了断点。 允许根据最终用户的屏幕宽度定义不同的布局设置和部件。

每个仪表板状态拥有一个Default断点。 若没有其他断点匹配当前屏幕分辨率,则使用此布局。

可定义以下断点:

  • Desktop (xl) - 最小1920px,最大5000px;
  • Desktop (lg) - 最小1280px,最大1919px;
  • Laptop (md) - 最小960px,最大1279px;
  • Tablet (sm) - 最小600px,最大959px;
  • Mobile (xs) - 最大599px。

添加断点

要添加断点,打开“Manage layouts”窗口并点击断点表中的“+”按钮。 添加新断点时,可选择对应的屏幕分辨率,并可从其他断点复制部件和布局设置。

可点击“齿轮”图标打开该断点的布局设置。布局设置决定仪表板的背景配置及部件在仪表板上的排列方式。

也可点击“垃圾桶”图标删除断点。在对话框中确认删除断点。

切换断点

用户打开仪表板时,将根据屏幕分辨率自动选择对应的断点布局。

编辑仪表板时,用户可使用屏幕左上角的下拉框在布局间切换。

断点示例仪表板

我们准备了配置了若干断点的示例仪表板。可导入到您的环境中,在编辑模式下探索如何在不同断点间切换。 还可在浏览器开发者工具中更改屏幕分辨率,观察跨越特定屏幕分辨率断点时布局的变化。

查看同一仪表板在不同屏幕类型上的效果:

部件引用与部件副本

部件引用

使用多个断点时,理解部件引用与部件副本的区别很重要。

默认情况下,创建新断点布局时,源布局中的所有部件均按引用复制。 例如,若Default和Desktop (xl) 两个断点引用同一图表部件,对部件配置的任何更改将在两个布局间同步。 但部件的位置和大小在各布局中独立设置。

  • 要按引用复制部件,右键点击部件并选择“Copy reference”(Ctrl+R);
  • 要将部件作为引用粘贴到另一断点布局,右键点击空白处并选择“Paste reference”(Ctrl+I)。

在编辑模式下,可通过部件编辑面板中的“Reference”按钮识别引用部件。

要将引用替换为部件副本,点击部件编辑面板上的“Reference”按钮,或右键点击部件并选择“Replace reference with widget copy”。


部件副本

部件副本是部件配置的完整独立副本。对副本部件的更改不会影响原始部件。

  • 要复制部件,右键点击部件并选择“Copy”(Ctrl+C);
  • 要将部件粘贴到另一断点布局,右键点击空白处并选择“Paste”(Ctrl+V)。

布局设置

点击断点旁的“齿轮”图标打开布局设置。

列数

编辑仪表板尤其是调整部件大小和间距时,可看到灰色背景上的浅色网格。 这些是决定仪表板水平方向可容纳部件数量的列。默认列数为24。可增加或减少列数。最小列数为10,最大为1000列。

最小布局宽度

默认最小列数为24。可增加或减少该数值。最小列数为10。建议此参数值大于或等于列数。

部件间距

此边距类型决定部件之间的间距。 默认边距为10。可将“部件间距”设为0移除边距,或增加边距(即部件间的距离)。最大允许边距为50。

将边距应用到布局两侧

此参数决定是否应将“部件间距”值应用到布局两侧。

自动填充布局高度

默认情况下,“自动填充布局高度”复选框未勾选,以便自由调整部件大小。 勾选此选项后,仪表板上的所有部件将在屏幕空间内垂直填充。

背景颜色

“背景颜色”设置允许自定义仪表板的背景颜色。 要更改背景颜色,点击背景颜色部分右侧小方框中的颜色。 在弹出窗口中选择所需颜色和透明度。然后点击“Select”。之后应用布局设置。保存后即可看到自定义背景。

背景图片

此选项允许将图片设为仪表板背景。可从图片库选择图片或设置直链。

要从图库选择图片,点击“Browse from gallery”。选择已上传的图片或添加新图片。 要更精确地调整图片位置,点击“背景尺寸模式”部分的下拉菜单,选择图片如何填充背景区域。 例如,选择“Cover”并点击“Save”查看背景变化。

移动布局设置

默认情况下,“自动填充布局高度”复选框未勾选,以便自由调整移动设备的部件大小。 勾选此选项后,仪表板上的所有部件将在屏幕空间内垂直填充。

移动行高

移动行高决定移动设备上部件的高度。 默认高度为70px,可调大或调小。最小移动行高为5px,最大允许值为200px。