介绍

Vitarx Router 是为 Vitarx 框架量身打造的新一代路由引擎，将路由从"配置层"提升为"架构层"。它不只是连接页面——它定义了应用的数据流、权限边界和导航契约。

核心特性

• 🚀 声明式路由配置 — defineRoutes() 直观定义路由表，支持嵌套路由、命名视图、动态参数与通配符
• 🛡️ 完善的导航守卫 — 全局前置/后置守卫、路由独享守卫、组件内 onBeforeRouteLeave / onBeforeRouteUpdate，精准控制每一步导航
• 📁 文件系统路由 — 基于 Vite 插件自动扫描页面目录，支持布局路由、命名视图、分组排序、HMR 热更新
• 🔀 三种路由模式 — Hash 模式、History 模式、Memory 模式（SSR / 测试），一行配置切换
• ⚡ 编程式导航 — push / replace / go / back / forward，支持携带参数、查询字符串和哈希
• 🎯 精确的导航结果 — NavigateResult 携带状态码与消息，hasSuccess() / hasState() 让分支逻辑清晰可读
• 🔧 高度可扩展 — 路由元信息、动态参数正则校验、重定向、别名、滚动行为控制、TypeScript 泛型路由类型