Home Assistant Swipe Navigation 使用教程

Home Assistant Swipe Navigation 使用教程

hass-swipe-navigation ↔️ Swipe through Home Assistant Dashboard views on mobile. 项目地址: https://gitcode.com/gh_mirrors/ha/hass-swipe-navigation

1. 项目目录结构及介绍

Home Assistant Swipe Navigation 项目的目录结构如下：

.
├── .devcontainer
├── .github/
│   └── workflows
├── .hass
├── .husky
├── docker
├── scripts
├── src
│   └── ...源代码文件
├── tests
├── .commitlintrc
├── .czrc
├── .editorconfig
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── docker-compose.test.yml
├── docker-compose.yml
├── eslint.config.mjs
├── example.gif
├── hacs.json
├── package-lock.json
├── package.json
├── playwright.config.ts
├── playwright.global-setup.ts
├── playwright.global-teardown.ts
├── rollup.config.mjs
└── tsconfig.json

• .devcontainer: 开发容器配置文件。
• .github/workflows: GitHub Actions 工作流配置。
• .hass: Home Assistant 配置文件。
• .husky: Husky 配置文件，用于 Git 钩子。
• docker: Docker 配置文件。
• scripts: 脚本文件夹。
• src: 源代码文件夹，包含项目的核心代码。
• tests: 测试代码文件夹。
• 其他配置文件和文档。

2. 项目的启动文件介绍

项目的启动主要通过 src 目录下的 JavaScript 文件实现。具体启动方式取决于安装方法：

通过 HACS 安装

1. 在 Home Assistant 的前端页面点击右下角的加号按钮。
2. 搜索 "Home Assistant swipe navigation" 并安装。
3. 刷新 Dashboard 页面，可能需要清除缓存。

手动安装

1. 从最新版本中复制 swipe-navigation.js 文件到 /www/hass-swipe-navigation/ 目录下。
2. 在 ui-lovelace.yaml 或 Dashboard 资源中添加该资源。

resources:
  - url: /local/hass-swipe-navigation/swipe-navigation.js?v=1.0.0
    type: module

3. 刷新页面，可能需要清除缓存。

3. 项目的配置文件介绍

配置文件主要用于定义项目的行为和外观。配置信息通常放置在 Home Assistant 的 Dashboard 配置文件中。

以下是一些常见的配置选项：

• animate: 设置滑动动画效果，可以是 none, swipe, fade, flip。
• animate_duration: 滑动动画的持续时间，单位为毫秒。
• enable: 启用或禁用滑动导航。
• enable_mouse_swipe: 启用或禁用鼠标滑动导航。
• enable_on_subviews: 在子视图中启用滑动导航。
• logger_level: 设置日志级别。
• prevent_default: 阻止浏览器默认的水平滑动行为。
• skip_subviews: 自动跳过子视图。
• skip_tabs: 设置在滑动时需要跳过的视图列表。
• swipe_amount: 设置滑动屏幕的最小百分比。
• wrap: 启用从第一个视图滑动到最后一个视图，反之亦然。
• skip_hidden: 自动跳过隐藏的视图。

配置示例如下：

swipe_nav:
  wrap: false
  enable_mouse_swipe: true
  animate: swipe
  skip_tabs: 5,6,7,8
  prevent_default: true
  swipe_amount: 30

请注意，这只是一个示例配置，您需要根据实际情况进行调整。

hass-swipe-navigation ↔️ Swipe through Home Assistant Dashboard views on mobile. 项目地址: https://gitcode.com/gh_mirrors/ha/hass-swipe-navigation