Button Card 按钮卡片
button-card
⭐⭐⭐☆☆ (3/5)
🧩 软硬件结合
已发布
项目简介
❇️ Lovelace button-card for home assistant
button-card 是 Home Assistant 社区中广受欢迎的一款 Lovelace 自定义卡片组件，由开发者 RomRider 维护，并已默认收录于 HACS 商店中，下载量极高。它的核心价值在于，为 Home Assistant 中的任意实体提供了一个高度可定制的交互按钮，解决了原生卡片在样式、交互逻辑和布局灵活性上的不足。通过 button-card，用户不再受限于简单的开关或信息展示，而是可以打造出完全符合个人审美和操作习惯的控制面板。
标签
项目特点
**高度可定制**：支持自定义图标、颜色、大小、宽高比、CSS 样式和布局。
**丰富的交互动作**：支持点击、长按、双击三种操作，每种操作可配置 `toggle`、`more-info`、`navigate`、`call-service` 等 6 种动作。
**图标独立动作**：可单独为图标设置点击动作，优先级高于卡片主动作。
**瞬时动作**：支持 `press_action` 和 `release_action`，用于模拟物理按钮的瞬时按下和释放行为。
**自定义动作**：支持 `javascript`、`multi-actions`、`toast` 三种自定义动作。
**状态显示**：可选显示实体状态，并可根据状态自定义颜色、图标和样式。
**颜色类型**：支持将颜色应用于图标或卡片背景，并自动调整字体颜色。
**动画支持**：原生支持闪烁动画和图标旋转动画。
**安全保护**：支持确认弹窗和 PIN 码保护敏感操作。
**触觉反馈**：支持 iOS 配套应用的触觉反馈。
**兼容 HACS**：可通过 HACS 轻松安装和管理。
技术规格
| 类型 | |
|---|---|
| 兼容平台 | |
| 安装方式 | |
| 交互方式 | |
| 支持动作 | |
| 自定义动作 | |
| 颜色类型 | |
| 动画支持 | |
| 安全机制 | |
| 许可证 |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Home Assistant | 1 | — | 运行环境 |
| HACS (可选) | 1 | — | 推荐用于安装 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| 文本编辑器 | 编辑 YAML 配置文件 | ✅ 是 |
| Home Assistant | 运行和测试卡片 | ✅ 是 |
| HACS | 安装和管理卡片 | ▢ 推荐 |
能力画像
记忆与知识检索
1/5
逻辑推演
2/5
表达与交流
1/5
感知与观察
1/5
数理与计算
1/5
动手与操作
1/5
狂热与坚持
1/5
创造与创新
2/5
项目图库
所需技能
🔧 **动手能力**：无需硬件动手能力，只需在 Home Assistant 中配置 YAML 文件。
💻 **编程能力**：基础 YAML 语法知识，了解 Home Assistant 实体和 Lovelace 配置。
⚡ **电子电路**：无需电子电路知识。
适用场景
**智能家居控制面板**：为灯光、开关、传感器等实体创建美观且功能丰富的控制按钮。
**仪表板美化**：通过自定义样式和布局，提升 Home Assistant 仪表板的视觉效果。
**自动化触发**：使用 `call-service` 动作，一键触发复杂的自动化脚本或场景。
**安全控制**：为门锁、警报等敏感设备添加 PIN 码保护，防止误操作。