文档开发者中心
我的
|

React Native

HarmonyOS 5

优化建议-@react-native-ohos/react-native-draggable-flatlist三方库文档的demo无法使用

已解决
【问题描述】:@react-native-ohos/react-native-draggable-flatlist三方库文档的demo无法使用,文档地址:https://gitcode.com/OpenHarmony-RN/usage-docs/blob/master/zh-cn/react-native-draggable-flatlist.md

【问题现象】:运行文档提供的demo时报错:GestureDetector must be used as a descendant of

GestureHandlerRootView. 给 DraggableFlatList 外层加上手势库的 GestureHandlerRootView 组件后问题解决。

​cke_533.png

【版本信息】:

@react-native-oh/react-native-harmony: 0.72.133

@react-native-ohos/react-native-draggable-flatlist: 4.0.4

【复现代码】:参考文档demo:https://gitcode.com/OpenHarmony-RN/usage-docs/blob/master/zh-cn/react-native-draggable-flatlist.md#1-%E5%AE%89%E8%A3%85%E4%B8%8E%E4%BD%BF%E7%94%A8

​

点赞
1
收藏
回复
4
分享
举报
浏览115 发布于2026-04-24 09:41湖北
全部评论
最多点赞
最新发布
最早发布
|
采纳答复
5楼回复于2026-05-14 09:28 来自广东

这个报错其实已经把根因说出来了:react-native-gesture-handler 的手势组件没有处在 GestureHandlerRootView 下面。react-native-draggable-flatlist 底层会用到 GestureDetector / 拖拽手势,所以示例里如果少了这一层 root,就会直接报这个错。

建议不要只在很内层临时包一下,而是在页面或 RN 应用入口的外层包:

收起
自动换行
深色代码主题
复制
import { GestureHandlerRootView } from 'react-native-gesture-handler';

export default function Page() {
  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      <DraggableFlatList
        data={data}
        renderItem={renderItem}
        keyExtractor={(item) => item.id}
        onDragEnd={({ data }) => setData(data)}
      />
    </GestureHandlerRootView>
  );
}

如果页面里还有 Modal、Portal、嵌套路由或跨页面容器,也要确认拖拽列表最终仍然在同一个 GestureHandlerRootView 树下。之后再检查 @react-native-ohos/react-native-draggable-flatlist、react-native-gesture-handler、react-native-reanimated 的版本是否匹配,并清理缓存后重编译。这个文档 demo 最好补充这层 root,否则新工程照抄确实容易踩坑。

4楼回复于2026-05-09 00:38 来自四川
尊敬的开发者,您好!感谢您的反馈,问题正在加速处理中,还请关注后续版本,感谢您的理解与支持。
3楼回复于2026-05-08 06:34 来自广东
View不支持手势操作,需要使用GestureHandlerRootView才支持,建议联系官方修改
1楼回复于2026-04-27 07:36 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。