ammarahm-ed/react-native-actions-sheet

这是什么？

核心功能

• 01一套代码同时支持 Android、iOS 和 Web。
• 02面板内可放置任意 React 内容。
• 03手势和动画在 UI 线程运行。
• 04支持多个吸附点和快速滑动关闭。
• 05提供手势阻挡组件，适配滑块、地图和 WebView。
• 06提供官方 Jest mock 便于测试。

适用场景

• 在 React Native 应用中从底部弹出操作菜单或上下文菜单。
• 构建从底部滑出的选择器或选项面板。
• 在移动端或 Web 中把表单或可滚动列表放进可拖动的抽屉里。

快速上手

1. 1

   安装库

   npm install react-native-actions-sheet
2. 2

   安装所需的依赖项

   npm install react-native-reanimated react-native-worklets react-native-gesture-handler react-native-safe-area-context
3. 3

   按照文档中的安装指南完成详细设置

使用前须知

• !v11 需要 React Native 的新架构；仍使用旧架构的应用必须停留在 v10 版本。
• !依赖多个原生库（reanimated、worklets、gesture-handler、safe-area-context），这些库也必须一并安装。

标签

常见问题

react-native-actions-sheet 是什么？

一个跨平台的 React Native 底部操作面板组件，支持 Android、iOS 和 Web，可自由放置自定义内容。 react-native-actions-sheet 是一个 React Native 底部面板组件，常用于操作菜单、选择器和抽屉式界面。它支持 Android、iOS 和 Web，面板内可以放置任意 React 内容。

react-native-actions-sheet 可以免费使用吗？用的什么许可证？

react-native-actions-sheet 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

react-native-actions-sheet 还在维护吗？

活跃维护中。react-native-actions-sheet 最近一次提交是在 2026年10月18日。

react-native-actions-sheet 适合用来做什么？

在 React Native 应用中从底部弹出操作菜单或上下文菜单。 构建从底部滑出的选择器或选项面板。 在移动端或 Web 中把表单或可滚动列表放进可拖动的抽屉里。

react-native-actions-sheet 怎么安装和运行？

安装库: npm install react-native-actions-sheet 安装所需的依赖项: npm install react-native-reanimated react-native-worklets react-native-gesture-handler react-native-safe-area-context 按照文档中的安装指南完成详细设置

在哪里获取 react-native-actions-sheet？

源代码和安装说明在 GitHub 上：https://github.com/ammarahm-ed/react-native-actions-sheet