Question

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.clock 和 weather.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