You need to enable JavaScript to run this app. React Navigation中如何正确定义接收导航传参的组件Props类型
优惠活动
大模型
产品
解决方案
定价
更多

React Navigation中如何正确定义接收导航传参的组件Props类型

报错原因
  • 类型映射断裂:你定义RootStackParamList时用硬编码字符串当键,但给StackScreenProps传入的第二个泛型是NavigationLocations.SHEET,TS找不到这个枚举值和ParamList键的对应关系,根本没法推断该路由对应的params类型,自然识别不到sheet属性。
  • 取值逻辑错误:StackScreenProps本身只暴露navigation、route两个对象,路由传参是挂在route.params下的,你之前直接从Props顶层解构sheet,不管类型对不对,运行时根本取不到值。
修复方案
  1. 打通枚举和参数类型的映射
    首先确认NavigationLocations是字符串枚举(React Navigation的路由名默认是字符串,数字枚举无法适配),例如定义应为:
    enum NavigationLocations {
      SIGNUP = 'Signup',
      LOGIN = 'Login',
      DASHBOARD = 'Dashboard',
      SHEET = 'SheetView'
    }
    
    随后把RootStackParamList的硬编码键替换为枚举的计算属性,让TS能自动建立枚举值和参数类型的绑定:
    export type RootStackParamList = {
      [NavigationLocations.SIGNUP]: undefined,
      [NavigationLocations.LOGIN]: undefined,
      [NavigationLocations.DASHBOARD]: undefined,
      [NavigationLocations.SHEET]: { sheet: ISheet }
    };
    
  2. 修正组件内的参数读取逻辑
    原有StackScreenProps的定义方式无需改动,只要映射关系打通,TS就能自动推断出该路由下route.params包含sheet字段。正确的组件写法:
    type Props = StackScreenProps<RootStackParamList, NavigationLocations.SHEET>
    
    // 解构嵌套的route对象读取参数
    export default function Sheet({ route }: Props) {
      const { sheet } = route.params;
    
      // 业务逻辑...
    }
    
    如果你更习惯接收完整props,也可以写成:
    export default function Sheet(props: Props) {
      const { sheet } = props.route.params;
    }
    
注意事项
  • 不要试图从Props顶层直接解构业务参数,React Navigation注入的组件Props结构是固定的,所有跨页传递的参数都存放在route.params下。
  • 用枚举做路由名时,一律使用字符串枚举,不要用数字枚举,否则会和React Navigation的字符串路由机制产生兼容问题。

内容的提问来源于stack exchange,提问作者Faire

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 19:54:02