1# Enums 2<!--Kit: ArkWeb--> 3<!--Subsystem: Web--> 4<!--Owner: @yp99ustc; @aohui; @zourongchun--> 5<!--Designer: @LongLie; @yaomingliu; @zhufenghao--> 6<!--Tester: @ghiker--> 7<!--Adviser: @HelloCrease--> 8 9> **说明：** 10> 11> 该组件首批接口从API version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 12 13## MessageLevel 14 15ConsoleMessage的信息级别。 16 17> **说明：** 18> 19> - 在html5侧，调用console.log或console.info对应ConsoleMessage的信息级别都为MessageLevel.Info。 20 21**系统能力：** SystemCapability.Web.Webview.Core 22 23| 名称 | 值 | 说明 | 24| ----- | -- | ---- | 25| Debug | 1 | 调试级别。 | 26| Error | 4 | 错误级别。 | 27| Info | 2 | 消息级别。 | 28| Log | 5 | 日志级别。 | 29| Warn | 3 | 警告级别。 | 30 31## MixedMode 32 33混合内容模式。 34 35**系统能力：** SystemCapability.Web.Webview.Core 36 37| 名称 | 值 | 说明 | 38| ---------- | -- | ---------------------------------- | 39| All | 0 | 宽松模式：允许加载HTTP和HTTPS混合内容。所有不安全的内容都可以被加载。 | 40| Compatible | 1 | 兼容模式：混合内容兼容性模式，部分不安全的内容可能被加载。 | 41| None | 2 | 严格模式：不允许加载HTTP和HTTPS混合内容。 | 42 43## HitTestType 44 45点击事件检测结果类型。 46 47 **系统能力：** SystemCapability.Web.Webview.Core 48 49| 名称 | 值 | 说明 | 50| ------------- | -- | ------------------------ | 51| EditText | 0 | 可编辑的区域。 | 52| Email | 1 | 电子邮件地址。 | 53| HttpAnchor | 2 | 超链接，其src为http。 | 54| HttpAnchorImg | 3 | 带有超链接的图片，其中超链接的src为http。 | 55| Img | 4 | HTML::img标签。 | 56| Map | 5 | 地理地址。 | 57| Phone | 6 | 电话号码。 | 58| Unknown | 7 | 未知内容。 | 59 60## CacheMode 61 62缓存模式。 63 64**系统能力：** SystemCapability.Web.Webview.Core 65 66| 名称 | 值 | 说明 | 67| ------- | -- | ------------------------------------ | 68| Default<sup>9+</sup> | 0 | 优先使用未过期cache加载资源，无效或无cache时从网络获取。 | 69| None | 1 | 优先使用cache(含过期)加载资源，无cache时从网络获取。 | 70| Online | 2 | 强制从网络获取最新资源，不使用任何cache。 | 71| Only | 3 | 仅使用本地cache加载资源。 | 72 73 74## OverScrollMode<sup>11+</sup> 75 76设置Web的过滚动模式为关闭或开启。 77 78 **系统能力：** SystemCapability.Web.Webview.Core 79 80| 名称 | 值 | 说明 | 81| ------ | -- | ----------- | 82| NEVER | 0 | Web过滚动模式关闭。 | 83| ALWAYS | 1 | Web过滚动模式开启。 | 84 85## BlurOnKeyboardHideMode<sup>14+</sup> 86 87设置手动收起软键盘时Web元素是否失焦。 88 89**系统能力：** SystemCapability.Web.Webview.Core 90 91**参数：** 92 93| 名称 | 值 | 说明 | 94| ------ | -- | ----------- | 95| SILENT | 0 | 软键盘收起时Web组件失焦功能关闭，当用户手动收起软键盘时焦点仍在文本框。 | 96| BLUR | 1 | 软键盘收起时Web组件失焦功能开启，当用户手动收起软键盘时，焦点会从文本框转移到Web的body上，文本框失焦。 | 97 98## WebDarkMode<sup>9+</sup> 99 100Web深色模式的配置。 101 102**系统能力：** SystemCapability.Web.Webview.Core 103 104| 名称 | 值 | 说明 | 105| ---- | -- | ------------ | 106| Off | 0 | Web深色模式关闭。 | 107| On | 1 | Web深色模式开启。 | 108| Auto | 2 | Web深色模式跟随系统。 | 109 110## WebCaptureMode<sup>10+</sup> 111 112Web屏幕捕获模式。 113 114**系统能力：** SystemCapability.Web.Webview.Core 115 116| 名称 | 值 | 说明 | 117| ----------- | -- | ------- | 118| HOME_SCREEN | 0 | 主屏捕获模式。 | 119 120## ThreatType<sup>11+</sup> 121 122定义网站风险类型。 123 124**系统能力：** SystemCapability.Web.Webview.Core 125 126| 名称 | 值 | 说明 | 127| ---------------- | -- | ----------------------| 128| THREAT_ILLEGAL | 0 | 非法网站。 | 129| THREAT_FRAUD | 1 | 欺诈网站。 | 130| THREAT_RISK | 2 | 存在安全风险的网站。 | 131| THREAT_WARNING | 3 | 涉嫌包含不健康内容的网站。 | 132 133## RenderExitReason<sup>9+</sup> 134 135onRenderExited接口返回的渲染进程退出的具体原因。 136 137**系统能力：** SystemCapability.Web.Webview.Core 138 139| 名称 | 值 | 说明 | 140| -------------------------- | -- | ----------------- | 141| ProcessAbnormalTermination | 0 | 渲染进程异常退出。 | 142| ProcessWasKilled | 1 | 收到SIGKILL，或被手动终止。 | 143| ProcessCrashed | 2 | 渲染进程崩溃退出，如段错误。 | 144| ProcessOom | 3 | 程序内存不足。 | 145| ProcessExitUnknown | 4 | 其他原因。 | 146 147## SslError<sup>9+</sup> 148 149onSslErrorEventReceive接口返回的SSL错误的具体原因。 150 151**系统能力：** SystemCapability.Web.Webview.Core 152 153| 名称 | 值 | 说明 | 154| ------------ | -- | ----------- | 155| Invalid | 0 | 一般错误。 | 156| HostMismatch | 1 | 主机名不匹配。 | 157| DateInvalid | 2 | 证书日期无效。 | 158| Untrusted | 3 | 证书颁发机构不受信任。 | 159 160## FileSelectorMode<sup>9+</sup> 161 162文件选择器的模式。 163 164**系统能力：** SystemCapability.Web.Webview.Core 165 166| 名称 | 值 | 说明 | 167| -------------------- | -- | ---------- | 168| FileOpenMode | 0 | 打开上传单个文件。 | 169| FileOpenMultipleMode | 1 | 打开上传多个文件。 | 170| FileOpenFolderMode | 2 | 打开上传文件夹模式。 | 171| FileSaveMode | 3 | 文件保存模式。 | 172 173## WebLayoutMode<sup>11+</sup> 174 175Web布局模式的配置。 176 177**系统能力：** SystemCapability.Web.Webview.Core 178 179| 名称 | 值 | 说明 | 180| ----------- | -- | ------------------ | 181| NONE | 0 | Web布局跟随系统。 | 182| FIT_CONTENT | 1 | Web基于页面大小的自适应网页布局。 | 183 184## RenderProcessNotRespondingReason<sup>12+</sup> 185 186触发渲染进程无响应回调的原因。 187 188**系统能力：** SystemCapability.Web.Webview.Core 189 190| 名称 | 值 | 说明 | 191| ----------------------------- | -- | ------------ | 192| INPUT_TIMEOUT | 0 | 发送给渲染进程的input事件响应超时。 | 193| NAVIGATION_COMMIT_TIMEOUT | 1 | 新的网页加载导航响应超时。 | 194 195## ProtectedResourceType<sup>9+</sup> 196 197**系统能力：** SystemCapability.Web.Webview.Core 198 199| 名称 | 值 | 说明 | 可申请的权限 | 200| --------------------------- | --------------- | ------------- | ---------------------| 201| MidiSysex | TYPE_MIDI_SYSEX | MIDI SYSEX资源。<br>目前仅支持权限事件上报，MIDI设备的使用还未支持。 | 暂不支持申请使用MIDI(Musical Instrument Digital Interface)设备相关权限。| 202| VIDEO_CAPTURE<sup>10+</sup> | TYPE_VIDEO_CAPTURE | 视频捕获资源，例如相机。 | 相机权限：ohos.permission.CAMERA。| 203| AUDIO_CAPTURE<sup>10+</sup> | TYPE_AUDIO_CAPTURE | 音频捕获资源，例如麦克风。 | 麦克风权限：ohos.permission.MICROPHONE。| 204| SENSOR<sup>12+</sup> | TYPE_SENSOR | 传感器资源，例如加速度传感器。 | 加速度传感器权限：ohos.permission.ACCELEROMETER、 <br>陀螺仪传感器权限：ohos.permission.GYROSCOPE。 | 205 206## ContextMenuSourceType<sup>9+</sup> 207 208触发上下文菜单的事件来源。 209 210**系统能力：** SystemCapability.Web.Webview.Core 211 212| 名称 | 值 | 说明 | 213| --------- | -- |------------ | 214| None | 0 | 其他事件来源。 | 215| Mouse | 1 | 鼠标事件。 | 216| LongPress | 2 | 长按事件。 | 217 218## ContextMenuMediaType<sup>9+</sup> 219 220触发上下文菜单的网页元素类型。 221 222**系统能力：** SystemCapability.Web.Webview.Core 223 224| 名称 | 值 | 说明 | 225| ----- | -- | ------------- | 226| None | 0 | 其他非图片媒体类型。 | 227| Image | 1 | 图片类型。 | 228 229## ContextMenuInputFieldType<sup>9+</sup> 230 231输入框类型。 232 233**系统能力：** SystemCapability.Web.Webview.Core 234 235| 名称 | 值 | 说明 | 236| --------- | -- | --------------------------- | 237| None | 0 | 非输入框。 | 238| PlainText | 1 | 纯文本类型，包括text、search、email等。 | 239| Password | 2 | 密码类型。 | 240| Number | 3 | 数字类型。 | 241| Telephone | 4 | 电话号码类型。 | 242| Other | 5 | 其他类型。 | 243 244## NativeEmbedStatus<sup>11+</sup> 245 246定义同层标签生命周期，当加载页面中有同层标签会触发CREATE，同层标签移动或者放大会触发UPDATE，退出页面会触发DESTROY。 247 248**系统能力：** SystemCapability.Web.Webview.Core 249 250| 名称 | 值 | 说明 | 251| ----------------------------- | -- | ------------ | 252| CREATE | 0 | 同层标签创建。 | 253| UPDATE | 1 | 同层标签更新。 | 254| DESTROY | 2 | 同层标签销毁。 | 255| ENTER_BFCACHE<sup>12+</sup> | 3 | 同层标签进入BFCache。 | 256| LEAVE_BFCACHE<sup>12+</sup> | 4 | 同层标签离开BFCache。 | 257 258## ContextMenuEditStateFlags<sup>9+</sup> 259 260支持以按位或的方式使用此枚举。例如，如果需要同时支持CAN_CUT、CAN_COPY和CAN_SELECT_ALL，可使用CAN_CUT | CAN_COPY | CAN_SELECT_ALL或11。 261 262**系统能力：** SystemCapability.Web.Webview.Core 263 264| 名称 | 值 | 说明 | 265| -------------- | -- | -------- | 266| NONE | 0 | 不可编辑。 | 267| CAN_CUT | 1 << 0 | 支持剪切。 | 268| CAN_COPY | 1 << 1 | 支持拷贝。 | 269| CAN_PASTE | 1 << 2 | 支持粘贴。 | 270| CAN_SELECT_ALL | 1 << 3 | 支持全选。 | 271 272## WebNavigationType<sup>11+</sup> 273 274定义navigation类型。 275 276**系统能力：** SystemCapability.Web.Webview.Core 277 278| 名称 | 值 | 说明 | 279| ----------------------------- | -- | ------------ | 280| UNKNOWN | 0 | 未知类型。 | 281| MAIN_FRAME_NEW_ENTRY | 1 | 主文档上产生的新的历史节点跳转。 | 282| MAIN_FRAME_EXISTING_ENTRY | 2 | 主文档上产生的到已有的历史节点的跳转。 | 283| NAVIGATION_TYPE_NEW_SUBFRAME | 4 | 子文档上产生的用户触发的跳转。 | 284| NAVIGATION_TYPE_AUTO_SUBFRAME | 5 | 子文档上产生的非用户触发的跳转。 | 285 286## RenderMode<sup>12+</sup> 287 288定义Web组件的渲染方式，默认为异步渲染模式。 289 290建议使用异步渲染模式，异步渲染模式有更好的性能和更低的功耗。 291 292**系统能力：** SystemCapability.Web.Webview.Core 293 294| 名称 | 值 | 说明 | 295| ----------------------------- | -- | ------------ | 296| ASYNC_RENDER | 0 | Web组件异步渲染模式，ArkWeb组件作为图形surface节点，独立送显，Web组件的宽度最大规格不超过7,680 px（物理像素）。 | 297| SYNC_RENDER | 1 | Web组件同步渲染模式，ArkWeb组件作为图形canvas节点，跟随系统组件一起送显，可以渲染更长的Web组件内容，Web组件的宽度最大规格不超过500,000 px（物理像素）。 | 298 299## ViewportFit<sup>12+</sup> 300 301网页meta中viewport-fit配置的视口类型。 302 303**系统能力：** SystemCapability.Web.Webview.Core 304 305| 名称 | 值 | 说明 | 306| ----------------------------- | -- | ------------ | 307| AUTO | 0 | 默认值，整个网页可见。 | 308| CONTAINS | 1 | 初始布局视口和视觉视口为适应设备显示屏的最大矩形内。 | 309| COVER | 2| 初始布局视口和视觉视口为设备物理屏幕的外接矩形内。 | 310 311## WebKeyboardAvoidMode<sup>12+</sup> 312 313软键盘避让的模式。 314 315**系统能力：** SystemCapability.Web.Webview.Core 316 317| 名称 | 值 | 说明 | 318| ------------------ | -- | ------------ | 319| RESIZE_VISUAL | 0 | 软键盘避让时，仅调整可视视口大小，不调整布局视口大小。 | 320| RESIZE_CONTENT | 1 | 默认值，软键盘避让时，同时调整可视视口和布局视口的大小。 | 321| OVERLAYS_CONTENT | 2 | 不调整任何视口大小，不会触发软键盘避让。 | 322 323## WebElementType<sup>13+</sup> 324 325网页元素信息。 326 327**系统能力：** SystemCapability.Web.Webview.Core 328 329**参数：** 330 331| 名称 | 值 | 说明 | 332| --------- | -- | ----------------- | 333| IMAGE | 1 | 网页元素为图像类型。 | 334| LINK<sup>20+</sup> | 2 | 网页元素为超链接类型。 | 335 336## WebResponseType<sup>13+</sup> 337 338菜单的响应类型。 339 340**系统能力：** SystemCapability.Web.Webview.Core 341 342**参数：** 343 344| 名称 | 值 | 说明 | 345| -------------- | -- | ------------------ | 346| LONG_PRESS | 1 | 通过长按触发菜单弹出。 | 347 348## AudioSessionType<sup>20+</sup> 349 350应用中Web音频类型。 351 352**系统能力：** SystemCapability.Web.Webview.Core 353 354**参数：** 355 356| 名称 | 值 | 说明 | 357| -------------- | -- | ------------------ | 358| AMBIENT | 3 | 适用于网页游戏场景，支持Web游戏声音与系统音乐同时播放。对应系统音频流类型STREAM_USAGE_GAME。| 359 360## GestureFocusMode<sup>20+</sup> 361 362手势获焦的模式。 363 364**系统能力：** SystemCapability.Web.Webview.Core 365 366| 名称 | 值 | 说明 | 367| -------------------------- | -- | ------------- | 368| DEFAULT | 0 | 默认值，Web会在触摸按下屏幕时申请获焦，包括点击、长按、滑动、缩放等任何触摸屏幕的手势行为。 | 369| GESTURE_TAP_AND_LONG_PRESS | 1 | Web只会在点击和长按手势事件生成时申请获焦，点击和长按在触摸抬起之后生成，滑动和缩放等手势行为不会获焦。 | 370 371## WebBypassVsyncCondition<sup>20+</sup> 372 373跳过渲染vsync条件。 374 375**系统能力：** SystemCapability.Web.Webview.Core 376 377| 名称 | 值 | 说明 | 378| ----------- | -- | ------------------ | 379| NONE | 0 | 默认值，按vsync调度流程绘制。 | 380| SCROLLBY_FROM_ZERO_OFFSET | 1 | 在使用scrollby（只支持带滚动偏移量）且Web页面滚动偏移量为0，渲染流程跳过vsync调度直接绘制。 | 381 382## PdfLoadResult<sup>20+</sup> 383 384定义PDF页面的加载结果。 385 386**系统能力：** SystemCapability.Web.Webview.Core 387 388| 名称 | 值 | 说明 | 389| -------------- | ---- | ---------------------------------------- | 390| LOAD_SUCCESS | 0 | PDF页面加载成功。 | 391| PARSE_ERROR_FILE | 1 | PDF文件加载失败的错误码。 | 392| PARSE_ERROR_FORMAT | 2 | PDF文件格式不支持的错误码。 | 393| PARSE_ERROR_PASSWORD | 3 | PDF文件密码不正确的错误码。 | 394| PARSE_ERROR_HANDLER | 4 | PDF文件处理失败的错误码。 | 395