diff --git a/en/application-dev/reference/arkui-ts/ts-basic-components-web.md b/en/application-dev/reference/arkui-ts/ts-basic-components-web.md index 68abd8af22e49b5ace8db3b3453c6ebcc93803e2..5a379dabb76c5568724719acd2bbf99db61523f9 100644 --- a/en/application-dev/reference/arkui-ts/ts-basic-components-web.md +++ b/en/application-dev/reference/arkui-ts/ts-basic-components-web.md @@ -21,7 +21,7 @@ None | Name | Type | Mandatory| Default Value| Description | | ---------- | ------------------------------- | ---- | ------ | -------------- | | src | string | Yes | - | Address of a web page resource.| - | controller | [WebController](#WebController) | No | - | Controller. | + | controller | [WebController](#webcontroller) | No | - | Controller. | > ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE** @@ -38,7 +38,7 @@ None | imageAccess | boolean | true | Whether to enable automatic image loading. By default, this feature is enabled. | | javaScriptProxy | {
object: object,
name: string,
methodList: Array\,
controller: WebController
} | - | JavaScript object to be injected into the window. Methods of this object can be invoked in the window. The parameters in this attribute cannot be updated.
**object** indicates the object to be registered. Methods can be declared, but not attributes. The parameters and return value can only be of the string, number, or Boolean type.
**name** indicates the name of the object to be registered, which is the same as that invoked in the window. After registration, the window can use this name to access the JavaScript object at the application side.
**methodList** indicates the methods of the JavaScript object to be registered at the application side.
**controller** indicates the controller.| | javaScriptAccess | boolean | true | Whether JavaScript scripts can be executed. By default, JavaScript scripts can be executed. | -| mixedMode | [MixedMode](#MixedMode) | MixedMode.None | Whether to enable loading of HTTP and HTTPS hybrid content can be loaded. By default, this feature is disabled.| +| mixedMode | MixedMode | MixedMode.None | Whether to enable loading of HTTP and HTTPS hybrid content can be loaded. By default, this feature is disabled.| | onlineImageAccess | boolean | true | Whether to enable access to online images through HTTP and HTTPS. By default, this feature is enabled.| | zoomAccess | boolean | true | Whether to enable zoom gestures. By default, zoom gestures are enabled. | @@ -59,13 +59,13 @@ Universal events are not supported. | Name | Description | | ------------------------------------------------------------ | ------------------------------------------------------------ | -| onAlert(callback: (event?: { url: string; message: string; result: [JsResult](#JsResult) }) => boolean) |

Triggered when **alert()** is invoked to display an alert dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows only the confirm operation) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.

| -| onBeforeUnload(callback: (event?: { url: string; message: string; result: [JsResult](#JsResult) }) => boolean) |

Triggered when the current page is about to exit after the user refreshes or closes the page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.

| -| onConfirm(callback: (event?: { url: string; message: string; result: [JsResult](#JsResult) }) => boolean) |

Triggered when **confirm()** is invoked to display a confirmation dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.

| -| onConsole(callback: (event?: { message: [ConsoleMessage](#ConsoleMessage) }) => boolean) |

Triggered when the host application is notified of a JavaScript console message.
**message**: console message.

| +| onAlert(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) |

Triggered when **alert()** is invoked to display an alert dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows only the confirm operation) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.

| +| onBeforeUnload(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) |

Triggered when the current page is about to exit after the user refreshes or closes the page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.

| +| onConfirm(callback: (event?: { url: string; message: string; result: [JsResult](#jsresult) }) => boolean) |

Triggered when **confirm()** is invoked to display a confirmation dialog box on the web page.
If the callback returns **false**, the default dialog box is displayed. If the callback returns **true**, a system application can invoke the system dialog box capability (allows the confirm and cancel operations) and invoke the **JsResult** API to notify the **\** component of the user's operation.
**url**: URL of the web page where the dialog box is displayed.
**message**: information displayed in the dialog box.
**JsResult**: notifies the **\** component of the user's operation.

| +| onConsole(callback: (event?: { message: [ConsoleMessage](#consolemessage) }) => boolean) |

Triggered when the host application is notified of a JavaScript console message.
**message**: console message.

| | onDownloadStart(callback: (event?: { url: string, userAgent: string, contentDisposition: string, mimetype: string, contentLength: number }) => void) |

Triggered when a download task starts on the web page.
**url**: URL for the download task.
**userAgent**: name of the user agent (UA) for the download task.
**contentDisposition**: Content-Disposition response header returned by the server, which may be empty.
**mimetype**: content media type (MIME) returned by the server.
**contentLength**: length of the file returned by the server.

| -| onErrorReceive(callback: (event?: { request: [WebResourceRequest](#WebResourceError), error: [WebResourceError](#WebResourceError) }) => void) |

Triggered when an error occurs during web page loading.
For best results, simplify the implementation logic in the callback.
**request**: encapsulation of a web page request.
**error**: encapsulation of a web page resource loading error.

| -| onHttpErrorReceive(callback: (event?: { request: [WebResourceRequest](#WebResourceError), response: [WebResourceResponse](#WebResourceResponse) }) => void) |

Triggered when an HTTP error (the response code is greater than or equal to 400) occurs during web page resource loading.
**request**: encapsulation of a web page request.
**response**: encapsulation of a web page response.

| +| onErrorReceive(callback: (event?: { request: [WebResourceRequest](#webresourceerror), error: [WebResourceError](#webresourceerror) }) => void) |

Triggered when an error occurs during web page loading.
For better results, simplify the implementation logic in the callback.
**request**: encapsulation of a web page request.
**error**: encapsulation of a web page resource loading error.

| +| onHttpErrorReceive(callback: (event?: { request: [WebResourceRequest](#webresourceerror), response: [WebResourceResponse](#webresourceresponse) }) => void) |

Triggered when an HTTP error (the response code is greater than or equal to 400) occurs during web page resource loading.
**request**: encapsulation of a web page request.
**response**: encapsulation of a web page response.

| | onPageBegin(callback: (event?: { url: string }) => void) |

Triggered when the web page starts to be loaded. This API is triggered only for the main frame content, and not for the iframe or frameset content.
**url**: URL of the page.

| | onPageEnd(callback: (event?: { url: string }) => void) |

Triggered when the web page loading is complete. This API is triggered only for the main frame content.
**url**: URL of the page.

| | onProgressChange(callback: (event?: { newProgress: number }) => void) |

Triggered when the web page loading progress changes.
**newProgress**: new loading progress. The value is an integer ranging from 0 to 100.

| @@ -118,7 +118,7 @@ Represents the result returned to the **\** component to indicate the opera | Name | Description | | ------------------------------------------------------ | ---------------------------------------- | - | getRequestHeader(): Array\<[Header](#Header)\> | Obtains the information about the resource request header. | + | getRequestHeader(): Array\<[Header](#header)\> | Obtains the information about the resource request header. | | getRequestUrl(): string | Obtains the URL of the resource request. | | isMainFrame(): boolean | Checks whether the resource request is in the main frame. | | isRedirect(): boolean | Checks whether the resource request is redirected by the server. | @@ -146,12 +146,12 @@ Describes the request/response header object returned by the **\** componen | getResponseCode(): number | Obtains the status code of the resource response. | | getResponseData(): string | Obtains the data in the resource response. | | getResponseEncoding(): string | Obtains the encoding of the resource response. | - | getResponseHeader(): Array\<[Header](#Header)\> | Obtains the resource response header. | + | getResponseHeader(): Array\<[Header](#header)\> | Obtains the resource response header. | | getResponseMimeType(): string | Obtains the media (MIME) type of the resource response.| ## WebController -Defines a **webController** to control the behavior or obtain the configuration information of the **\** component. +Defines a **WebController** to control the behavior of the **\** component. A **WebController** can control only one **\** component, and the APIs in the **WebController** can be invoked only after it has been bound to the target **\** component. ### Creating an Object @@ -238,9 +238,9 @@ loadData(options: { data: string, mimeType: string, encoding: string, baseUrl?: Loads data. If **baseUrl** is empty, the specified character string will be loaded using the data protocol. -If **baseUrl** is set to a data URL, the encoded character string will be loaded by the **\** component using the data protocol. +If **baseUrl** is set to a data URL, the encoded string will be loaded by the **\** component using the data protocol. -If **baseUrl** is set to an HTTP or HTTPS URL, the encoded character string will be loaded by the **\** component as non-encoded string in a manner similar to **loadUrl**. +If **baseUrl** is set to an HTTP or HTTPS URL, the encoded string will be processed by the **\** component as a non-encoded string in a manner similar to **loadUrl**. - options @@ -267,7 +267,7 @@ Objects injected through **registerJavaScriptProxy** are still valid on a new pa | Name | Type | Mandatory| Default Value| Description | | ------- | ------------------------------------- | ---- | ------ | --------------------- | | url | string | Yes | - | URL to load. | - | headers | Array\<[Header](#Header)\> | No | [] | Additional HTTP request header of the URL.| + | headers | Array\<[Header](#header)\> | No | [] | Additional HTTP request header of the URL.| ### onActive