React Native Windows中react-native-gesture-handler报HTMLElement未定义错误求助

问题说明 #

基于React Native for Windows工作流配置抽屉导航后，先后触发两个错误：

1. 未添加GestureHandlerRootView时，报错：

'PanGestureHandler must be used as a descendant of GestureHandlerRootView. Otherwise the gestures will not be recognized.'

2. 添加GestureHandlerRootView作为根组件后，react-native-gesture-handler的Windows模块抛出：HTMLElement is not defined

解决方案 #

1. 安装适配Windows的手势处理包版本 #

确保使用的react-native-gesture-handler版本支持Windows平台，优先安装最新稳定版，同步依赖后重启项目：

npm install react-native-gesture-handler@latest
npx react-native run-windows --no-packager

2. 修复HTMLElement未定义的类型错误 #

Windows平台不存在HTMLElement全局类型，需手动添加声明：

• 在项目根目录创建global.d.ts文件，写入：

declare global {
  interface HTMLElement {}
}

export {};

• 检查tsconfig.json的include字段，确保包含该声明文件：

{
  "include": [
    "src/**/*",
    "global.d.ts"
  ]
}

3. 正确嵌套手势根视图与导航容器 #

修改App.jsx，确保GestureHandlerRootView包裹整个应用并设置正确样式：

import 'react-native-gesture-handler';
import React from 'react';
import { Button, Text, View } from 'react-native';
import { NavigationContainer } from '@react-navigation/native';
import { createDrawerNavigator } from '@react-navigation/drawer';
import { GestureHandlerRootView } from 'react-native-gesture-handler';

const Drawer = createDrawerNavigator();

function DetailsScreen({ navigation }) {
  return (
    <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
      <Text style={{ color: 'red' }}>Details Screen</Text>
      <Button
        title="Go to Details... again"
        onPress={() => navigation.push('Details')}
      />
      <Button title="Go to Home" onPress={() => navigation.navigate('Home')} />
      <Button title="Go back" onPress={() => navigation.goBack()} />
    </View>
  );
}

function HomeScreen({ navigation }) {
  return (
    <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
      <Text style={{ color: 'red' }}>Home Screen</Text>
      <Button
        title="Go to Details"
        onPress={() => navigation.navigate('Details')}
      />
    </View>
  );
}

function App() {
  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      <NavigationContainer>
        <Drawer.Navigator initialRouteName="Home">
          <Drawer.Screen name="Home" component={HomeScreen} />
          <Drawer.Screen name="Details" component={DetailsScreen} />
        </Drawer.Navigator>
      </NavigationContainer>
    </GestureHandlerRootView>
  );
}

export default App;

注意：GestureHandlerRootView必须设置style={{ flex: 1 }}以占满整个窗口

4. 清理缓存并重建项目 #

执行以下命令清除缓存，避免旧代码残留影响：

npx react-native start --reset-cache
npx react-native run-windows --clean

内容的提问来源于stack exchange，提问作者Valentin