React Navigation中如何正确定义接收导航传参的组件Props类型
报错原因
- 类型映射断裂:你定义
RootStackParamList时用硬编码字符串当键,但给StackScreenProps传入的第二个泛型是NavigationLocations.SHEET,TS找不到这个枚举值和ParamList键的对应关系,根本没法推断该路由对应的params类型,自然识别不到sheet属性。 - 取值逻辑错误:
StackScreenProps本身只暴露navigation、route两个对象,路由传参是挂在route.params下的,你之前直接从Props顶层解构sheet,不管类型对不对,运行时根本取不到值。
修复方案
- 打通枚举和参数类型的映射
首先确认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 } }; - 修正组件内的参数读取逻辑
原有StackScreenProps的定义方式无需改动,只要映射关系打通,TS就能自动推断出该路由下route.params包含sheet字段。正确的组件写法:
如果你更习惯接收完整props,也可以写成:type Props = StackScreenProps<RootStackParamList, NavigationLocations.SHEET> // 解构嵌套的route对象读取参数 export default function Sheet({ route }: Props) { const { sheet } = route.params; // 业务逻辑... }export default function Sheet(props: Props) { const { sheet } = props.route.params; }
注意事项
- 不要试图从Props顶层直接解构业务参数,React Navigation注入的组件Props结构是固定的,所有跨页传递的参数都存放在
route.params下。 - 用枚举做路由名时,一律使用字符串枚举,不要用数字枚举,否则会和React Navigation的字符串路由机制产生兼容问题。
内容的提问来源于stack exchange,提问作者Faire
相关产品推荐
相关产品推荐

