Logbook Card for Home Assistant UI Lovelace
1. 项目介绍
Logbook Card 是一个为 Home Assistant 的 Lovelace UI 设计的开源卡片,用于显示实体或多个实体的历史记录。该卡片能够以多种方式展示日志信息,包括状态变化、持续时间、自定义日志等,并提供丰富的配置选项以满足不同用户的需求。
2. 项目快速启动
安装
使用 HACS
此卡片可在 Home Assistant Community Store (HACS) 中找到。在 HACS 中添加并更新 Logbook Card。
手动安装
- 从最新版本下载
logbook-card.js
文件。 - 将下载的文件存储到 Home Assistant 配置目录下的
www
文件夹中。
配置 Lovelace
在 Lovelace 配置文件中添加以下资源:
resources:
- url: /local/logbook-card.js?v=1
type: module
使用卡片
在 Lovelace 的视图配置中,你可以使用以下基础配置来显示一个实体的日志:
- type: 'custom:logbook-card'
entity: 'entity_id'
title: 'Card Title'
history: 5
3. 应用案例和最佳实践
隐藏特定状态
如果你想要隐藏某些特定状态的变化,可以使用 hidden_state
配置:
- type: 'custom:logbook-card'
entity: 'entity_id'
hidden_state:
- 'state1'
- 'state2'
自定义日期格式
使用 date_format
选项来自定义日期显示格式:
- type: 'custom:logbook-card'
entity: 'entity_id'
date_format: 'YYYY-MM-DD HH:mm:ss'
分组显示
通过 group_by_day
选项,你可以按天分组日志条目:
- type: 'custom:logbook-card'
entity: 'entity_id'
group_by_day: true
4. 典型生态项目
Logbook Card 作为 Home Assistant 生态系统的一部分,通常与以下项目一起使用:
- Home Assistant:智能家居自动化平台。
- [Lovelace UI](https://www.home-assistant.io Lovelace):Home Assistant 的用户界面。
- HACS:Home Assistant Community Store,用于发现和安装社区开发的插件。
通过结合这些项目,用户可以打造一个强大且个性化的智能家居系统。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考