fixed a24728b from https://gitee.com/esterzhou/docs/pulls/17161

Update docs (16336) Signed-off-by: N ester.zhou <ester.zhou@huawei.com>

fixed a24728b from https://gitee.com/esterzhou/docs/pulls/17161
Update docs (16336) Signed-off-by: N ester.zhou <ester.zhou@huawei.com>
51eeef30 · ester.zhou · 7e29a706 · 51eeef30 · 51eeef30
2 changed file
--- a/en/application-dev/reference/apis/js-apis-webview.md
+++ b/en/application-dev/reference/apis/js-apis-webview.md
@@ -383,6 +383,8 @@ struct WebComponent {
 }
 ```

+There are two methods for loading local resource files:
+1. Using $rawfile
 ```ts
 // xxx.ets
 import web_webview from '@ohos.web.webview'
@@ -409,6 +411,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
 <!-- xxx.html -->
 <!DOCTYPE html>

--- a/en/application-dev/reference/arkui-ts/ts-basic-components-web.md
+++ b/en/application-dev/reference/arkui-ts/ts-basic-components-web.md
@@ -68,7 +68,7 @@ Web(options: { src: ResourceStr, controller: WebviewController | WebController})
  ```

  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
     // xxx.ets
     import web_webview from '@ohos.web.webview'
@@ -518,6 +518,8 @@ multiWindowAccess(multiWindow: boolean)

 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**

 | Name        | Type   | Mandatory  | Default Value  | Description        |
@@ -537,7 +539,7 @@ Sets whether to enable the multi-window permission.
    build() {
      Column() {
        Web({ src: 'www.example.com', controller: this.controller })
-        .multiWindowAccess(true)
+        .multiWindowAccess(false)
      }
    }
  }
@@ -2555,7 +2557,9 @@ Called when the component exits full screen mode.

 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**

@@ -2571,19 +2575,50 @@ Registers a callback for window creation.
  ```ts
  // xxx.ets
  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
  @Component
  struct WebComponent {
    controller: web_webview.WebviewController = new web_webview.WebviewController()
+    dialogController: CustomDialogController = null
    build() {
      Column() {
-        Web({ src:'www.example.com', controller: this.controller })
-        .multiWindowAccess(true)
-        .onWindowNew((event) => {
-          console.log("onWindowNew...")
-          var popController: web_webview.WebviewController = new web_webview.WebviewController()
-          event.handler.setWebController(popController)
-        })
+        Web({ src: 'www.example.com', controller: this.controller })
+          .javaScriptAccess(true)
+          // MultiWindowAccess needs to be enabled.
+          .multiWindowAccess(true)
+          .onWindowNew((event) => {
+            if (this.dialogController) {
+              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)
+          })
      }
    }
  }
@@ -2593,13 +2628,13 @@ Registers a callback for window creation.

 onWindowExit(callback: () => void)

-Registers a callback for window closure.
+Called when this window is closed.

 **Parameters**

 | Name     | Type      | Description        |
 | -------- | ---------- | ------------ |
-| callback | () => void | Callback invoked when the window closes.|
+| callback | () => void | Callback invoked when the window is closed.|

 **Example**

@@ -2728,7 +2763,7 @@ Called when the old page is not displayed and the new page is about to be visibl

 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**

@@ -2740,7 +2775,7 @@ Called when the key event is intercepted and before it is consumed by the Webvie

 | 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**

@@ -2932,13 +2967,13 @@ Implements a **WebviewController** object for new **\<Web>** components. For the

 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**

 | 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

@@ -3032,6 +3067,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).|

+### getRequestMethod<sup>9+</sup>
+
+getRequestMethod(): string
+
+Obtains the request method.
+
+**Return value**
+
+| Type     | Description                  |
+| ------- | -------------------- |
+| string | Request method.|
+
 ## Header

 Describes the request/response header returned by the **\<Web>** component.