diff --git a/zh-cn/application-dev/reference/apis/js-apis-webview.md b/zh-cn/application-dev/reference/apis/js-apis-webview.md index 7a5537f2eed22a2be6279f4ee5066736672ebf15..f2fe1dc02a90eba00bbe13aa9fe3f64f79c77d7d 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-webview.md +++ b/zh-cn/application-dev/reference/apis/js-apis-webview.md @@ -2123,6 +2123,366 @@ struct WebComponent { } ``` +### getOriginalUrl + +getOriginalUrl(): string + +获取当前页面的原始url地址。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**返回值:** + +| 类型 | 说明 | +| ------ | ----------------------- | +| string | 当前页面的原始url地址。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web component. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + + build() { + Column() { + Button('getOrgUrl') + .onClick(() => { + try { + let url = this.controller.getOriginalUrl(); + console.log("original url: " + url); + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +### getFavicon + +getFavicon(): image.PixelMap + +获取页面的favicon图标。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**返回值:** + +| 类型 | 说明 | +| -------------------------------------- | ------------------------------- | +| [PixelMap](js-apis-image.md#pixelmap7) | 页面favicon图标的PixelMap对象。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web component. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; +import image from "@ohos.multimedia.image" +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + @State pixelmap: image.PixelMap = undefined; + + build() { + Column() { + Button('getFavicon') + .onClick(() => { + try { + this.pixelmap = this.controller.getFavicon(); + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +### setNetworkAvailable + +setNetworkAvailable(enable: boolean): void + +设置JavaScript中的window.navigator.onLine属性。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------- | ---- | --------------------------------- | +| enable | boolean | 是 | 是否使能window.navigator.onLine。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web component. | +| 401 | Invalid input parameter. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + + build() { + Column() { + Button('setNetworkAvailable') + .onClick(() => { + try { + this.controller.setNetworkAvailable(true); + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +### hasImage + +hasImage(callback: AsyncCallback): void + +通过Callback方式异步查找当前页面是否存在图像。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------- | ---- | -------------------------- | +| callback | AsyncCallback\ | 是 | 返回查找页面是否存在图像。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web compoent. | +| 401 | Invalid input parameter. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + + build() { + Column() { + Button('hasImageCb') + .onClick(() => { + try { + this.controller.hasImage((err, data) => { + if (error) { + console.info(`hasImage error: ` + JSON.stringify(error)) + return; + } + console.info("hasImage: " + data); + }); + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +### hasImage + +hasImage(): Promise + +通过Promise方式异步查找当前页面是否存在图像。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**返回值:** + +| 类型 | 说明 | +| ----------------- | --------------------------------------- | +| Promise\ | Promise实例,返回查找页面是否存在图像。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web compoent. | +| 401 | Invalid input parameter. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + + build() { + Column() { + Button('hasImagePm') + .onClick(() => { + try { + this.controller.hasImage().then((data) => { + console.info('hasImage: ' + data); + }) + .catch(function (error) { + console.error("error: " + error); + }) + } catch (error) { + console.error(`Errorcode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +### removeCache + +removeCache(clearRom: boolean): void + +清除应用中的资源缓存文件,此方法将会清除同一应用中所有webview的缓存文件。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------- | ---- | -------------------------------------------------------- | +| clearRom | boolean | 是 | 是否同时清除rom和ram中的缓存,false时只清除ram中的缓存。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web component. | +| 401 | Invalid input parameter. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + + build() { + Column() { + Button('removeCache') + .onClick(() => { + try { + this.controller.removeCache(false); + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +### getBackForwardEntries + +getBackForwardEntries(): BackForwardList + +获取当前Webview的历史信息列表。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**返回值:** + +| 类型 | 说明 | +| ----------------------------------- | --------------------------- | +| [BackForwardList](#backforwardlist) | 当前Webview的历史信息列表。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 17100001 | Init error. The WebviewController must be associated with a Web component. | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + + build() { + Column() { + Button('getBackForwardEntries') + .onClick(() => { + try { + let list = this.controller.getBackForwardEntries() + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + ## WebCookieManager 通过WebCookie可以控制Web组件中的cookie的各种行为,其中每个应用中的所有web组件共享一个WebCookieManager实例。 @@ -3750,4 +4110,90 @@ Web组件返回的请求/响应头对象。 | ------ | ------ | ---- | ---- | ---- | | origin | string | 是 | 否 | 指定源的字符串索引。 | | usage | number | 是 | 否 | 指定源的存储量。 | -| quota | number | 是 | 否 | 指定源的存储配额。 | \ No newline at end of file +| quota | number | 是 | 否 | 指定源的存储配额。 | + +## BackForwardList + +当前Webview的历史信息列表。 + +**系统能力:** SystemCapability.Web.Webview.Core + +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ------------ | ------ | ---- | ---- | ---------------------------- | +| currentIndex | number | 是 | 否 | 当前在页面历史列表中的索引。 | +| size | number | 是 | 否 | 历史列表中索引的数量。 | + +### getItemAtIndex + +getItemAtIndex(index: number): HistoryItem + +获取历史列表中指定索引的历史记录项信息。 + +**系统能力:** SystemCapability.Web.Webview.Core + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ---------------------- | +| index | number | 是 | 指定历史列表中的索引。 | + +**返回值:** + +| 类型 | 说明 | +| --------------------------- | ------------ | +| [HistoryItem](#historyitem) | 历史记录项。 | + +**错误码:** + +以下错误码的详细介绍请参见 [webview错误码](../errorcodes/errorcode-webview.md) + +| 错误码ID | 错误信息 | +| -------- | ----------------------- | +| 401 | Invalid input parameter | + +**示例:** + +```ts +// xxx.ets +import web_webview from '@ohos.web.webview'; +import image from "@ohos.multimedia.image" + +@Entry +@Component +struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController(); + @State icon: image.PixelMap = undefined; + + build() { + Column() { + Button('getBackForwardEntries') + .onClick(() => { + try { + let list = this.controller.getBackForwardEntries(); + let historyItem = list.getItemAtIndex(list.currentIndex); + console.log("HistoryItem: " + JSON.stringify(historyItem)); + this.icon = item.icon; + } catch (error) { + console.error(`ErrorCode: ${error.code}, Message: ${error.message}`); + } + }) + Web({ src: 'www.example.com', controller: this.controller }) + } + } +} +``` + +## HistoryItem + +页面历史记录项。 + +**系统能力:** SystemCapability.Web.Webview.Core + +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ------------- | -------------------------------------- | ---- | ---- | ---------------------------- | +| icon | [PixelMap](js-apis-image.md#pixelmap7) | 是 | 否 | 历史页面图标的PixelMap对象。 | +| historyUrl | string | 是 | 否 | 历史记录项的url地址。 | +| historyRawUrl | string | 是 | 否 | 历史记录项的原始url地址。 | +| title | string | 是 | 否 | 历史记录项的标题。 | + +### \ No newline at end of file diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md old mode 100644 new mode 100755 index 8990973ebf9bc15244e7e966d16dba3fb783113a..076b6b1f2f10488f301908e8b91e659d1e3991f1 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md @@ -672,6 +672,316 @@ webDebuggingAccess(webDebuggingAccess: boolean) } ``` +### blockNetwork9+ + +blockNetwork(block: boolean) + +设置Web组件是否阻止从网络加载资源。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------ | ----------------------------------- | +| block | boolean | 是 | false | 设置Web组件是否阻止从网络加载资源。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State block: boolean = true + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .blockNetwork(this.block) + } + } + } + ``` + +### defaultFixedFontSize9+ + +defaultFixedFontSize(size: number) + +设置网页的默认固定字体大小。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------ | ---------------------------- | +| size | number | 是 | 13 | 设置网页的默认固定字体大小。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State size: number = 16 + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .defaultFixedFontSize(this.size) + } + } + } + ``` + +### defaultFontSize9+ + +defaultFontSize(size: number) + +设置网页的默认字体大小。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------ | ------------------------ | +| size | number | 是 | 16 | 设置网页的默认字体大小。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State size: number = 13 + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .defaultFontSize(this.size) + } + } + } + ``` + +### minFontSize9+ + +minFontSize(size: number) + +设置网页字体大小最小值。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------ | ------------------------ | +| size | number | 是 | 8 | 设置网页字体大小最小值。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State size: number = 13 + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .minFontSize(this.size) + } + } + } + ``` + +### webFixedFont9+ + +webFixedFont(family: string) + +设置网页的fixed font字体库。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | --------- | ---------------------------- | +| family | string | 是 | monospace | 设置网页的fixed font字体库。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State family: string = "monospace" + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .webFixedFont(this.family) + } + } + } + ``` + +### webSansSerifFont9+ + +webSansSerifFont(family: string) + +设置网页的sans serif font字体库。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ---------- | --------------------------------- | +| family | string | 是 | sans-serif | 设置网页的sans serif font字体库。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State family: string = "sans-serif" + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .webSansSerifFont(this.family) + } + } + } + ``` + +### webSerifFont9+ + +webSerifFont(family: string) + +设置网页的serif font字体库。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------ | ---------------------------- | +| family | string | 是 | serif | 设置网页的serif font字体库。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State family: string = "serif" + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .webSerifFont(this.family) + } + } + } + ``` + +### webStandardFont9+ + +webStandardFont(family: string) + +设置网页的standard font字体库。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ---------- | ------------------------------- | +| family | string | 是 | sans serif | 设置网页的standard font字体库。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State family: string = "sans-serif" + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .webStandardFont(this.family) + } + } + } + ``` + +### webFantasyFont9+ + +webFantasyFont(family: string) + +设置网页的fantasy font字体库。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------- | ------------------------------ | +| family | string | 是 | fantasy | 设置网页的fantasy font字体库。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State family: string = "fantasy" + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .webFantasyFont(this.family) + } + } + } + ``` + +### webCursiveFont9+ + +webCursiveFont(family: string) + +设置网页的cursive font字体库。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------- | ------------------------------ | +| family | string | 是 | cursive | 设置网页的cursive font字体库。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State family: string = "cursive" + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .webCursiveFont(this.family) + } + } + } + ``` + ## 事件 不支持通用事件。 @@ -2059,6 +2369,181 @@ onSearchResultReceive(callback: (event?: {activeMatchOrdinal: number, numberOfMa } ``` +### onDataResubmitted9+ + +onDataResubmitted(callback: (event: {handler: DataResubmissionHandler}) => void) + +设置网页表单可以重新提交时触发的回调函数。 + +**参数:** + +| 参数名 | 参数类型 | 参数描述 | +| ------- | ---------------------------------------------------- | ---------------------- | +| handler | [DataResubmissionHandler](#dataresubmissionhandler9) | 表单数据重新提交句柄。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + build() { + Column() { + Web({ src:'www.example.com', controller: this.controller }) + .onDataResubmitted((event) => { + console.log('onDataResubmitted') + event.handler.resend(); + }) + } + } + } + ``` + +### onPageVisible9+ + +onPageVisible(callback: (event: {url: string}) => void) + +设置旧页面不再呈现,新页面即将可见时触发的回调函数。 + +**参数:** + +| 参数名 | 参数类型 | 参数描述 | +| ------ | -------- | ------------------------------------------------- | +| url | string | 旧页面不再呈现,新页面即将可见时新页面的url地址。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + build() { + Column() { + Web({ src:'www.example.com', controller: this.controller }) + .onPageVisible((event) => { + console.log('onPageVisible url:' + event.url) + }) + } + } + } + ``` + +### onInterceptKeyEvent9+ + +onInterceptKeyEvent(callback: (event: KeyEvent) => boolean) + +设置键盘事件的回调函数,该回调在被Webview消费前触发。 + +**参数:** + +| 参数名 | 参数类型 | 参数描述 | +| ------ | ------------------------------------------------------- | -------------------- | +| event | [KeyEvent](ts-universal-events-key.md#keyevent对象说明) | 触发的KeyEvent事件。 | + +**返回值:** + +| 类型 | 说明 | +| ------- | ------------------------------------------------------------ | +| boolean | 回调函数通过返回boolean类型值来决定是否继续将该KeyEvent传入Webview内核。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + build() { + Column() { + Web({ src:'www.example.com', controller: this.controller }) + .onInterceptKeyEvent((event) => { + if (event.keyCode == 2017 || event.keyCode == 2018) { + console.info(`onInterceptKeyEvent get event.keyCode ${event.keyCode}`) + return true; + } + return false; + }) + } + } + } + ``` + +### onTouchIconUrlReceived9+ + +onTouchIconUrlReceived(callback: (event: {url: string, precomposed: boolean}) => void) + +设置接收到apple-touch-icon url地址时的回调函数。 + +**参数:** + +| 参数名 | 参数类型 | 参数描述 | +| ----------- | -------- | ---------------------------------- | +| url | string | 接收到的apple-touch-icon url地址。 | +| precomposed | boolean | 对应apple-touch-icon是否为预合成。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + build() { + Column() { + Web({ src:'www.baidu.com', controller: this.controller }) + .onTouchIconUrlReceived((event) => { + console.log('onTouchIconUrlReceived:' + JSON.stringify(event)) + }) + } + } + } + ``` + +### onFaviconReceived9+ + +onFaviconReceived(callback: (event: {favicon: image.PixelMap}) => void) + +设置应用为当前页面接收到新的favicon时的回调函数。 + +**参数:** + +| 参数名 | 参数类型 | 参数描述 | +| ------- | ---------------------------------------------- | ----------------------------------- | +| favicon | [PixelMap](../apis/js-apis-image.md#pixelmap7) | 接收到的favicon图标的PixelMap对象。 | + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + import image from "@ohos.multimedia.image" + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + @State icon: image.PixelMap = undefined; + build() { + Column() { + Web({ src:'www.example.com', controller: this.controller }) + .onFaviconReceived((event) => { + console.log('onFaviconReceived:' + JSON.stringify(event)) + this.icon = event.favicon; + }) + } + } + } + ``` + ## ConsoleMessage Web组件获取控制台信息对象。示例代码参考[onConsole事件](#onconsole)。 @@ -5669,4 +6154,62 @@ setPorts(ports: Array\): void } } } + ``` + +## DataResubmissionHandler9+ + +通过DataResubmissionHandler可以重新提交表单数据或取消。 + +### resend9+ + +resend(): void + +重新发送表单数据。 + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + build() { + Column() { + Web({ src:'www.example.com', controller: this.controller }) + .onDataResubmitted((event) => { + console.log('onDataResubmitted') + event.handler.resend(); + }) + } + } + } + ``` + +### cancel9+ + +cancel(): void + +取消重新发送表单数据。 + +**示例:** + + ```ts + // xxx.ets + import web_webview from '@ohos.web.webview' + @Entry + @Component + struct WebComponent { + controller: web_webview.WebviewController = new web_webview.WebviewController() + build() { + Column() { + Web({ src:'www.example.com', controller: this.controller }) + .onDataResubmitted((event) => { + console.log('onDataResubmitted') + event.handler.cancel(); + }) + } + } + } ``` \ No newline at end of file