未验证 提交 35d1ac21 编写于 作者: O openharmony_ci 提交者: Gitee

!17161 【3.2-Beta5】翻译完成 16336+16714+16716

Merge pull request !17161 from ester.zhou/C05-16336
...@@ -26,4 +26,4 @@ If the compilation is successful, export the files in the **out/sdk/packages/oho ...@@ -26,4 +26,4 @@ If the compilation is successful, export the files in the **out/sdk/packages/oho
## Replacing the SDK ## Replacing the SDK
After the full SDK is compiled, switch to it in DevEco Studio. For details, see [Guide to Switching to Full SDK](../../application-dev/quick-start/full-sdk-switch-guide.md). After the full SDK is compiled, switch to it in DevEco Studio. For details, see [Guide to Switching to Full SDK](full-sdk-switch-guide.md).
...@@ -343,6 +343,8 @@ struct WebComponent { ...@@ -343,6 +343,8 @@ struct WebComponent {
} }
``` ```
There are two methods for loading local resource files:
1. Using $rawfile
```ts ```ts
// xxx.ets // xxx.ets
import web_webview from '@ohos.web.webview' import web_webview from '@ohos.web.webview'
...@@ -369,6 +371,8 @@ struct WebComponent { ...@@ -369,6 +371,8 @@ struct WebComponent {
} }
``` ```
2. Using a sandbox path. For details, see the example of loading local resource files in the sandbox in [Web](../arkui-ts/ts-basic-components-web.md#web).
```html ```html
<!-- xxx.html --> <!-- xxx.html -->
<!DOCTYPE html> <!DOCTYPE html>
......
...@@ -65,7 +65,7 @@ Web(options: { src: ResourceStr, controller: WebviewController | WebController}) ...@@ -65,7 +65,7 @@ Web(options: { src: ResourceStr, controller: WebviewController | WebController})
``` ```
Example of loading local resource files in the sandbox: Example of loading local resource files in the sandbox:
1. Use[globalthis](../../application-models/uiability-data-sync-with-ui.md#using-globalthis-between-uiability-and-page) to obtain the path of the sandbox. 1. Use [globalthis](../../application-models/uiability-data-sync-with-ui.md#using-globalthis-between-uiability-and-page) to obtain the path of the sandbox.
```ts ```ts
// xxx.ets // xxx.ets
import web_webview from '@ohos.web.webview' import web_webview from '@ohos.web.webview'
...@@ -524,6 +524,8 @@ multiWindowAccess(multiWindow: boolean) ...@@ -524,6 +524,8 @@ multiWindowAccess(multiWindow: boolean)
Sets whether to enable the multi-window permission. Sets whether to enable the multi-window permission.
Enabling the multi-window permission requires implementation of the **onWindowNew** event. For details about the sample code, see [onWindowNew](#onwindownew9).
**Parameters** **Parameters**
| Name | Type | Mandatory | Default Value | Description | | Name | Type | Mandatory | Default Value | Description |
...@@ -541,7 +543,7 @@ Sets whether to enable the multi-window permission. ...@@ -541,7 +543,7 @@ Sets whether to enable the multi-window permission.
build() { build() {
Column() { Column() {
Web({ src: 'www.example.com', controller: this.controller }) Web({ src: 'www.example.com', controller: this.controller })
.multiWindowAccess(true) .multiWindowAccess(false)
} }
} }
} }
...@@ -2524,7 +2526,9 @@ Called when the component exits full screen mode. ...@@ -2524,7 +2526,9 @@ Called when the component exits full screen mode.
onWindowNew(callback: (event: {isAlert: boolean, isUserTrigger: boolean, targetUrl: string, handler: ControllerHandler}) => void) onWindowNew(callback: (event: {isAlert: boolean, isUserTrigger: boolean, targetUrl: string, handler: ControllerHandler}) => void)
Registers a callback for window creation. Called when a new window is created. This API takes effect when **multiWindowAccess** is enabled.
If the **event.handler.setWebController** API is not called, the render process will be blocked.
If opening a new window is not needed, set the parameter to **null** when calling the **event.handler.setWebController** API.
**Parameters** **Parameters**
...@@ -2540,17 +2544,48 @@ Registers a callback for window creation. ...@@ -2540,17 +2544,48 @@ Registers a callback for window creation.
```ts ```ts
// xxx.ets // xxx.ets
import web_webview from '@ohos.web.webview' import web_webview from '@ohos.web.webview'
// There are two <Web> components on the same page. When the WebComponent object opens a new window, the NewWebViewComp object is displayed.
@CustomDialog
struct NewWebViewComp {
controller: CustomDialogController
webviewController1: web_webview.WebviewController
build() {
Column() {
Web({ src: "", controller: this.webviewController1 })
.javaScriptAccess(true)
.multiWindowAccess(false)
.onWindowExit(()=> {
console.info("NewWebViewComp onWindowExit")
this.controller.close()
})
}
}
}
@Entry @Entry
@Component @Component
struct WebComponent { struct WebComponent {
controller: web_webview.WebviewController = new web_webview.WebviewController() controller: web_webview.WebviewController = new web_webview.WebviewController()
dialogController: CustomDialogController = null
build() { build() {
Column() { Column() {
Web({ src:'www.example.com', controller: this.controller }) Web({ src: 'www.example.com', controller: this.controller })
.javaScriptAccess(true)
// MultiWindowAccess needs to be enabled.
.multiWindowAccess(true) .multiWindowAccess(true)
.onWindowNew((event) => { .onWindowNew((event) => {
console.log("onWindowNew...") if (this.dialogController) {
var popController: web_webview.WebviewController = new web_webview.WebviewController() this.dialogController.close()
}
let popController:web_webview.WebviewController = new web_webview.WebviewController()
this.dialogController = new CustomDialogController({
builder: NewWebViewComp({webviewController1: popController})
})
this.dialogController.open()
// Return the WebviewController object corresponding to the new window to the <Web> kernel.
// If opening a new window is not needed, set the parameter to null when calling the event.handler.setWebController API.
// If the event.handler.setWebController API is not called, the render process will be blocked.
event.handler.setWebController(popController) event.handler.setWebController(popController)
}) })
} }
...@@ -2562,13 +2597,13 @@ Registers a callback for window creation. ...@@ -2562,13 +2597,13 @@ Registers a callback for window creation.
onWindowExit(callback: () => void) onWindowExit(callback: () => void)
Registers a callback for window closure. Called when this window is closed.
**Parameters** **Parameters**
| Name | Type | Description | | Name | Type | Description |
| -------- | ---------- | ------------ | | -------- | ---------- | ------------ |
| callback | () => void | Callback invoked when the window closes.| | callback | () => void | Callback invoked when the window is closed.|
**Example** **Example**
...@@ -2693,7 +2728,7 @@ Called when the old page is not displayed and the new page is about to be visibl ...@@ -2693,7 +2728,7 @@ Called when the old page is not displayed and the new page is about to be visibl
onInterceptKeyEvent(callback: (event: KeyEvent) => boolean) onInterceptKeyEvent(callback: (event: KeyEvent) => boolean)
Called when the key event is intercepted and before it is consumed by the Webview. Called when the key event is intercepted and before it is consumed by the webview.
**Parameters** **Parameters**
...@@ -2705,7 +2740,7 @@ Called when the key event is intercepted and before it is consumed by the Webvie ...@@ -2705,7 +2740,7 @@ Called when the key event is intercepted and before it is consumed by the Webvie
| Type | Description | | Type | Description |
| ------- | ------------------------------------------------------------ | | ------- | ------------------------------------------------------------ |
| boolean | Whether to continue to transfer the key event to the Webview kernel.| | boolean | Whether to continue to transfer the key event to the webview kernel.|
**Example** **Example**
...@@ -2897,13 +2932,13 @@ Implements a **WebviewController** object for new **\<Web>** components. For the ...@@ -2897,13 +2932,13 @@ Implements a **WebviewController** object for new **\<Web>** components. For the
setWebController(controller: WebviewController): void setWebController(controller: WebviewController): void
Sets a **WebviewController** object. Sets a **WebviewController** object. If opening a new window is not needed, set the parameter to **null**.
**Parameters** **Parameters**
| Name | Type | Mandatory | Default Value | Description | | Name | Type | Mandatory | Default Value | Description |
| ---------- | ------------- | ---- | ---- | ------------------------- | | ---------- | ------------- | ---- | ---- | ------------------------- |
| controller | [WebviewController](../apis/js-apis-webview.md#webviewcontroller) | Yes | - | **WebviewController** object of the **\<Web>** component.| | controller | [WebviewController](../apis/js-apis-webview.md#webviewcontroller) | Yes | - | **WebviewController** object of the **\<Web>** component. If opening a new window is not needed, set it to **null**.|
## WebResourceError ## WebResourceError
...@@ -2997,6 +3032,18 @@ Checks whether the resource request is associated with a gesture (for example, a ...@@ -2997,6 +3032,18 @@ Checks whether the resource request is associated with a gesture (for example, a
| ------- | -------------------- | | ------- | -------------------- |
| boolean | Whether the resource request is associated with a gesture (for example, a tap).| | boolean | Whether the resource request is associated with a gesture (for example, a tap).|
### getRequestMethod<sup>9+</sup>
getRequestMethod(): string
Obtains the request method.
**Return value**
| Type | Description |
| ------- | -------------------- |
| string | Request method.|
## Header ## Header
Describes the request/response header returned by the **\<Web>** component. Describes the request/response header returned by the **\<Web>** component.
...@@ -3191,7 +3238,7 @@ Implements the **FileSelectorParam** object. For the sample code, see [onShowFil ...@@ -3191,7 +3238,7 @@ Implements the **FileSelectorParam** object. For the sample code, see [onShowFil
getTitle(): string getTitle(): string
Obtains the title of the file selector. Obtains the title of this file selector.
**Return value** **Return value**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册