基础控制

1. 网页加载Web({ src: '网址', controller: this.webController })src：支持在线URL/本地文件路径（resource://rawfile/）controller：网页控制器（刷新/前进/后退）
2. 导航操作webController.back() 返回上一页webController.forward() 前进webController.refresh() 刷新

网页交互

1. JS注入webController.runJavaScript('alert("Hello")');执行任意JS代码支持异步获取返回值
2. 原生能力注入class JsProxy { showToast(text: string) { // 原生弹窗实现 } } webController.registerJavaScriptProxy(new JsProxy(), 'nativeBridge');H5可通过window.nativeBridge调用原生方法

关键特性

1. 消息端口通信createMessagePort() 创建双向通道postMessage() 跨域通信
2. 权限控制Web({ fileAccess: true, // 启用本地文件访问 domStorageAccess: true // 开启DOM存储 })
3. 事件监听onPageBegin/onPageEnd：页面加载事件onError：加载错误捕获onConfirm：拦截JS弹窗

高级功能

1. 缩放控制Web({ zoomAccess: true, textZoomAtio: 150 // 150%文本缩放 })
2. 缓存管理webController.getWebStorage() 获取存储对象deleteCache() 清除缓存
3. 深色模式适配Web({ darkMode: WebDarkMode.ON // 强制深色模式 })

最佳实践

1. 内存优化：页面不可见时调用webController.clear()释放资源
2. 安全策略：限制fileAccess范围，避免任意文件访问
3. 错误处理：实现onError回调处理网络错误/证书失效
4. 通信规范：JS接口命名添加__native_前缀避免冲突

注意：Web组件需在module.json5声明网络权限："requestPermissions": [{ "name": "ohos.permission.INTERNET" }]