Bubble Card开源项目使用指南

Bubble Card开源项目使用指南

Bubble-Card Bubble Card is a minimalist card collection for Home Assistant with a nice pop-up touch. 项目地址: https://gitcode.com/gh_mirrors/bu/Bubble-Card

项目基础介绍

Bubble Card是一个为Home Assistant设计的简约卡片集合，具有美观的弹出触摸效果。该项目主要使用JavaScript进行开发，并依赖于Home Assistant的前端环境。用户可以通过这个卡片集合来增加和自定义一些交互式卡片到Home Assistant的界面上。

主要编程语言

• JavaScript：用于前端交互逻辑的实现。
• YAML：配置文件中使用，用于设置卡片的各种参数。

新手使用该项目需要注意的3个问题及解决步骤

问题1：如何安装Bubble Card

解决步骤：

1. 直接下载安装（无HACS）

   • 下载bubble-card.js和bubble-pop-up-fix.js文件。
   • 将这些文件上传到Home Assistant的<config>/www文件夹中。
   • 在Home Assistant的仪表盘右上角点击图标，选择“编辑仪表盘”。
   • 再次点击图标，选择“管理资源”。
   • 点击“添加资源”，粘贴路径/local/bubble-card.js?v=1。
   • 选择JavaScript模块，然后点击“创建”。
   • 返回并刷新页面，在页面右下角点击“添加卡片”按钮搜索“Bubble Card”。
   • 文件更新后，需要编辑/local/bubble-card.js?v=1，将版本号改为更高，如果出现问题尝试清除浏览器缓存。

2. 通过HACS安装（推荐）

   • 如果尚未安装HACS，请根据***进行安装。
   • 进行HACS的初始配置，详情可参阅***。
   • 在侧边栏导航至HACS -> Frontend。
   • 点击右下角的“+”按钮，搜索“Bubble Card”并下载。
   • 返回到仪表盘，点击右上角图标，选择“编辑仪表盘”。
   • 点击右下角的“添加卡片”，搜索并添加“Bubble Card”。
   • 如果出现问题，尝试清除浏览器缓存。

问题2：如何配置Bubble Card

解决步骤：

1. 进入Home Assistant编辑器，在“开发者工具”->“资源”找到“Bubble Card”卡片。
2. 可以在编辑器中设置卡片的参数，具体配置项请参考项目的文档说明。
3. 如果需要查看具体参数配置的示例，可以在项目的文档中找到详细配置指南。

问题3：如何处理更新问题

解决步骤：

1. 在每次文件更新后，需要修改卡片资源文件路径中的版本号（即URL中v=1部分的数字）以确保加载最新版本的Bubble Card。
2. 如果在更新后遇到卡片未更新的问题，请尝试清除浏览器缓存。
3. 如果问题依旧存在，回到安装步骤检查每一步是否都正确执行。

请注意，以上步骤是基于当前项目的官方文档和提供的信息编写。如项目有更新，建议查看最新的官方文档以获取最新安装和配置指南。

Bubble-Card Bubble Card is a minimalist card collection for Home Assistant with a nice pop-up touch. 项目地址: https://gitcode.com/gh_mirrors/bu/Bubble-Card