鸿蒙5.0开发进阶：ArkTS组件-元服务（AtomicServiceWeb）

本文链接：https://blog.csdn.net/Androidbye/article/details/145655118

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

AtomicServiceWeb

为开发者提供满足定制化诉求的Web高阶组件，屏蔽原生Web组件中无需关注的接口，并提供JS扩展能力。

说明

该组件从API Version 12开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

示例效果请以真机运行为准，当前DevEco Studio预览器不支持。

需要权限

访问在线网页时需添加网络权限：ohos.permission.INTERNET。

导入模块

import { AtomicServiceWeb } from '@kit.ArkUI';

子组件

无

属性

不支持通用属性

AtomicServiceWeb

AtomicServiceWeb({
  src: ResourceStr,
  controller: AtomicServiceWebController,
  navPathStack?: NavPathStack,
  mixedMode?: MixedMode,
  darkMode?: WebDarkMode,
  forceDarkAccess?: boolean,
  onMessage?: Callback<OnMessageEvent>,
  onErrorReceive?: Callback<OnErrorReceiveEvent>,
  onHttpErrorReceive?: Callback<OnHttpErrorReceiveEvent>,
  onPageBegin?: Callback<OnPageBeginEvent>,
  onPageEnd?: Callback<OnPageEndEvent>,
  onControllerAttached?: Callback<void>,
  onLoadIntercept?: Callback<OnLoadInterceptEvent, boolean>,
  onProgressChange?: Callback<OnProgressChangeEvent>
})

装饰器类型：@Component

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

名称	类型	必填	装饰器类型	说明
src	ResourceStr	是	-	网页资源地址，访问网络资源需要在AGC配置业务域名，访问本地资源仅支持包内文件（$rawfile）。不支持通过状态变量（例如@State）动态更新地址。加载的网页中支持通过JS SDK提供的接口调用系统能力，具体以JS SDK为准。
controller	AtomicServiceWebController	是	@ObjectLink	通过AtomicServiceWebController可以控制AtomicServiceWeb组件各种行为。
navPathStack	NavPathStack	否	-	路由栈信息。当使用NavDestination作为页面的根容器时，需传入NavDestination容器对应的NavPathStack处理页面路由。
mixedMode	MixedMode	否	@Prop	设置是否允许加载超文本传输协议（HTTP）和超文本传输安全协议（HTTPS）混合内容，默认不允许加载HTTP和HTTPS混合内容。
darkMode	WebDarkMode	否	@Prop	设置Web深色模式，默认关闭。
forceDarkAccess	boolean	否	@Prop	设置网页是否开启强制深色模式。默认关闭。该属性仅在darkMode开启深色模式时生效。
onMessage	Callback<