react-native-router 页面传数据完全指南:data 属性的正确打开方式与常见坑

原创2026-10-13 14:56:341,455 阅读

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 跳转 → 详情页解构使用:

🔍 底层揭秘: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) 它是单向的前进通道,不负责回传

📁 核心文件地图

写在最后

react-native-router 虽已退役,但它"把参数装进路由对象、由 Router 统一转发给页面组件"的设计,与现代 React Navigation 中 route.params 的传参思想一致——今天吃透 data 属性的用法,你学到的不是过时技巧,而是导航传参的底层通用逻辑。

登录后查看全文
react-native-router