2025.3.4
首页 ▸ Dashboards ▸

仪表板卡片的页眉和页脚

部分仪表板卡片支持页眉和页脚小部件。这些小部件会填满卡片中所有可用空间。

带有图片页眉的实体卡片截图 带有图片页眉和按钮页脚的实体卡片截图。

以下卡片可以使用页眉和页脚：

图片页眉 & 页脚

用于在页眉或页脚显示图片的小部件。图片可以关联触摸操作。

header:
  type: picture
  image: "https://www.home-assistant.io/images/dashboards/header-footer/balloons-header.png"

Configuration Variables

Looking for your configuration file?
type string Required

picture

image string Required

图片的URL地址

alt_text string (Optional)

图片的替代文本。这对于使用辅助技术的用户是必要的。W3C图片教程提供了编写替代文本的简单指南。

tap_action map (Optional)

点击卡片时执行的操作。请参阅操作文档。

hold_action map (Optional)

长按时执行的操作。请参阅操作文档。

double_tap_action map (Optional)

双击时执行的操作。请参阅操作文档。

按钮页眉 & 页脚

用于在页眉或页脚将实体显示为按钮的小部件。

footer:
  type: buttons
  entities:
    - script.launch_confetti
    - entity: script.swirl_lights
      icon: "mdi:track-light"
    - entity: script.run_siren
      icon: "mdi:alarm-light"

Configuration Variables

Looking for your configuration file?
entities list Required

要显示的实体列表。每个条目可以是实体ID或映射。

entity string Required

要渲染的实体ID。

icon string (Optional)

覆盖实体图标。可以使用来自Material Design Icons的任何图标。图标名称前需加mdi:前缀，例如mdi:home。

image string (Optional)

覆盖实体图片。

name string (Optional)

按钮的标签。

show_icon boolean (Optional, default: true)

显示实体图标。

show_name boolean (Optional, default: false)

显示实体名称。

tap_action map (Optional)

点击按钮时执行的操作。请参阅操作文档。

hold_action map (Optional)

长按时执行的操作。请参阅操作文档。

double_tap_action map (Optional)

双击时执行的操作。请参阅操作文档。

图表页眉 & 页脚

用于在页眉或页脚将传感器域中的实体显示为图表的小部件。

带有图表页脚的实体卡片截图 带有图表页脚的实体卡片截图 

footer:
  type: graph
  entity: sensor.outside_temperature
  hours_to_show: 24
  detail: 1

Configuration Variables

Looking for your configuration file?
entity string Required

传感器域实体的ID。

detail integer (Optional, default: 1)

图表详细程度：1 或 2 (1 = 每小时一个点，2 = 每小时六个点)

hours_to_show integer (Optional, default: 24)

图表中显示的小时数。最小为1小时。较大的值可能会导致渲染延迟，特别是在所选实体有大量状态变化时。

相关主题