react-native-true-sheet
React Native 高性能原生底部弹窗组件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：react-native-true-sheet。 它的用途是：React Native 高性能原生底部弹窗组件 完整的 Skill 内容见：https://321skill.com/skills/react-native-true-sheet/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用 React Native TrueSheet 写一个简单的底部弹窗示例，包含打开和关闭按钮。” 它会生成包含 `TrueSheet` 组件导入、`useRef` 引用、以及 `present` 和 `dismiss` 方法的完整代码片段，展示如何以命令式API控制弹窗的显示与隐藏。
介绍
React Native TrueSheet 是一个专为 React Native 应用设计的底部弹窗组件，旨在解决传统 JS 实现的弹窗性能不佳、交互不流畅、平台适配复杂的问题。它完全基于 React Native 的新架构（Fabric）在原生层实现，提供了与 iOS 和 Android 原生系统高度一致的丝滑弹窗体验，包括对键盘、屏幕阅读器、侧边栏（平板）以及 iOS 26+ 液态玻璃特效的原生支持。
使用方式非常灵活，开发者既可以通过声明式的 React 组件来定义弹窗内容，也可以调用其提供的丰富 API 进行命令式控制，例如以编程方式打开或关闭弹窗，并监听其生命周期事件。组件支持与 React Navigation 深度集成，可以作为导航器使用，同时也完美兼容 react-native-reanimated 以实现复杂的交互动画。
这个组件非常适合追求极致用户体验和性能的 React Native 开发者，尤其是在开发需要频繁使用弹窗进行交互（如信息展示、表单填写、菜单选择）的移动应用时。对于使用 Expo 或裸 React Native 项目，且已启用新架构的团队来说，它是构建现代化、高性能弹窗交互的理想选择。
与市面上其他 React Native 弹窗库（如 react-native-bottom-sheet）相比，TrueSheet 的核心优势在于其“完全原生”的实现。它并非在 JavaScript 线程进行布局和动画模拟，而是直接调用原生平台的 UI 组件和动画系统，这带来了零延迟的响应、完美的平台原生交互手感（如惯性滚动、边缘拖拽）以及更低的 CPU/内存消耗，尤其在复杂列表或动画场景下优势明显。
核心特点
核心区别在于其完全基于 React Native 新架构（Fabric）在原生层实现，而非 JavaScript 层的模拟，这带来了与 iOS/Android 系统原生组件无异的性能、手势和视觉体验，尤其在流畅度和资源消耗上优势显著。
注意事项
需要项目启用 React Native 的新架构（Fabric），对于仍在使用旧架构的项目，只能使用其 2.x 版本，且无法获得最佳性能。
常见问题
React Native TrueSheet 支持旧架构吗？
3.0+ 版本仅支持新架构（Fabric），旧架构项目需使用 2.x 版本。
TrueSheet 和 react-native-bottom-sheet 哪个好？
TrueSheet 是完全原生的实现，性能、手势和平台一致性更好；react-native-bottom-sheet 则更成熟、社区更大，但基于 JS 驱动。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/react-native-true-sheet/raw/index.md 读取 react-native-true-sheet 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/react-native-true-sheet/raw/index.md（查看排版版本）