2025.3.4
首页 ▸ Dashboards ▸

图片卡片

图片卡片允许您设置一个图像，用于导航到您界面中的不同路径或执行某个操作。

图片卡片的截图 图片卡片的截图。

将 图片卡片 添加到您的仪表板

  1. 要添加卡片，请按照 从视图添加卡片 的步骤 1-4。

    • 在步骤 2 中，在 按卡片 选项卡上，选择 图片卡片。

  2. 添加图片：

    • 上传图片 允许您从显示 Home Assistant 用户界面的系统中选择一张图片。
    • 本地路径 允许您选择存储在 Home Assistant 上的图片。例如：/homeassistant/images/lights_view_background_image.jpg。
    • 网络 URL 允许您使用来自网络的图片。例如 https://www.home-assistant.io/images/frontpage/assist_wake_word.png。

  3. 定义 图片卡片 的特定参数。

    • 有关特定设置的描述，请参阅 YAML 配置下的描述。
    • 它们同样适用于用户界面。

  4. 保存您的更改。

YAML 配置

在使用 YAML 模式或仅希望在 UI 中的代码编辑器中使用 YAML 时，可以使用以下 YAML 选项。

Configuration Variables

Looking for your configuration file?
type string Required

picture

image string Required

图像的 URL。当您希望在 Home Assistant 安装中存储图像时，请使用主机文件文档。存储文件后，可以使用 /local 路径，例如 /local/filename.jpg。

image_entity string (Optional)

要显示的图像或人员实体。

alt_text string (Optional)

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

theme string (Optional)

用任何加载的主题覆盖此卡片使用的主题。有关主题的更多信息，请参见前端文档。

tap_action map (Optional)

在卡片点击时采取的操作。见操作文档。

hold_action map (Optional)

在卡片点击并保持时采取的操作。见操作文档。

double_tap_action map (Optional)

在卡片双击时采取的操作。见操作文档。

示例

导航到另一个视图：

type: picture
image: /local/home.jpg
tap_action:
  action: navigate
  navigation_path: /lovelace/home

检查视图设置，了解如何设置自定义 ID。

使用操作切换实体：

type: picture
image: /local/light.png
tap_action:
  action: perform-action
  perform_action: light.toggle
  data:
    entity_id: light.ceiling_lights

相关主题