SuperAPI AI 工具集

use-dom

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:DOM 组件让 Web 代码在原生平台上原样运行于 WebView,在 Web 端则原样渲染,从而在 Expo 应用中使用依赖 DOM 的 Web 库,或增量迁移现有 React Web 代码到原生。

主要能力:使用仅 Web 库(图表、语法高亮、富文本编辑器等);复用现有 React Web 组件;使用 React Native 不支持的复杂 HTML/CSS 布局、iframe/嵌入内容、Canvas 或 WebGL;通过 props 传递异步函数,把原生能力(弹窗、存储、数据库等)暴露给 WebView 调用;在 DOM 组件内使用 expo-router 的 Link 与 router API。

使用方式:文件顶部写 “use dom”; 指令;每个文件只放一个默认导出的 React 组件,不能内联定义或与原生组件混写;props 仅支持可序列化值(字符串、数字、布尔、数组、普通对象);CSS 需在组件文件内导入或使用内联/CSS-in-JS;组件接收 dom 属性(类型 import("expo/dom").DOMProps)用于配置 WebView,如 scrollEnabled、contentInsetAdjustmentBehavior、style;资源优先用 require 打包;在原生组件中像普通组件一样导入使用;可用 IS_DOM 检测运行环境。

平台行为:iOS 用 WKWebView,Android 用 WebView,Web 端原样渲染且忽略 dom 属性。

限制:原生性能敏感、简单 UI、需要深度原生集成、_layout 布局路由时不宜使用;useLocalSearchParams、useGlobalSearchParams、usePathname、useSegments、useRootNavigation、useRootNavigationState 等路由钩子需在原生父组件读取后作为 props 传入;WebView 有独立 JS 上下文,无法与原生直接共享状态;大组件可能影响性能;需在全部平台测试。执行前应核对官方文档中的命令、API 行为、配额与部署影响。