Vue 路由传参的四种方式

在单页应用里,路由是连接页面与数据的桥梁。Vue Router 提供了四种方式把「参数」从地址栏、内存甚至编译期注入到组件。理解它们的差异,才能在面试和线上故障中游刃有余。

一、路径参数

把参数写进路径,直观且 SEO 友好。

js 复制代码
// router.js
{ path: '/user/:userId', component: User }

访问 /user/42,组件内部:

ts 复制代码
const route = useRoute()
console.log(route.params.userId) // '42'
  • 优点:可收藏、可分享、可被搜索引擎收录。
  • 注意:使用正则捕获可限制类型,如 :userId(\\d+) 只接受数字。

二、查询参数

问号后的 key=value 对,天然支持多值与可选。

ts 复制代码
router.push({ path: '/user', query: { id: 42, tab: 'profile' } })

组件读取:

ts 复制代码
const route = useRoute()
console.log(route.query.tab) // 'profile'
  • 场景:分页、筛选、弹窗状态。
  • 陷阱:刷新页面后仍然存在,敏感信息需加密。

三、路由状态参数

state 不会出现在 URL,适合临时或敏感数据。

ts 复制代码
router.push({ path: '/confirm', state: { orderId: 'xxx' } })

组件读取:

ts 复制代码
import { useHistoryState } from '@vueuse/core'
console.log(history.state.orderId) // 'xxx'
  • 特性:刷新即消失,同源安全;常用于「下一步」导流。
  • 限制:SSR 场景下为空,因为服务端没有浏览器 history。

四、路由 Props

把路径或查询自动映射为组件 Props,告别 $route 依赖。

js 复制代码
{ path: '/user/:id', component: User, props: true }

组件直接:

vue 复制代码
<script setup>
const props = defineProps(['id'])
</script>
  • 进阶:传入函数可实现自定义映射,如把查询映射为对象。
  • 测试:单元测试无需 mock $route,直接传 Props。

总结

路径参数让 URL 会说话,查询参数让 URL 会传表,状态参数让内存做快递,Props 让组件零耦合。掌握四种姿势,Vue 路由从此游刃有余。

相关推荐
Flynt5 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
一个游离的指针7 小时前
Vue2:vue-router
前端·javascript·vue.js
用户4514194293229 小时前
2026 Vue 生态分析:底层重写了一遍,升级却几乎零成本
vue.js
火山引擎和TA的超级拍档们10 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide10 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
niceyayale10 小时前
WebRTC 延迟怎么调试:从 ICE 到 jitter buffer 的六个观测点
前端
aleimu10 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
tryCbest10 小时前
Vue系列——第 20 篇:Vue Router 4——路由管理完全指南(上)
前端·javascript·vue.js
feixing_fx10 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
一条破秋裤11 小时前
【1115】【多线程】【笔记】
前端·chrome·笔记