如何快速配置Home Assistant Mini Graph Card:终极使用指南
【免费下载链接】mini-graph-cardMinimalistic graph card for Home Assistant Lovelace UI项目地址: https://gitcode.com/gh_mirrors/mi/mini-graph-card
Home Assistant Mini Graph Card是一款专为Home Assistant Lovelace界面设计的极简风格图表卡片,能够将传感器数据以优雅的折线图形式直观展示。这款卡片支持传感器和二进制传感器实体,既能显示当前状态,又能呈现历史数据变化趋势。
📋 安装方法详解
推荐方式:通过HACS安装
HACS(Home Assistant Community Store)是社区第三方商店,安装最为便捷:
- 在HACS中搜索"Mini Graph Card"
- 点击安装并重启Home Assistant
- 在Lovelace界面添加资源引用
手动安装步骤
- 下载最新版本的
mini-graph-card-bundle.js文件 - 将文件复制到
config/www目录 - 在Lovelace配置中添加资源引用
资源引用配置
在您的ui-lovelace.yaml文件中添加以下配置:
resources: - url: /local/mini-graph-card-bundle.js?v=0.13.0 type: module🎯 基础配置快速上手
单实体卡片配置
最简单的配置方式,仅需指定实体ID:
type: custom:mini-graph-card entities: - sensor.illumination多实体卡片配置
同时展示多个传感器的数据:
type: custom:mini-graph-card name: 服务器监控 icon: mdi:server entities: - entity: sensor.server_total name: 总流量 - sensor.server_sent - sensor.server_received⚙️ 核心配置选项解析
必填选项
- type: 必须设置为
custom:mini-graph-card - entities: 传感器实体列表,支持单个或多个实体
常用可选配置
- name: 自定义卡片名称
- icon: 设置图标(使用MDI图标)
- hours_to_show: 显示历史数据的小时数,默认24小时
- show: 控制UI元素的显示/隐藏
🎨 高级定制技巧
图表样式定制
通过show选项可以精确控制卡片显示内容:
show: name: true # 显示名称 icon: true # 显示图标 state: true # 显示当前状态 graph: line # 图表类型:line/bar fill: true # 填充区域 legend: true # 图例(多实体时显示)颜色动态变化
根据数值范围动态改变线条颜色:
color_thresholds: - value: 20 color: "#f39c12" - value: 21 color: "#d35400" - value: 21.5 color: "#c0392b"柱状图展示
将图表类型切换为柱状图:
show: graph: bar🔧 实用配置案例
温度监控卡片
type: custom:mini-graph-card entities: - sensor.living_room_temp name: 客厅温度 hours_to_show: 24 line_color: "#e74c3c" line_width: 3能耗统计卡片
type: custom:mini-graph-card entities: - entity: sensor.energy_daily name: 日能耗统计 hours_to_show: 168 aggregate_func: max group_by: date show: graph: bar labels: true💡 使用技巧与注意事项
性能优化建议
- 合理设置
hours_to_show参数,避免加载过多历史数据 - 使用
update_interval控制数据更新频率 - 启用
cache选项提高加载速度
常见问题解决
如果卡片无法正常显示:
- 检查资源引用是否正确
- 确认实体ID是否存在
- 清除浏览器缓存
- 重启Home Assistant服务
🚀 进阶功能探索
双Y轴显示
为不同量级的传感器数据分别设置坐标轴:
entities: - entity: sensor.temperature y_axis: primary - entity: sensor.humidity y_axis: secondary自定义聚合函数
根据需求选择不同的数据聚合方式:
avg: 平均值min: 最小值max: 最大值sum: 求和值
📈 最佳实践总结
Mini Graph Card以其简洁的设计和强大的定制能力,成为Home Assistant用户首选的图表展示工具。通过合理配置各项参数,您可以创建出既美观又实用的监控界面。
记住关键配置要点:
- 先确保资源引用正确
- 从简单配置开始逐步完善
- 充分利用颜色和样式定制功能
- 根据实际需求选择合适的数据聚合方式
现在就开始使用Mini Graph Card,让您的Home Assistant仪表盘更加专业和直观!
【免费下载链接】mini-graph-cardMinimalistic graph card for Home Assistant Lovelace UI项目地址: https://gitcode.com/gh_mirrors/mi/mini-graph-card
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考