模块

除了直接引用 Home Assistant 的组件自动生成模块外,HADashboard 也支持创建自定义模块。自建模块的使用方法为:

模块名(自取&英文):
  widget_type: 模块类型,基本与 Home Assistant 组件分类一致
  ……

配置思路为找到所属的模块类型,按照可选参数进行配置,部分模块还提供样式自定义,方法为在 xxxx_style: 后添加 CSS 代码(高级内容)。

以下为 HADashboard 支持的模块具体配置参考:

clock 时钟

带有日期的 12 小时制的时间显示模块

示例配置:

clock:
    widget_type: clock
    date_format_country: "ro"
    date_format_options:
      weekday: "short"
      day: "numeric"
      month: "numeric"

变量说明:

  • time_format:时间格式,默认12小时制,24hr 为24小时制
  • show_seconds:设为 1 显示秒
  • date_format_country:日期显示格式适用国家
  • date_format_options:日期显示具体格式

样式变量: - widget_style:模块样式 - time_style:时间文字样式 - date_style:日期文字样式


weather 天气详情

当 Home Assistant 接入 Darksky Sensor 组件时自动生成,显示如下参数

  • temperature:温度
  • humidity:湿度
  • precip_probability:降水可能性
  • precip_intensity:降水量
  • wind_speed:风速
  • pressure:气压
  • wind_bearing:风向
  • apparent_temperature:体感温度
  • icon:图标

样式变量:

  • widget_style:模块样式
  • main_style:主体样式
  • unit_style:单位文字样式
  • sub_style:子标题样式

weather_summary 天气概况

仅显示天气概况图标和文字概述

示例配置:

weather_summary:
  title: 天气概况
  entity:sensor.dark_sky_daily_summary

强制变量:

  • entity:接入组件,目前仅支持 sensor.dark_sky_daily_summarysensor.dark_sky_hourly_summarysensor.dark_sky_summary
  • title:标题

样式变量:

  • state_text_style:状态文字样式
  • text_style:一般文字样式
  • title_style:标题文字样式
  • widget_style:模块样式

sensor 传感器

显示 Home Assistant 中传感器的值,Dashboard 将自动识别是否为数值传感器以适配格式。

示例配置:

air:
  title: 空气质量
  widget_type: sensor
  entity: sensor.air_index
  text_style: "font-size: 250%;"
  widget_style: "background-color: rgba(0, 98, 212, 0.85);"

变量说明:

  • title:主标题
  • title2:副标题
  • units:单位
  • precision:小数位数
  • shorten:使用千分位
  • use_comma:使用点表示小数

样式变量:

  • widget_style
  • title_style
  • title2_style
  • value_style
  • text_style
  • unit_style
  • container_style

其余 input_boolean,binary_sensor,label 文字标签,scene 场景,switch 开关,lock 锁,cover 门帘等模块配置相同,一并归纳。