React Native Bottom Sheet 组件在 Web 平台的 onDismiss 事件问题解析

问题背景

React Native Bottom Sheet 是一个流行的底部弹窗组件库，开发者在使用过程中发现其 onDismiss 回调在 Web 平台上无法正常触发。本文将深入分析这一问题，并提供解决方案。

核心问题分析

经过技术验证，发现该问题主要涉及以下两个关键点：

1. 组件类型混淆：onDismiss 是 BottomSheetModal 组件的专有属性，而开发者可能在示例中错误地使用了基础的 BottomSheet 组件。这两个组件虽然功能相似，但 API 存在差异。

2. TypeScript 类型定义：在 JavaScript 环境中（如 Expo Snack），如果直接使用 TypeScript 的类型注解会导致运行时错误。正确的做法是在纯 JavaScript 环境中省略类型定义。

解决方案

正确使用组件

开发者应当明确区分两种组件的使用场景：

• BottomSheet：基础底部弹窗组件
• BottomSheetModal：模态弹窗组件，支持 onDismiss 回调

Web 平台适配建议

对于 Web 平台的兼容性问题，建议采取以下措施：

1. 确保使用正确的组件类型（BottomSheetModal）
2. 检查事件绑定是否正确
3. 考虑添加平台特异性代码处理 Web 端的特殊情况

最佳实践示例

import { useRef } from 'react';
import { BottomSheetModal } from '@gorhom/bottom-sheet';

function MyComponent() {
  const bottomSheetRef = useRef(null);

  const handleDismiss = () => {
    console.log('弹窗已关闭');
  };

  return (
    <BottomSheetModal
      ref={bottomSheetRef}
      onDismiss={handleDismiss}
      // 其他属性...
    >
      {/* 内容 */}
    </BottomSheetModal>
  );
}

总结

React Native 跨平台开发中，组件行为在不同平台上的表现可能存在差异。开发者应当：

1. 仔细阅读官方文档，了解组件特性和平台限制
2. 进行充分的跨平台测试
3. 使用条件渲染或平台特异性代码处理差异

通过正确理解组件特性和平台差异，可以避免类似 onDismiss 事件不触发的问题，提升应用的用户体验。