Home Assistant的 Honeycomb-Menu 模块安装与配置指南
1. 项目基础介绍
Honeycomb-Menu 是一个为 Home Assistant 设计的模块,它不是一个卡片(card),而是一个可以应用到任何 lovelace 卡片上的模块。当通过定义好的动作激活时,该模块会显示一个带有可选的 XY pad 的六边形按钮列表,使得与 lovelace 的交互更加流畅。
该项目主要使用 JavaScript 编程语言。
2. 关键技术和框架
- Home Assistant: 一个开源的家庭自动化平台,能够通过集成的应用程序和设备来控制家中的各种设备。
- Lovelace UI: Home Assistant 的一个用户界面,允许用户自定义和控制他们的智能家居系统。
- JavaScript: 用于开发网页和服务器端应用程序的编程语言。
- Webpack: 一个现代 JavaScript 应用程序的静态模块打包器。
3. 安装和配置准备工作
在开始安装之前,请确保您已经具备以下条件:
- Home Assistant 已经安装在您的系统上。
- 您熟悉如何使用 Home Assistant 的文件结构和配置方法。
- 您有一台可以访问 Home Assistant 配置文件的计算机。
安装步骤
-
下载模块: 从 Home Assistant 的前端 UI 下载 honeycomb-menu.js 文件,或者通过 git 命令克隆整个仓库到本地。
git clone https://github.com/Sian-Lee-SA/honeycomb-menu.git
-
放置文件: 将下载的 honeycomb-menu.js 文件放置到您的 Home Assistant 安装目录下的
config/www
路径中。如果您喜欢整理文件,可以创建子目录存放,但记得更新资源 URL 以包含正确的子路径。 -
配置 Lovelace:
- 通过 YAML 配置:在您的
lovelace.yaml
文件中,添加以下内容到resources
部分:resources: - url: /local/honeycomb-menu.js type: module
- 通过 Web 界面配置:
- 打开 Home Assistant 配置页面,选择“Lovelace Dashboards”。
- 选择“Resources”标签。
- 点击右下角的“+”按钮,添加新的资源。
- 在 URL 字段中输入模块的 JS 文件路径,确保使用
/local/
替换config/www/
路径。 - 确保资源类型选择为“JavaScript Module”。
- 通过 YAML 配置:在您的
-
使用 Honeycomb-Menu: 在您的卡片配置中,使用
fire-dom-event
动作来调用 honeycomb 菜单,并通过honeycomb_menu
属性传递配置选项。- type: vertical-stack cards: - type: button entity: light.kitchen hold_action: action: fire-dom-event honeycomb_menu: template: light autoclose: false active: true
完成以上步骤后,您应该可以在 Home Assistant 的前端看到并使用 Honeycomb-Menu 模块了。