Lovelace 仪表盘卡片类型全览

什么是 Lovelace

Lovelace 是 Home Assistant 的前端仪表盘系统。它是一个可拖拽、可定制的卡片式 UI——你可以在一个页面上放各种卡片来控制灯光、查看传感器数据、显示摄像头画面、或者做复杂的统计图表。每个 Home Assistant 实例登录后看到的就是 Lovelace。

内置卡片类型速查

Home Assistant 内置了约 25 种卡片，覆盖最常见的展示和交互需求：

基础实体控制

卡片	用途
Entity Card	最基础的卡片——显示实体当前状态，点击可以开/关或调节
Entities Card	一组 Entity Card 的集合，适合把同区域的灯、开关、传感器放在一起
Light Card	灯光专用，一键开/关 + 滑条调亮度/色温/颜色
Media Control Card	媒体播放器专用，显示封面 + 播放控制
Climate Card	空调/恒温器专用，温度滑条 + 模式切换
Thermostat Card	另一种恒温器风格，环形温度显示

状态与数据展示

卡片	用途
Sensor Card	单个传感器的数值大字体显示（如"当前 24.5°C"）
Statistics Card	一段时间内传感器数值的统计（平均/最大/最小）+ 迷你折线图
History Graph Card	多个实体历史状态的折线图或面积图
Chart Card	比 History Graph 更高级的时间序列图
Gauge Card	仪表盘风格的弧形数值显示，适合电量、太阳能产量等百分比数据
Grid Card	网格布局容器，把多个小卡片排在一起

安全与安防

卡片	用途
Alarm Panel Card	报警控制面板（布防/撤防/在家/离家）
Lock Card	门锁控制卡片
Camera Card	摄像头实时画面，可以叠加 Motion 事件高亮
Picture Entity Card	一张背景图片，上面叠加实体状态和点击区域
Map Card	显示 GPS 追踪设备位置的地图

导航与布局

卡片	用途
Vertical Stack	垂直排列多个卡片
Horizontal Stack	水平排列多个卡片
Grid	网格排列（指定每行列数）
Masonry	瀑布流自适应排列
Conditional Card	只有当某个条件满足时才显示（如"有人在家才显示客厅灯控制"）
Entity Filter Card	显示所有匹配条件的实体（如"显示所有状态为 on 的灯"）
Button Card（内置版）	自定义按钮，可以做快捷控制或跳转

高级卡片

卡片	用途
Markdown Card	写任意 Markdown，支持 Jinja2 模板插入动态数据
Picture Elements	一张背景图片 + 多个可点击/可悬浮的元素叠加层
Picture Glance	Picture Elements 的简化版，适合一组设备的总览
Calendar Card	日历视图，可以显示 Google Calendar / Apple Calendar 事件
Logbook Card	实时滚动显示事件日志
Energy Card	能源流向图（太阳能→电网→家庭）

每个卡片都可以自定义

几乎所有卡片都支持以下通用属性：

type: entities          # 卡片类型
title: 客厅设备         # 卡片标题
show_header_toggle: true  # 标题栏显示全局开关
entities:
  - light.living_room
  - sensor.temperature
state_color: true       # 实体图标根据状态变色

用可视化界面配置 vs. YAML

Home Assistant 的 Lovelace 支持两种配置方式：

可视化界面（推荐新手）：Settings → Dashboards → 点击卡片右上角编辑图标 → 直接在界面里增删改卡片和属性
YAML 模式（推荐进阶用户）：点击编辑器右上角 </> 图标，切换到 YAML 编辑模式，可以手动写更灵活的卡片配置

两种方式可以随时切换，Home Assistant 自动保持同步。