🧭
Route Navigation
push / replace / relaunch / back, auto-detect TabBar, declarative RouterLink
@meng-xi/uni-routeruni-app Router Management
Provide a routing management system for uni-app (Vue 3) that is similar to the style of vue-router
Skip to content
🛡️
Route Guards
Global beforeEach / beforeResolve / afterEach and per-route guards, guardRoute for cold-start execution, InterceptorPlugin intercepts native APIs
📦
Params & Query Enhancement
params for complex data without URL exposure, auto-preserved after back(), queryInt / queryNumber / queryBool convenience methods
📡
Page Communication
events and eventChannel bidirectional communication; useUniEventChannel supports all navigation methods; sticky cache prevents event loss
🧩
Declarative Components
RouterLink navigation + TabBar / TabBarItem custom bottom navigation, SCSS variables and CSS custom properties for theming
🔄
Auto Route State Sync
Global mixin injected at install auto-invokes syncRoute(); App physical back / H5 browser back are intercepted by onBeforeBack, other scenarios auto-sync. No manual sync needed
⚠️
Error Handling
RouterError / NavigationFailure / UniApiError complete system, onError global capture, isNavigationFailure() discrimination
🎬
Navigation Animation
Inline animation params and route-level meta.animation defaults; native window animation on App, CSS transition on H5 for push/back
💪
TypeScript First
Complete type definitions and composables, useRouter / useRoute / usePageChannel / onBeforeRouteLeave / useLink, seamlessly integrate with Vue 3