react-native-router 页面传数据完全指南:data 属性的正确打开方式与常见坑
react-native-router 页面传数据完全指南:data 属性的正确打开方式与常见坑
react-native-router 是一个为 React Native 提供导航栏式页面跳转的早期开源路由库,其 data 属性正是页面传数据的官方通道。本文用 3 个步骤讲清 data 的正确打开方式,并逐一拆解 4 个新手高频踩坑点,帮你一次写对跨页面传参。
⚠️ 提示:该项目 README 已标注 deprecated(新官方推荐 React Navigation)。但如果你维护老项目、或想研究经典路由实现,这套传参机制依然值得掌握——它的思路和现代导航库一脉相承。
🧭 30 秒上手:页面传数据 3 步流程
| 步骤 | 位置 | 做什么 |
|---|---|---|
| ① 发起页 | 你调用的组件 | this.props.toRoute() 时,在路由对象里带上 data |
| ② 路由内部 | Router 自动完成 | 路由对象(含 data)被推入 Navigator 导航栈 |
| ③ 目标页 | 被打开的组件 | 直接读取 this.props.data |
第 1 步:跳转时携带 data
this.props.toRoute({
name: 'Detail', // 导航栏标题
component: DetailPage, // 必填,目标页面组件
data: { id: 42, title: 'Hello' } // 要传给目标页的数据
});
第 2 步:路由层转发(无需你操心)
toRoute 触发后,Router 会把整个路由对象 navigator.push(route) 压入导航栈,data 随路由一起走。核心逻辑见 index.js#L54-L57。
第 3 步:目标页接收
var { id, title } = this.props.data;
官方 Twitter 示例就是一条完整的传数据链路:列表页点击 → 携带 data 跳转 → 详情页解构使用:
- 列表项冒泡上报:Tweet.js#L16-L18
- HomePage 发起跳转并携带数据:HomePage.js#L39-L45
- 详情页 TweetBig 解构
this.props.data:TweetBig.js#L13-L19
🔍 底层揭秘:data 到底从哪来?
关键认知:data 不是父组件传给子组件的 prop,而是路由对象上的一个字段,由 Router 读取后转发。Router 的 renderScene 会为每个页面组件统一注入一组固定 props(见 index.js#L110-L118):
| 注入的 prop | 含义 |
|---|---|
name |
路由标题(导航栏显示) |
index |
当前页面在导航栈中的层级 |
data |
你跳转时传入的 data,原样送达 |
toRoute / toBack / reset |
前进 / 返回 / 回首页 |
customAction |
自定义动作回调(如触发侧边菜单) |
也就是说,"传数据" = 在跳转时的路由对象里写上 data 字段,Router 负责把它 data={route.data} 送达目标页面。
⚠️ 新手必踩的 4 个常见坑
坑 1:toRoute 只存在于顶层路由组件
这是新手第一大坑。toRoute 只会注入到 Router 直接渲染的顶层页面组件上。列表项、按钮等嵌套在页面深处的子组件拿不到这个 prop,必须在页面里声明:toRoute() 需要由顶层路由组件调用。
官方示例的解法值得抄作业:子组件(Tweet.js)不直接导航,而是通过回调 goToTweet 把数据冒泡给父页面,由父页面统一调用 toRoute。
坑 2:不传 data,目标页的 this.props.data 是 undefined
data 是可选字段(component 才是必填)。Router 不会给它兜底值,忘传时目标页读到的就是 undefined。建议目标页做防御式读取:
var data = this.props.data || {};
坑 3:想当然地"直接给目标组件传参数"
很多初学者的写法是以为可以给 <DetailPage someProp={...} /> 附加参数——不行的。这套路由中组件由 Router 代为渲染,组件的 props 完全由 Router 注入(见上文表格),你唯一能控制的数据入口就是路由对象里的 data。记住:data 是唯一的参数通道。
坑 4:data 是"活引用",不是快照拷贝
data 传的是对象引用而非深拷贝。目标页一旦修改 this.props.data 里的字段,导航栈上的路由对象、以及仍持有同一引用的源页面都会同步变化。纯展示场景没问题;若数据会被修改,传一份拷贝更稳妥:
data: Object.assign({}, this.state.user)
💡 附赠两个进阶细节
- 首屏也能收数据:
firstRoute同样支持data字段,初始页面一样能通过this.props.data拿到参数。示例见 twitter-example/index.js#L25-L29 - 返回不丢数据:路由对象常驻导航栈,每页的
data和内部状态在返回(pop)时都原样保留
✅ 传数据最佳实践清单
| 实践 | 原因 |
|---|---|
参数放进路由对象的 data,别绕道全局变量 |
数据随导航栈天然保存、随页面生命周期走 |
目标页用 this.props.data || {} 防御式读取 |
防止忘传 data 时页面崩溃 |
| 可变的复杂对象传拷贝 | 引用语义会导致跨页面意外修改 |
| 导航动作统一冒泡到顶层路由组件 | 嵌套组件没有 toRoute |
data 只用于"前进传参",全应用共享状态另找方案(如全局 store) |
它是单向的前进通道,不负责回传 |
📁 核心文件地图
- index.js — Router 主逻辑,
data注入与导航栈管理都在这 - components/NavBarContainer.js — 导航栏容器,负责新旧导航栏切换
- components/NavBarContent.js — 导航栏内容与淡入动画
- components/NavButton.js — 返回按钮
- twitter-example/ — 完整示例应用(含上述传数据链路)
- README.md — 官方文档,
toRoute参数说明
写在最后
react-native-router 虽已退役,但它"把参数装进路由对象、由 Router 统一转发给页面组件"的设计,与现代 React Navigation 中 route.params 的传参思想一致——今天吃透 data 属性的用法,你学到的不是过时技巧,而是导航传参的底层通用逻辑。