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 a62c3c43224232661140e682e6406752de148acb..bfc5d5c9fda0df3a501f9c051400e3c95a3ca00c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-webview.md +++ b/zh-cn/application-dev/reference/apis/js-apis-webview.md @@ -286,7 +286,7 @@ loadData(data: string, mimeType: string, encoding: string, baseUrl?: string, his **系统能力:** SystemCapability.Web.Webview.Core -**参数:** +**参数:** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------------------------------------------------------ | @@ -305,7 +305,7 @@ loadData(data: string, mimeType: string, encoding: string, baseUrl?: string, his | 17100001 | Init error. The WebviewController must be associated with a Web component. | | 17100002 | Invalid url. | -**示例:** +**示例:** ```ts // xxx.ets @@ -344,7 +344,7 @@ accessForward(): boolean **系统能力:** SystemCapability.Web.Webview.Core -**返回值:** +**返回值:** | 类型 | 说明 | | ------- | --------------------------------- | @@ -358,7 +358,7 @@ accessForward(): boolean | -------- | ------------------------------------------------------------ | | 17100001 | Init error. The WebviewController must be associated with a Web component. | -**示例:** +**示例:** ```ts // xxx.ets @@ -402,7 +402,7 @@ forward(): void | -------- | ------------------------------------------------------------ | | 17100001 | Init error. The WebviewController must be associated with a Web component. | -**示例:** +**示例:** ```ts // xxx.ets @@ -495,7 +495,7 @@ backward(): void | -------- | ------------------------------------------------------------ | | 17100001 | Init error. The WebviewController must be associated with a Web component. | -**示例:** +**示例:** ```ts // xxx.ets @@ -945,7 +945,7 @@ runJavaScript(script: string): Promise\ | ------ | -------- | ---- | ---------------- | | script | string | 是 | JavaScript脚本。 | -**返回值:** +**返回值:** | 类型 | 说明 | | --------------- | --------------------------------------------------- | @@ -2378,6 +2378,362 @@ Scroll Test ``` +### 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. | + +**示例:** + +```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. | + +**示例:** + +```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. | + +**示例:** + +```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 | 是 | 设置为true时同时清除rom和ram中的缓存,设置为false时只清除ram中的缓存。 | + +**错误码:** + +以下错误码的详细介绍请参见 [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('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 }) + } + } +} +``` + ### customizeSchemes static customizeSchemes(schemes: Array\): void @@ -2445,7 +2801,7 @@ static getCookie(url: string): string | ------ | ------ | ---- | :------------------------ | | url | string | 是 | 要获取的cookie所属的url。 | -**返回值:** +**返回值:** | 类型 | 说明 | | ------ | ------------------------- | @@ -2592,7 +2948,7 @@ static saveCookieAsync(): Promise\ **系统能力:** SystemCapability.Web.Webview.Core -**返回值:** +**返回值:** | 类型 | 说明 | | ---------------- | ----------------------------------------- | @@ -2680,7 +3036,7 @@ static isCookieAllowed(): boolean **系统能力:** SystemCapability.Web.Webview.Core -**返回值:** +**返回值:** | 类型 | 说明 | | ------- | -------------------------------- | @@ -2759,7 +3115,7 @@ static isThirdPartyCookieAllowed(): boolean **系统能力:** SystemCapability.Web.Webview.Core -**返回值:** +**返回值:** | 类型 | 说明 | | ------- | -------------------------------------- | @@ -4056,6 +4412,83 @@ Web组件返回的请求/响应头对象。 | usage | number | 是 | 否 | 指定源的存储量。 | | 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) | 历史记录项。 | + +**示例:** + +```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 | 是 | 否 | 历史记录项的标题。 | + + ## WebCustomScheme 自定义协议配置。 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 index 9935f34898d69fa40bb3dd96b9a686045fa69d07..460207b2fd071cdb84fa49ee3afb99a5a3c830e9 100644 --- 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 @@ -774,6 +774,347 @@ 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 | 设置网页的默认等宽字体大小,单位px。输入值的范围为-2^31到2^31-1,实际渲染时超过72的值按照72进行渲染,低于1的值按照1进行渲染。 | + +**示例:** + + ```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 | 设置网页的默认字体大小,单位px。输入值的范围为-2^31到2^31-1,实际渲染时超过72的值按照72进行渲染,低于1的值按照1进行渲染。 | + +**示例:** + + ```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 | 设置网页字体大小最小值,单位px。输入值的范围为-2^31到2^31-1,实际渲染时超过72的值按照72进行渲染,低于1的值按照1进行渲染。 | + +**示例:** + + ```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) + } + } + } + ``` + +### minLogicalFontSize9+ + +minLogicalFontSize(size: number) + +设置网页逻辑字体大小最小值。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ------ | -------- | ---- | ------ | ------------------------ | +| size | number | 是 | 8 | 设置网页逻辑字体大小最小值,单位px。输入值的范围为-2^31到2^31-1,实际渲染时超过72的值按照72进行渲染,低于1的值按照1进行渲染。 | + +**示例:** + + ```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 }) + .minLogicalFontSize(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) + } + } + } + ``` + ### darkMode9+ darkMode(mode: WebDarkMode) @@ -2225,6 +2566,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)。 @@ -5973,4 +6489,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