!14832 web资料中接口accessForward和postMessage修改（Beta5）

Merge pull request !14832 from 李想/OpenHarmony-3.2-Beta5

!14832 web资料中接口accessForward和postMessage修改（Beta5）
Merge pull request !14832 from 李想/OpenHarmony-3.2-Beta5
e6d86bfd · openharmony_ci · Gitee · 62c97833 · 1b1a6eda · e6d86bfd
2 changed file
--- a/zh-cn/application-dev/reference/apis/js-apis-webview.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-webview.md
@@ -19,7 +19,7 @@
 import web_webview from '@ohos.web.webview';
 ```
-### once
+## once
 once(type: string, callback: Callback\<void\>): void
@@ -42,7 +42,7 @@ import web_webview from '@ohos.web.webview'
 web_webview.once("webInited", () => {
  console.log("setCookie")
-  web_webview.WebCookieManager.setCookie("www.example.com", "a=b")
+  web_webview.WebCookieManager.setCookie("https://www.example.com", "a=b")
 })
 @Entry
@@ -337,7 +337,6 @@ struct WebComponent {
          }
        })
      Web({ src: 'www.example.com', controller: this.controller })
-      .webDebuggingAccess(true)
    }
  }
 }
@@ -437,7 +436,34 @@ struct WebComponent {
 }
 ```
-### accessforward
+加载本地资源
+```ts
+// xxx.ets
+import web_webview from '@ohos.web.webview'
+@Entry
+@Component
+struct WebComponent {
+  controller: web_webview.WebviewController = new web_webview.WebviewController();
+  updataContent: string = '<body><div><image src=file:///data/storage/el1/bundle/entry/resources/rawfile/xxx.png alt="image -- end" width="500" height="250"></image></div></body>'
+  build() {
+    Column() {
+      Button('loadData')
+        .onClick(() => {
+          try {
+            this.controller.loadData(this.updataContent, "text/html", "UTF-8", " ", " ");
+          } catch (error) {
+            console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
+          }
+        })
+      Web({ src: 'www.example.com', controller: this.controller })
+    }
+  }
+}
+```
+### accessForward
 accessForward(): boolean
@@ -1564,7 +1590,7 @@ struct WebComponent {
        .onClick(() => {
          try {
            if (this.ports && this.ports[1]) {
-              this.ports[1].postMessageEvent("this.sendFromEts");
+              this.ports[1].postMessageEvent(this.sendFromEts);
            } else {
              console.error(`ports is null, Please initialize first`);
            }
@@ -3173,7 +3199,7 @@ struct WebComponent {
      Button('getCookie')
        .onClick(() => {
          try {
-            let value = web_webview.WebCookieManager.getCookie('www.example.com');
+            let value = web_webview.WebCookieManager.getCookie('https://www.example.com');
            console.log("value: " + value);
          } catch (error) {
            console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
@@ -3225,7 +3251,7 @@ struct WebComponent {
      Button('setCookie')
        .onClick(() => {
          try {
-            web_webview.WebCookieManager.setCookie('www.example.com', 'a=b');
+            web_webview.WebCookieManager.setCookie('https://www.example.com', 'a=b');
          } catch (error) {
            console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
          }
@@ -4093,9 +4119,6 @@ struct WebComponent {
          try {
            this.username_password = web_webview.WebDataBase.getHttpAuthCredentials(this.host, this.realm);
            console.log('num: ' + this.username_password.length);
-            ForEach(this.username_password, (item) => {
-              console.log('username_password: ' + item);
-            }, item => item)
          } catch (error) {
            console.error(`ErrorCode: ${error.code}, Message: ${error.message}`);
          }

--- 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
@@ -16,7 +16,7 @@
 ## 接口
-Web(options: { src: ResourceStr, controller: WebController | WebviewController})
+Web(options: { src: ResourceStr, controller: WebviewController | WebController})
 > **说明：**
 >
@@ -28,26 +28,13 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController})
 | 参数名        | 参数类型                                     | 必填   | 参数描述    |
 | ---------- | ---------------------------------------- | ---- | ------- |
 | src        | [ResourceStr](ts-types.md)               | 是    | 网页资源地址。 |
-| controller | [WebController](#webcontroller) \| [WebviewController<sup>9+</sup>](../apis/js-apis-webview.md#webviewcontroller) | 是    | 控制器。    |
+| controller | [WebviewController<sup>9+</sup>](../apis/js-apis-webview.md#webviewcontroller) \| [WebController](#webcontroller) | 是    | 控制器。从API Version 9开始，WebController不在维护，建议使用WebviewController替代。 |
 **示例：**
  加载在线网页
  ```ts
  // xxx.ets
-  @Entry
-  @Component
-  struct WebComponent {
-    controller: WebController = new WebController()
-    build() {
-      Column() {
-        Web({ src: 'www.example.com', controller: this.controller })
-      }
-    }
-  }
-  ```
-  ```ts
-  // xxx.ets
  import web_webview from '@ohos.web.webview'
  @Entry
@@ -68,7 +55,7 @@ Web(options: { src: ResourceStr, controller: WebController | WebviewController})
  @Entry
  @Component
  struct WebComponent {
-    controller: WebController = new WebController()
+    controller: web_webview.WebviewController = new web_webview.WebviewController()
    build() {
      Column() {
        Web({ src: $rawfile("index.html"), controller: this.controller })
@@ -191,7 +178,7 @@ javaScriptProxy(javaScriptProxy: { object: object, name: string, methodList: Arr
 | object     | object                                   | 是    | -    | 参与注册的对象。只能声明方法，不能声明属性。    |
 | name       | string                                   | 是    | -    | 注册对象的名称，与window中调用的对象名一致。 |
 | methodList | Array\<string\>                          | 是    | -    | 参与注册的应用侧JavaScript对象的方法。  |
-| controller | [WebController](#webcontroller) 或 [WebviewController](../apis/js-apis-webview.md#webviewcontroller) | 是    | -    | 控制器。                      |
+| controller | [WebController](#webcontroller) \| [WebviewController](../apis/js-apis-webview.md#webviewcontroller) | 是    | -    | 控制器。                      |
 **示例：**
@@ -468,7 +455,7 @@ geolocationAccess(geolocationAccess: boolean)
 mediaPlayGestureAccess(access: boolean)
-设置有声视频播放是否需要用户手动点击，静音视频播放不受该接口管控。
+设置有声视频播放是否需要用户手动点击，静音视频播放不受该接口管控，默认需要。
 **参数：**
@@ -1184,7 +1171,7 @@ forceDarkAccess(access: boolean)
 pinchSmooth(isEnabled: boolean)
-设置网页是否开启捏合流畅模式。
+设置网页是否开启捏合流畅模式，默认不开启。
 **参数：**
@@ -4963,7 +4950,7 @@ setCookie(url: string, value: string): boolean
      Column() {
        Button('setCookie')
          .onClick(() => {
-            let result = this.controller.getCookieManager().setCookie("www.example.com", "a=b")
+            let result = this.controller.getCookieManager().setCookie("https://www.example.com", "a=b")
            console.log("result: " + result)
          })
        Web({ src: 'www.example.com', controller: this.controller })