让页面切换，也成为体验的一部分｜uni-app x 原生路由插件

让每一次进入与返回，都自然衔接。

kongbai-native-route 原生路由 现已上线。

面向 uni-app x · iOS / Android，把页面转场、手势返回与弹窗交互放进同一套导航体验。打开详情时的层次、滑动返回时的反馈、收起面板后的衔接，都可以做得更细腻。

前往插件市场 · 查看详情与试用

先看真机，再感受细节

动画有没有合适的节奏，拖动与回弹是否自然，实际操作最直观。

观看 iOS 真机演示

观看 Android 真机演示

也可以从插件市场导入示例项目，在自己的设备上体验。

01 / 九种转场，让内容有自己的出场方式

日常页面，轻快进入；重点内容，适当强调层次。根据页面的用途选择转场，让动效服务于内容。

横向滑动 · 景深推进 · 层叠上浮
斜向旋入 · 立体翻转 · 中心展开
交叉淡入 · 顶部落入 · 纵向翻入

进入与返回的动画时长可以按需调整，也支持无动画切换。从列表到详情，从浏览到编辑，为不同操作安排合适的节奏。

02 / 跟手返回，把选择留在手指之间

从页面左侧边缘滑动，页面跟随手势响应。完成滑动，返回上一页；中途取消，回到当前页面。

对于仍保留在导航流程中的上一页，返回后可以继续之前的输入与浏览位置。看完详情接着浏览，临时查看其他内容后继续填写，让操作保持连贯。

03 / 三种弹窗，承接不同分量的内容

半屏 · 先展示重点，再展开更多

支持半屏与展开状态切换，以及下拉关闭。适合筛选条件、选项面板、内容预览和轻量编辑，让用户在当前场景中完成操作。

遮罩 · 聚焦眼前这一步

适合信息提示、操作确认与短内容展示。示例提供点击空白区域关闭的交互，用清晰的前后层次突出当前内容。

卡片 · 展开一段独立的操作

拖动顶部区域，卡片随手势变化；松手后，根据操作关闭或回弹。适合详情预览与临时操作面板，让展开和收起都有自然的反馈。

弹窗支持多层打开、逐层返回。 关闭上层后，可以继续操作仍打开的下层内容，保留其中已输入的文字与当前状态。

04 / 深浅外观，与应用保持协调

支持浅色与深色外观切换，覆盖导航栏和弹窗的相关外观，示例项目可直接体验两种主题。

接入业务时，再配合页面自身的文字、背景与组件配色，让导航和内容保持统一。

从示例开始，把体验带进自己的项目

使用 HBuilderX 5.26 + VDOM 打开示例项目，编译原生插件并运行到 iOS 或 Android 真机，即可体验页面转场、手势返回、弹窗与主题切换。

插件市场已提供完整接入说明，包含项目配置、业务页面注册、启动导航、页面跳转与返回。按文档接入后，应用可在启动页就绪时自动进入业务首页。

当前适用于 uni-app x 的 iOS / Android App，暂不支持普通 uni-app、Web、小程序、HarmonyOS 和 Vapor。 平台环境与系统版本要求请查看插件市场说明；两端的手势与外观细节请结合对应演示体验。页面关闭或应用重启后的数据保存，仍由业务自行处理。

把页面之间的衔接，也认真做好。

如果你正在打磨 uni-app x App 的交互细节，欢迎先看演示，再用示例项目体验。

查看 kongbai-native-route 原生路由 · 获取插件与接入文档 →

欢迎在评论区交流使用场景与体验建议。