openharmony 鸿蒙 arkts-basic-components-web-e

2025-06-12 浏览 (1)

Enums

说明:

本模块首批接口从API version 8开始支持,后续版本的新增接口,则采用上角标单独标记接口的起始版本。

MessageLevel

ConsoleMessage的信息级别。

系统能力: SystemCapability.Web.Webview.Core

名称说明
Debug1调试级别。
Error4错误级别。
Info2消息级别。
Log5日志级别。
Warn3警告级别。

MixedMode

系统能力: SystemCapability.Web.Webview.Core

名称说明
All0宽松模式:允许加载HTTP和HTTPS混合内容。所有不安全的内容都可以被加载。
Compatible1兼容模式:混合内容兼容性模式,部分不安全的内容可能被加载。
None2严格模式:不允许加载HTTP和HTTPS混合内容。

HitTestType

系统能力: SystemCapability.Web.Webview.Core

名称说明
EditText0可编辑的区域。
Email1电子邮件地址。
HttpAnchor2超链接,其src为http。
HttpAnchorImg3带有超链接的图片,其中超链接的src为http。
Img4HTML::img标签。
Map5地理地址。
Phone6电话号码。
Unknown7未知内容。

CacheMode

系统能力: SystemCapability.Web.Webview.Core

名称说明
Default9+0优先使用未过期cache加载资源,无效或无cache时从网络获取。
None1优先使用cache(含过期)加载资源,无cache时从网络获取。
Online2强制从网络获取最新资源,不使用任何cache。
Only3仅使用本地cache加载资源。

OverScrollMode11+

设置Web的过滚动模式为关闭或开启。

系统能力: SystemCapability.Web.Webview.Core

名称说明
NEVER0Web过滚动模式关闭。
ALWAYS1Web过滚动模式开启。

BlurOnKeyboardHideMode14+

设置手动收起软键盘时Web元素是否失焦。

系统能力: SystemCapability.Web.Webview.Core

参数:

名称说明
SILENT0软键盘收起时Web组件失焦功能关闭,当用户手动收起软键盘时焦点仍在文本框。
BLUR1软键盘收起时Web组件失焦功能开启,当用户手动收起软键盘时,焦点会从文本框转移到Web的body上,文本框失焦。

WebDarkMode9+

Web深色模式的配置。

系统能力: SystemCapability.Web.Webview.Core

名称说明
Off0Web深色模式关闭。
On1Web深色模式开启。
Auto2Web深色模式跟随系统。

WebCaptureMode10+

Web屏幕捕获模式。

系统能力: SystemCapability.Web.Webview.Core

名称说明
HOME_SCREEN0主屏捕获模式。

ThreatType11+

定义网站风险类型。

系统能力: SystemCapability.Web.Webview.Core

名称说明
THREAT_ILLEGAL0非法网站。
THREAT_FRAUD1欺诈网站。
THREAT_RISK2存在安全风险的网站。
THREAT_WARNING3涉嫌包含不健康内容的网站。

RenderExitReason9+

onRenderExited接口返回的渲染进程退出的具体原因。

系统能力: SystemCapability.Web.Webview.Core

名称说明
ProcessAbnormalTermination0渲染进程异常退出。
ProcessWasKilled1收到SIGKILL,或被手动终止。
ProcessCrashed2渲染进程崩溃退出,如段错误。
ProcessOom3程序内存不足。
ProcessExitUnknown4其他原因。

SslError9+

onSslErrorEventReceive接口返回的SSL错误的具体原因。

系统能力: SystemCapability.Web.Webview.Core

名称说明
Invalid0一般错误。
HostMismatch1主机名不匹配。
DateInvalid2证书日期无效。
Untrusted3证书颁发机构不受信任。

FileSelectorMode9+

文件选择器的模式。

系统能力: SystemCapability.Web.Webview.Core

名称说明
FileOpenMode0打开上传单个文件。
FileOpenMultipleMode1打开上传多个文件。
FileOpenFolderMode2打开上传文件夹模式。
FileSaveMode3文件保存模式。

WebLayoutMode11+

Web布局模式的配置。

系统能力: SystemCapability.Web.Webview.Core

名称说明
NONE0Web布局跟随系统。
FIT_CONTENT1Web基于页面大小的自适应网页布局。

RenderProcessNotRespondingReason12+

触发渲染进程无响应回调的原因。

系统能力: SystemCapability.Web.Webview.Core

名称说明
INPUT_TIMEOUT0发送给渲染进程的input事件响应超时。
NAVIGATION_COMMIT_TIMEOUT1新的网页加载导航响应超时。

ProtectedResourceType9+

系统能力: SystemCapability.Web.Webview.Core

名称说明
MidiSysexTYPE_MIDI_SYSEXMIDI SYSEX资源。
目前仅支持权限事件上报,MIDI设备的使用还未支持。
VIDEO_CAPTURE10+TYPE_VIDEO_CAPTURE视频捕获资源,例如相机。
AUDIO_CAPTURE10+TYPE_AUDIO_CAPTURE音频捕获资源,例如麦克风。
SENSOR12+TYPE_SENSOR传感器资源,例如加速度传感器。

ContextMenuSourceType9+

系统能力: SystemCapability.Web.Webview.Core

名称说明
None0其他事件来源。
Mouse1鼠标事件。
LongPress2长按事件。

ContextMenuMediaType9+

系统能力: SystemCapability.Web.Webview.Core

名称说明
None0非特殊媒体或其他媒体类型。
Image1图片。

ContextMenuInputFieldType9+

输入框类型。

系统能力: SystemCapability.Web.Webview.Core

名称说明
None0非输入框。
PlainText1纯文本类型,包括text、search、email等。
Password2密码类型。
Number3数字类型。
Telephone4电话号码类型。
Other5其他类型。

NativeEmbedStatus11+

定义同层标签生命周期,当加载页面中有同层标签会触发CREATE,同层标签移动或者放大会触发UPDATE,退出页面会触发DESTROY。

系统能力: SystemCapability.Web.Webview.Core

名称说明
CREATE0同层标签创建。
UPDATE1同层标签更新。
DESTROY2同层标签销毁。
ENTER_BFCACHE12+3同层标签进入BFCache。
LEAVE_BFCACHE12+4同层标签离开BFCache。

ContextMenuEditStateFlags9+

支持以按位或的方式使用此枚举。例如,如果需要同时支持CAN_CUT、CAN_COPY和CAN_SELECT_ALL,可使用CAN_CUT|CAN_COPY|CAN_SELECT_ALL或11。

系统能力: SystemCapability.Web.Webview.Core

名称说明
NONE0不可编辑。
CAN_CUT1 << 0支持剪切。
CAN_COPY1 << 1支持拷贝。
CAN_PASTE1 << 2支持粘贴。
CAN_SELECT_ALL1 << 3支持全选。

WebNavigationType11+

定义navigation类型。

系统能力: SystemCapability.Web.Webview.Core

名称说明
UNKNOWN0未知类型。
MAIN_FRAME_NEW_ENTRY1主文档上产生的新的历史节点跳转。
MAIN_FRAME_EXISTING_ENTRY2主文档上产生的到已有的历史节点的跳转。
NAVIGATION_TYPE_NEW_SUBFRAME4子文档上产生的用户触发的跳转。
NAVIGATION_TYPE_AUTO_SUBFRAME5子文档上产生的非用户触发的跳转。

RenderMode12+

定义Web组件的渲染方式,默认为异步渲染模式。

建议使用异步渲染模式,异步渲染模式有更好的性能和更低的功耗。

系统能力: SystemCapability.Web.Webview.Core

名称说明
ASYNC_RENDER0Web组件异步渲染模式,ArkWeb组件作为图形surface节点,独立送显,Web组件的宽度最大规格不超过7,680 px(物理像素)。
SYNC_RENDER1Web组件同步渲染模式,ArkWeb组件作为图形canvas节点,跟随系统组件一起送显,可以渲染更长的Web组件内容,Web组件的宽度最大规格不超过500,000 px(物理像素)。

ViewportFit12+

网页meta中viewport-fit配置的视口类型。

系统能力: SystemCapability.Web.Webview.Core

名称说明
AUTO0默认值,整个网页可见。
CONTAINS1初始布局视口和视觉视口为适应设备显示屏的最大矩形内。
COVER2初始布局视口和视觉视口为设备物理屏幕的外接矩形内。

WebKeyboardAvoidMode12+

软键盘避让的模式。

系统能力: SystemCapability.Web.Webview.Core

名称说明
RESIZE_VISUAL0软键盘避让时,仅调整可视视口大小,不调整布局视口大小。
RESIZE_CONTENT1默认值,软键盘避让时,同时调整可视视口和布局视口的大小。
OVERLAYS_CONTENT2不调整任何视口大小,不会触发软键盘避让。

WebElementType13+

网页元素信息。

系统能力: SystemCapability.Web.Webview.Core

参数:

名称说明
IMAGE1网页元素为图像类型。
LINK20+2网页元素为超链接类型。

WebResponseType13+

菜单的响应类型。

系统能力: SystemCapability.Web.Webview.Core

参数:

名称说明
LONG_PRESS1通过长按触发菜单弹出。

AudioSessionType20+

应用中Web音频类型。

系统能力: SystemCapability.Web.Webview.Core

参数:

名称说明
AMBIENT3适用于网页游戏场景,支持Web游戏声音与系统音乐同时播放。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkWeb(方舟Web)

harmony 鸿蒙ArkWeb_AnyNativeAPI

harmony 鸿蒙ArkWeb_ComponentAPI

harmony 鸿蒙ArkWeb_ControllerAPI

harmony 鸿蒙ArkWeb_CookieManagerAPI

harmony 鸿蒙ArkWeb_JavaScriptBridgeData

harmony 鸿蒙ArkWeb_JavaScriptObject

harmony 鸿蒙ArkWeb_JavaScriptValueAPI

harmony 鸿蒙ArkWeb_ProxyMethod

harmony 鸿蒙ArkWeb_ProxyMethodWithResult

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/m6hL5x