如果你每天都在手机上打开 Home Assistant，看一眼客厅温度、再切到卧室灯光、又想去安防视图确认门窗状态，点顶部视图标签来回切其实并不顺手。Home Assistant Swipe Navigation 就是为这个场景准备的滑动导航插件：它不改动你已有的 Lovelace 仪表盘结构，只在上面加一层左右滑动切换视图的能力，让手机上的仪表盘用起来更像一个顺手的遥控面板。
信息一览与滑动导航定位
| 项目 | 内容 |
|---|---|
| 软件名 | Home Assistant Swipe Navigation |
| 版本 | 原文未标注具体版本号，以项目发布页为准 |
| 平台 | Home Assistant Dashboard，面向手机与触摸设备 |
| 核心功能 | 在仪表盘视图之间左右滑动切换，支持动画切换、跳过指定视图、循环导航 |
| 适合场景 | 手机上快速在不同房间、安防、能耗等视图之间切换 |
先说清它的身份，避免装错地方。Home Assistant Swipe Navigation 不是一个独立 App，也不是一个新的仪表盘，它是跑在 Home Assistant Dashboard 里面的前端模块。你仍然用原来的 Home Assistant 应用或浏览器打开仪表盘，只是在此基础上多了一个手势：手指左右一划，视图就跟着换过去。对已经搭好 Home Assistant、并且仪表盘视图已经分好房间或功能的人来说，这个插件属于锦上添花，而不是从零搭建。
它的做法也比较克制。插件监听触摸滑动手势，再按你的配置决定要不要切换、切换到哪一个视图、切换时是否带动画。遇到滑块、地图这类本身就需要拖动操作的元素，它会主动让路，不抢手势，这一点在日常使用里很重要，否则调灯光亮度时一划就跳视图，反而添乱。
版本选择：HACS 安装与手动资源安装怎么选
原文给出的安装路线有两条，本质上装的是同一个插件，差别只在资源怎么登记、后续怎么维护。第一次接触 Home Assistant 前端资源的人，建议优先走 HACS 路线；已经在用 YAML 模式管理仪表盘、并且习惯自己放文件的人，可以走手动资源路线。无论选哪一条，都只能二选一，不要两条路线同时上，否则容易出现资源重复登记、行为难以排查的问题。
另外还有一个迁移前提必须先确认：如果你以前装过原始的 maykar 出品的同类滑动插件，装 Home Assistant Swipe Navigation 之前要先把旧插件卸载掉。两个同类插件不能共存，共存时手势可能互相干扰，出问题也很难定位到是哪一个在起作用。先清旧插件，再装新插件，这个顺序不要反。
安装步骤：从添加到资源生效
- 先确认你的 Home Assistant 已经可以正常打开 Dashboard，并且视图划分已经完成，滑动导航只是锦上添花，不负责帮你整理视图。
- 走 HACS 路线时，在 HACS 里找到 Home Assistant Swipe Navigation 并完成安装，安装后 HACS 会自动完成 Dashboard 资源的登记，接下来按提示刷新页面即可。
- 走手动路线时，把 swipe-navigation.js 放到 Home Assistant 的 www 目录下对应文件夹中，例如原文给出的 hass-swipe-navigation 目录，然后在 Dashboard 的资源设置里以 JavaScript module 类型登记这个文件。
- 登记完成后刷新 Dashboard 页面，如果页面表现没有变化，先清理浏览器缓存再刷新一次，手动路线尤其容易卡在这一步。
- 在真实手机上左右划几下，确认视图确实按预期切换，再去调后面的细节设置，不要只在电脑浏览器里用鼠标拖动来验收，因为鼠标滑动默认是关闭的。
必改设置：滑动距离、跳过视图与循环导航
装好只是第一步，真正决定好不好用的，是下面这几项设置。建议按顺序逐项确认，而不是全部保持默认就直接投入日常使用。
- 滑动触发距离：决定手指要划多远才算一次切换。划得太短容易误触，划得太长又会觉得费力，建议在常用手机上实测几次，找到既不容易误触、又不用刻意用力的距离。
- 跳过视图：有些视图只是调试或临时展示用，并不想在日常滑动序列里出现，可以把它加入跳过名单，滑动时直接越过它，日常动线更干净。
- 循环导航：开启后从最后一个视图继续右划会回到第一个视图，适合视图数量不多、经常来回巡视的人；视图很多时可以先关掉，避免一不小心划回起点。
- 导航总开关与子视图滑动：总开关用来在需要时整体停用滑动导航；子视图滑动则决定进入某个视图的下级视图后，滑动行为是否继续生效，两项都要按自家仪表盘结构单独确认。
- 鼠标滑动：默认关闭，只在确实需要在电脑浏览器里也用滑动时才显式开启，手机为主的使用场景没有必要开它。
- 实验性滑动动画：动画能让切换看起来更连贯，但原文明确标注它属于实验性选项，不同设备上的表现可能不一致，建议先开后在目标手机上验证，表现不稳就先关掉动画、只保留切换本身。
注意事项：实验动画与手势冲突先验证
- 实验性动画要先在主力手机上验证，不要只在备用机或模拟环境里看一眼就全量开启，动画在不同机型、不同浏览器里的表现可能差别很大。
- 不能与原始同类插件共存，迁移前先卸载旧插件，装完新插件后再检查资源列表里是否只剩一个滑动导航资源。
- 手动安装后如果滑动没有生效，优先排查资源登记类型是否选对、文件路径是否放对，其次再刷新页面或清理缓存，不要反复重装。
- 家里有从右向左阅读语言使用需求的人，要单独验证 RTL 布局下的滑动方向是否符合直觉，方向反了会让全家人都觉得别扭。
- 仪表盘里滑块、地图这类可拖动卡片较多的视图，要逐个视图划一遍，确认调亮度、拖地图时不会误触发视图切换。
- 升级或改动 Dashboard 配置后，要重新确认资源是否正确加载、各项设置是否还在，配置变动有时会让前端资源表现发生变化。
适用人群与对比：它适合谁、不适合谁
最适合的人，是已经在用 Home Assistant Dashboard、并且主要在手机或触摸设备上看仪表盘的人。比如家里视图按房间分好，每天都要在客厅、卧室、安防之间来回看的人，左右一划就能换视图，比每次都去点顶部小标签更顺手。负责维护家里仪表盘配置的人也适合，因为这个插件的设置都围绕视图顺序、跳过名单和滑动距离展开，改动成本低，不用重排整个仪表盘。
相对不适合的场景也有几种。如果你的仪表盘主要在电脑大屏上用鼠标操作，滑动导航的收益就很有限，鼠标滑动默认关闭也说明它本来就不是为桌面端设计的。如果你的仪表盘只有一个视图，或者视图之间很少来回切换，装它也不会带来明显变化。还有一种情况是仪表盘里大量卡片本身就需要横向拖动，滑动导航会增加手势冲突的排查成本，这时要先在真实设备上验证，再决定是否全量使用。
和只靠点顶部视图标签的操作方式对比，滑动导航的优点是单手操作快、动线连续，缺点是需要花一点时间调触发距离和跳过名单，否则容易误触。和重新设计一套仪表盘导航相比，它的优点是不动原有结构、改动小，缺点是它只解决视图切换这一个环节，不会帮你整理卡片布局或房间划分。定位清楚这一点，就不会对它有超出范围的期待。
版本对比表：两种安装方式对照
| 对照项 | HACS 安装 | 手动资源安装 |
|---|---|---|
| 适合人群 | 第一次接触前端资源、希望少走手动登记步骤的人 | 已用 YAML 模式管理仪表盘、习惯自己放文件的人 |
| 资源登记 | 由 HACS 自动完成 Dashboard 资源登记 | 需自己把文件放入 www 目录并以 JavaScript module 类型登记 |
| 上手难度 | 较低，步骤少，出错点也少 | 较高，路径、类型、缓存任一环节出错都会导致不生效 |
| 后续维护 | 集中管理，改动时便于统一处理 | 自行替换文件并重新确认资源加载情况 |
| 共同前提 | 只能二选一，且迁移前要先卸载原始同类插件；装完都要在真实手机上实测滑动、跳过视图和手势冲突 | |
总的来看，Home Assistant Swipe Navigation 的价值不在功能堆得多，而在把手机上看仪表盘这件每天重复很多次的小事做顺：划一下换视图、跳过不常用的视图、划到头可以循环回来，再加上对滑块、地图和 RTL 布局的让路处理。如果你已经有 Home Assistant、仪表盘视图也分得清楚，它值得花半小时装好并调好触发距离；如果你还在搭建仪表盘初期，先把视图和房间划分做扎实，再回头加滑动导航也不迟。
关注公众号「软件教程管家」，回复【Home Assistant Swipe Navigation】获取下载链接
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
