使用教程:Lovelace Card Mod
1. 项目介绍
Lovelace Card Mod 是一个由 Thomas Lovén 开发的开源项目,它允许你在 Home Assistant 的 Lovelace 界面中添加自定义 CSS 样式到几乎任何卡片。通过在卡片配置中加入 style:
属性,你可以轻松调整卡片的外观和布局,无需深入 CSS 编程。
2. 项目快速启动
安装
方法一(本地资源)
- 将
card-mod.js
文件下载至你的 Home Assistant/config/www
目录。 - 在 Lovelace 配置的
resources
部分添加以下代码:resources: - url: /local/card-mod.js type: javascript
方法二(HACS)
- 安装并配置 HACS 扩展。
- 在 HACS 中搜索
lovelace-card-mod
并安装。 - HACS 会自动将文件添加到适当位置。
快速使用
- 打开要修改的 Lovelace 卡片编辑器。
- 切换到代码视图。
- 在卡片配置的底部添加以下代码:
card_mod: style: | ha-card { color: red; }
- 保存并查看变更,卡片文字颜色应变为红色。
3. 应用案例和最佳实践
- 改变背景色:如果你想更改整个卡片的背景色,可以这样做:
card_mod: style: | ha-card { background-color: lightblue; }
- 隐藏元素:要隐藏特定元素,如头像或状态图标,使用CSS的
display:none;
:card_mod: style: | .state-badge { display: none; }
- 响应式设计:利用媒体查询实现不同屏幕尺寸下的样式变化。
最佳实践是确保修改仅限于目标卡片,避免影响其他卡片,以及保持CSS规则的简洁性。
4. 典型生态项目
- mod-card:当标准的
ha-card
不起作用时,这个项目提供了一个替代方案,使得Card Mod可以在某些复杂卡片上工作。 - Layout Card 和 Auto-Entities:这些第三方卡片与 Card Mod 结合使用,可以创建高度定制化的布局和自动化实体显示。
通过结合使用这些项目,你可以进一步提升Home Assistant Lovelace界面的美观度和用户体验。记得定期更新 Card Mod 以获取最新的功能和修复。