安装与配置 `vacuum-card` for Home Assistant Lovelace UI

安装与配置 vacuum-card for Home Assistant Lovelace UI

vacuum-cardVacuum cleaner card for Home Assistant Lovelace UI项目地址:https://gitcode.com/gh_mirrors/va/vacuum-card

本文将指导您如何安装并配置开源项目 denysdovhan/vacuum-card，该插件用于在Home Assistant的Lovelace界面中添加一个定制的吸尘器卡片。

1. 项目目录结构及介绍

项目的目录结构通常包括源码、资源配置和文档等部分。由于没有提供具体的目录结构，这里假设一个标准的Node.js项目结构：

.
├── config
│   └── www          # 需要放置vacuum-card js文件的位置
├── package.json     # 项目依赖和元数据
└── vacuum-card.js   # 主要的JavaScript代码文件，用于Lovelace卡片

其中，config/www是存放自定义 Lovelace 资源的目录，而vacuum-card.js是这个项目的核心文件，包含了卡片的实现逻辑。

2. 项目启动文件介绍

在vacuum-card项目中，启动文件主要是指vacuum-card.js。你需要将这个文件下载到你的Home Assistant的配置文件夹中的www子目录，并且在Lovelace资源管理中添加对它的引用，这样它才能在浏览器端被加载执行，展示在你的Lovelace界面上。

3. 项目的配置文件介绍

在Home Assistant中，vacuum-card的配置主要通过Lovelace的UI编辑器或YAML进行。

使用UI配置

1. 在Lovelace界面点击右上角的三个点，选择“Configure UI”。
2. 点击“Resources”标签页，然后点击“+”按钮。
3. 将URL设置为/local/vacuum-card.js，类型设为“JavaScript Module”。

使用YAML配置

在lovelace配置文件中添加以下内容：

resources:
  - url: /local/vacuum-card.js
    type: module

之后，在Lovelace界面添加custom:vacuum-card卡片，并指定对应实体（entity），例如：

type: 'custom:vacuum-card'
entity: vacuum.vacuum_cleaner
actions:
  ...
stats:
  ...
shortcuts:
  ...

你可以根据实际需求配置actions、stats 和 shortcuts 来定制你的吸尘器卡片行为和显示状态。

请确保你的Home Assistant已启用HACS（Home Assistant Community Store）以方便安装，并参考项目README获取详细配置选项和示例。

vacuum-cardVacuum cleaner card for Home Assistant Lovelace UI项目地址:https://gitcode.com/gh_mirrors/va/vacuum-card