kux-router 新版全面重构，uts生态最好用最灵活最具特色的路由库 - 更新日志

1.1.2（2024-04-19）

• 修复编译web端时无法自动生成 pagesJsonRouter.uts 的问题。

1.1.1（2024-04-18）

• 【重要】底层全面重构，API设计完全对齐 vue-router，基于 uniapp x 的跨平台原生特色新增诸多方便灵活的属性和方法。
• 【重要】适配兼容ios平台。
• 【新增】全局导航守卫支持同时设置多个，包括 beforeEach、afterEach 导航守卫方法。
• 【新增】to 和 from 路由属性新增 data 字段，用来支持路由隐式传参。
• 【新增】RouteLocationNormalizedLoaded 规范化路由信息新增 data 字段，用来接收路由隐式传参。
• 【新增】to 和 from 路由属性新增 fullPath 字段，用来显示当前路由页面带参数的完整地址，如：/pages/user/info?id=1
• 【新增】RouteLocationNormalizedLoaded 规范化路由信息新增 name 字段，用来显示路由名称或者页面地址别名。
• 【调整️】fullUrl 属性将被废弃，由 fullPath 属性替代。
• 【新增】RouteRecordNormalized 创建路由表时的路由信息对象参数新增 startupIntercept 用来支持开启启动拦截，该参数为 true 时，应用启动时路由守卫就会立即挂载。常用于 首页未登录拦截 场景。

• 【新增】RouteRecordNormalized 创建路由表时的路由信息对象参数新增 animationType 参数，用来支持路由跳转时窗口显示的动画类型。动画类型参数参考下面说明。

  • auto: 自动选择动画效果
  • none: 无动画效果
  • slide-in-right: 从右侧横向滑动效果
  • slide-in-left: 左侧横向滑动效果
  • slide-in-top: 从上侧竖向滑动效果
  • slide-in-bottom: 从下侧竖向滑动效果
  • fade-in: 从透明到不透明逐渐显示效果
  • zoom-out: 从小到大逐渐放大显示效果
  • zoom-fade-out: 从小到大逐渐放大并且从透明到不透明逐渐显示效果
  • pop-in: 从右侧平移入栈动画效果

  提示

  该属性效果暂时需 uniapp x 官方同步支持。

• 【新增】RouteRecordNormalized 创建路由表时的路由信息对象参数新增 animationDuration 参数，用来支持窗口显示动画的持续时间，单位为毫秒。

  提示

  该属性效果暂时需 uniapp x 官方同步支持。

• 【新增】useRouter 和 createRouter 实例新增 options 属性，可以获取创建路由实例时的原始选项参数。
• 【调整️】afterEach 和 beforeEach 导航守卫新增返回可以移除自身的函数，调用后可以移除该导航守卫。
• 【新增】useRouter 和 createRouter 实例新增 removeBeforeEach 方法用来移除所有的 beforeEach 守卫。
• 【新增】useRouter 和 createRouter 实例新增 onError 方法，用来添加一个错误处理器，它会在每次导航遇到未被捕获的错误出现时被调用。其中包括同步和异步被抛出的错误、在任何导航守卫中返回或传入 next 的错误、尝试解析一个需要渲染路由的异步组件时发生的错误。
• 【调整️】push 方法参数类型调整为一个参数，可支持多种参数类型。
  • push (to: RouteRecordName): Promise<NavigationFailure | null>
  • push (to: RouteRecordNormalized): Promise<NavigationFailure | null>
• 【新增】useRouter 和 createRouter 实例新增 replace 方法，程序式地通过替换历史栈中的当前记录来导航到一个新的 URL。参数类型为一个参数，可以支持多种参数类型。
  • replace (to: RouteRecordName): Promise<NavigationFailure | null>
  • replace (to: RouteRecordNormalized): Promise<NavigationFailure | null>
• 【新增】useRouter 和 createRouter 实例新增 reLaunch 方法，关闭所有页面，打开到应用内的某个页面。参数类型为一个参数，可以支持多种参数类型。
  • reLaunch (to: RouteRecordName): Promise<NavigationFailure | null>
  • reLaunch (to: RouteRecordNormalized): Promise<NavigationFailure | null>
• 【新增】useRouter 和 createRouter 实例新增 switchTab 方法，跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面。参数类型为一个参数，可以支持多种参数类型。
  • switchTab (to: RouteRecordName): Promise<NavigationFailure | null>
  • switchTab (to: RouteRecordNormalized): Promise<NavigationFailure | null>
• 【新增】useRouter 和 createRouter 实例新增 resolve 方法，用来返回一个路由地址的规范化路由信息。

1.1.0（2024-04-18）

• 【重要

1.0.2（2024-03-23）

• 补全类和函数类型签名

  说明

  HBuilderX 版本 4.0 及以上才支持。

• 修复因官方调整带来的已知问题。

• 废除自定义的 Page 类型，通过判断uni编译器版本解决不同版本兼容问题。

1.0.1（2024-01-30）

适配web版本【hbx4.0及以上版本支持】

1.0.0（2023-12-20）

初始发布