2025.3.4
首页 ▸ Dashboards ▸

历史图表卡片

历史图表卡片允许您为多达八个实体显示一个图表。

没有定义单位的历史图表卡片截图 没有定义 `单位` 的传感器的历史图表卡片截图。

定义了单位的历史图表卡片截图 定义了 `单位` 的传感器的历史图表卡片截图。

要将 历史图表卡片 添加到您的用户界面：

  1. 在屏幕右上角，选择编辑 按钮。
    • 如果这是您第一次编辑仪表板，将会出现 编辑仪表板 对话框。
      • 通过编辑仪表板，您将接管此仪表板的控制。
      • 这意味着当新的仪表板元素可用时，它将不再自动更新。
      • 一旦您接管控制，就无法将此特定仪表板恢复为自动更新状态。但是，您可以创建一个新的默认仪表板。
      • 要继续，请在对话框中选择三点菜单 ，然后选择 接管控制。
  2. 添加卡片并自定义操作和功能 到您的仪表板。

只有 y 轴和对数刻度设置可以通过用户界面配置。要配置此卡片的其他选项，您需要编辑 YAML 配置。

YAML 配置

在使用 YAML 模式或仅在代码编辑器中更喜欢使用 YAML 时，可以使用以下 YAML 选项。

Configuration Variables

Looking for your configuration file?
type string Required

history-graph

entities list Required

实体 ID 或 entity 对象的列表，见下文。

hours_to_show integer (Optional, default: 24)

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

title string (Optional)

卡片标题。

show_names boolean (Optional, default: true)

如果为假，则卡片中不显示实体名称。

logarithmic_scale boolean (Optional, default: false)

如果为真，Y 轴上的数值将以对数刻度显示。

min_y_axis float (Optional)

Y 轴范围的下限。

max_y_axis float (Optional)

Y 轴范围的上限。

fit_y_data boolean (Optional, default: false)

如果为真，配置的 Y 轴范围将自动扩展（但不会缩小）以适应数据。

expand_legend boolean (Optional, default: false)

如果为真，图例将最初显示所有项目。

实体的选项

如果您将实体定义为对象而不是字符串，则可以添加更多定制和配置：

Configuration Variables

Looking for your configuration file?
entity string Required

实体 ID。

name string (Optional)

覆盖友好名称。

示例 

type: history-graph
title: '我的图表'
entities:
  - sensor.outside_temperature
  - entity: media_player.lounge_room
    name: 主播放器

或者在更长的时间范围内，将多个实体（只要它们分享相同的单位）放在一个图表中：

type: history-graph
title: "过去 48 小时的温度"
hours_to_show: 48
entities:
  - sensor.outside_temperature
  - entity: sensor.lounge_temperature
    name: "客厅"
  - entity: sensor.attic_temperature
    name: "阁楼"

相关主题