首页
/ 【亲测免费】 垂直堆叠卡片(vertical-stack-in-card)安装与使用指南

【亲测免费】 垂直堆叠卡片(vertical-stack-in-card)安装与使用指南

2026-01-18 09:23:13作者:俞予舒Fleming

本教程旨在详细介绍GitHub上的开源项目vertical-stack-in-card,一个用于Home Assistant的自定义卡片,它允许用户将多个卡片组合成一个垂直排列的整洁卡片。我们将依次覆盖以下三个核心内容模块:

1. 项目目录结构及介绍

项目根目录主要包含:

  • custom_card.js: 核心JavaScript文件,实现了垂直堆叠卡片的功能。
  • manifest.json: 描述卡片的元数据,包括名称、版本、作者等信息。
  • README.md: 项目的主要说明文件,提供了快速入门指导和选项配置的详细解释。
  • example: 示例文件夹,包含如何使用该卡片的示例配置,帮助新用户快速理解使用方式。

项目设计以简洁高效为主,便于用户快速集成到他们的Home Assistant环境之中。

2. 项目启动文件介绍

主要关注点在于custom_card.js文件,它是实现垂直堆叠功能的核心。尽管这个“启动”并非传统意义上服务或应用的启动,但它代表了卡片在Home Assistant环境中的激活方式。用户无需直接“启动”此文件,而是通过在Home Assistant的配置中添加相应的前端资源来启用这一定制卡片。这通常涉及到将该项目添加到你的HACS(Home Assistant Community Store)或者手动下载并将JS文件放入正确的自定义组件或卡片目录下。

3. 项目的配置文件介绍

集成到Home Assistant的配置

虽然没有一个单独的传统“配置文件”直接属于此项目,但在Home Assistant中使用vertical-stack-in-card涉及在UI或配置文件(configuration.yaml)中创建新的卡片实例。基础使用方法如下:

  1. 手动添加到lovelace配置: 在你的Lovelace配置中,可以这样配置一段yaml来创建一个垂直堆叠卡片:

    type: 'custom:vertical-stack-in-card'
    cards:
      - type: sensor
        entity: sensor.example_temperature
      - type: weather
        entity: weather.openweathermap
    
  2. 选项配置: 你可以通过卡片属性增加额外选项,例如调整卡片间距等。具体选项可以在项目提供的README.md中找到详细说明。

通过这种方式,用户能够在界面中组织信息,使得不同的Home Assistant组件能够有序地展示在一个统一的视图内,增强了用户体验并优化了界面布局。


以上就是关于vertical-stack-in-card项目的基本结构、启动流程概述以及配置使用的关键信息。正确集成并配置此卡片后,你的Home Assistant界面将更加整洁且易于管理。

登录后查看全文
热门项目推荐
相关项目推荐