创建

Dashboard 文件夹及文件

Appdaemon 配置文件夹下新建文件夹 dashboards,在此文件夹内新建文件 Hello.dash,此为 HADashboard 的配置文件,可任意命名。


文件头部

初始情况下,我们采用单文件的配置形式配置 HADashboard,当你运用熟练之后,可参考之后的高级教程进行多文件的配置。

配置文件顶层建议包含如下初始设定,当然它们都是可选的:

#
# 重要变量,全部可选
#
title: Main Panel
widget_dimensions: [120, 120]
widget_size: [1, 1]
widget_margins: [5, 5]
columns: 8
global_parameters:
    use_comma: 0
    precision: 1
    use_hass_icon: 1

变量说明:

  • title - 页面标题,默认为 HADashboard
  • widget_dimensions - 模块的高度和宽度的默认像素单位。请注意在这里绝对大小并不十分重要,因为大部分浏览器均采用响应式设计,会根据设备自动缩放页面。因此重要的应该是比例。默认值为 [120, 120] (width, height),这个尺寸适合在 iPad 上显示。
  • widget_size - 每个模块包含的方块数量
  • widget_margins - 每个模块之间的间隔。
  • rows - 总行数。最大值为 15 。
  • columns - 总列数。
  • global_parameters - 全局变量。应用于所有模块的设置,可以被单独的模块设置所覆盖。

页面排版

主体

完成头部之后,紧接着应该是整个 Dashboard 的排版,由 layout: 开头,每一行的显示模块以 - 开始,几行就有几个 -。 例如:

layout:
    - light.hall, light.living_room, input_boolean.heating
    - media_player(2x1), sensor.temperature

图例:

此处的设备可以直接使用 Home Assistant 的 entity_ID,查看页面为 Home Assistant 主页左下角 『开发者工具』——『状态 (States)』面板。

其中,clock(时钟)weather(天气) 模块为 HADashboard 自带,在 Home Assistant 中没有对应的组件,你只需直接使用 clock.clockweather.weather 即可。

在排版配置中同时包括了大小信息,以括号的形式接在模块之后,如 media_player(2x1)表示此模块为 2x1 的长方形模块,没有标注的模块均默认为 1x1 的正方形模块。

为了更直观地掌握排版情况,建议使用空格复现真实的排版情况,例如将上述配置转化为:

layout:
   - light.hall,       light.living_room, input_boolean.heating
   - media_player(2x1),                   sensor.temperature

对比效果图:

空行

空行的方法十分简单,直接添加 -后无任何内容即可:

- light.hall, light.living_room, input_boolean.heating
-
- media_player(2x1), sensor.temperature

图例:

空多行的方法为 empty: 行数

- light.hall, light.living_room, input_boolean.heating
- empty: 2
- media_player(2x1), sensor.temperature

图例: