!7486 image权限说明修改+PR同步

Merge pull request !7486 from LiAn/OpenHarmony-3.1-Release

!7486 image权限说明修改+PR同步
Merge pull request !7486 from LiAn/OpenHarmony-3.1-Release
64b87956 · openharmony_ci · Gitee · fa7d243b · b346e5a5 · 64b87956
2 changed file
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md
 # Image

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>  **说明：**
+>
+>  该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。


 图片组件，用来渲染展示图片。


-## 权限列表
+## 权限说明

-ohos.permission.INTERNET（使用网络图片）
+使用网络图片时，需要在config.json文件对应的"abilities"中添加网络使用权限ohos.permission.INTERNET。
+
+```
+"abilities": [
+  {
+    ...
+    "permissions": ["ohos.permission.INTERNET"],
+    ...
+  }
+] 
+```


 ## 子组件
@@ -22,53 +33,53 @@ ohos.permission.INTERNET（使用网络图片）
 Image(src: string | PixelMap | Resource)

 - 参数
-  | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
-  | -------- | -------- | -------- | -------- | -------- |
-  | src |  string\|&nbsp;[PixelMap](../apis/js-apis-image.md#pixelmap7)\|&nbsp;[Resource](../../ui/ts-types.md#resource类型)| 是 | - | 图片的数据源，支持本地图片和网络图片。<br/>当使用相对路径引用图片资源时，例如`Image("common/test.jpg")`，不支持该Image组件被跨包/跨模块调用，建议使用`$r`方式来管理需全局使用的图片资源。<br/>\- 支持的图片格式包括png、jpg、bmp、svg和gif。<br/>\- 支持`Base64`字符串。格式`data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data]`, 其中`[base64 data]`为`Base64`字符串数据。<br/>\- 支持`dataability://`路径前缀的字符串，用于访问通过data&nbsp;ability提供的图片路径。 |
+  | 参数名  | 参数类型                                     | 必填   | 默认值  | 参数描述                                     |
+  | ---- | ---------------------------------------- | ---- | ---- | ---------------------------------------- |
+  | src  | string\|&nbsp;[PixelMap](../apis/js-apis-image.md#pixelmap7)\|&nbsp;[Resource](../../ui/ts-types.md#resource类型) | 是    | -    | 图片的数据源，支持本地图片和网络图片。<br/>当使用相对路径引用图片资源时，例如`Image("common/test.jpg")`，不支持该Image组件被跨包/跨模块调用，建议使用`$r`方式来管理需全局使用的图片资源。<br/>\- 支持的图片格式包括png、jpg、bmp、svg和gif。<br/>\- 支持`Base64`字符串。格式`data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data]`, 其中`[base64 data]`为`Base64`字符串数据。<br/>\- 支持`dataability://`路径前缀的字符串，用于访问通过data&nbsp;ability提供的图片路径。 |


 ## 属性

-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| alt | string \| [Resource](../../ui/ts-types.md#resource类型) | - | 加载时显示的占位图。支持本地图片和网络路径。 |
-| objectFit | ImageFit                                                | Cover | 设置图片的缩放类型。 |
-| objectRepeat | [ImageRepeat](ts-appendix-enums.md#imagerepeat枚举说明) | NoRepeat | 设置图片的重复样式。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。 |
-| interpolation | ImageInterpolation | None | 设置图片的插值效果，仅针对图片放大插值。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。<br/>>&nbsp;-&nbsp;PixelMap资源不支持该属性。 |
-| renderMode | ImageRenderMode | Original | 设置图片渲染的模式。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。 |
-| sourceSize | {<br/>width:&nbsp;number,<br/>height:&nbsp;number<br/>} | - | 设置图片解码尺寸，将原始图片解码成指定尺寸的图片，number类型单位为px。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;PixelMap资源不支持该属性。 |
-| syncLoad<sup>8+</sup> | boolean | false | 设置是否同步加载图片，默认是异步加载。同步加载时阻塞UI线程，不会显示占位图。 |
+| 名称                    | 参数类型                                     | 默认值      | 描述                                       |
+| --------------------- | ---------------------------------------- | -------- | ---------------------------------------- |
+| alt                   | string \| [Resource](../../ui/ts-types.md#resource类型) | -        | 加载时显示的占位图。支持本地图片和网络路径。                   |
+| objectFit             | ImageFit                                 | Cover    | 设置图片的缩放类型。                               |
+| objectRepeat          | [ImageRepeat](ts-appendix-enums.md#imagerepeat枚举说明) | NoRepeat | 设置图片的重复样式。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。 |
+| interpolation         | ImageInterpolation                       | None     | 设置图片的插值效果，仅针对图片放大插值。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。<br/>>&nbsp;-&nbsp;PixelMap资源不支持该属性。 |
+| renderMode            | ImageRenderMode                          | Original | 设置图片渲染的模式。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。 |
+| sourceSize            | {<br/>width:&nbsp;number,<br/>height:&nbsp;number<br/>} | -        | 设置图片解码尺寸，将原始图片解码成指定尺寸的图片，number类型单位为px。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;PixelMap资源不支持该属性。 |
+| syncLoad<sup>8+</sup> | boolean                                  | false    | 设置是否同步加载图片，默认是异步加载。同步加载时阻塞UI线程，不会显示占位图。  |

 - ImageFit枚举说明
-  | 名称 | 描述 |
-  | -------- | -------- |
-  | Cover | 保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。 |
-  | Contain | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 |
-  | Fill | 不保持宽高比进行放大缩小，使得图片填充满显示边界。 |
-  | None | 保持原有尺寸显示。通常配合objectRepeat属性一起使用。 |
-  | ScaleDown | 保持宽高比显示，图片缩小或者保持不变。 |
+  | 名称        | 描述                               |
+  | --------- | -------------------------------- |
+  | Cover     | 保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。  |
+  | Contain   | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。    |
+  | Fill      | 不保持宽高比进行放大缩小，使得图片填充满显示边界。        |
+  | None      | 保持原有尺寸显示。通常配合objectRepeat属性一起使用。 |
+  | ScaleDown | 保持宽高比显示，图片缩小或者保持不变。              |

 - ImageInterpolation枚举说明
-  | 名称 | 描述 |
-  | -------- | -------- |
-  | None | 不使用插值图片数据。 |
-  | High | 高度使用插值图片数据，可能会影响图片渲染的速度。 |
-  | Medium | 中度使用插值图片数据。 |
-  | Low | 低度使用插值图片数据。 |
+  | 名称     | 描述                       |
+  | ------ | ------------------------ |
+  | None   | 不使用插值图片数据。               |
+  | High   | 高度使用插值图片数据，可能会影响图片渲染的速度。 |
+  | Medium | 中度使用插值图片数据。              |
+  | Low    | 低度使用插值图片数据。              |

 - ImageRenderMode枚举说明
-  | 名称 | 描述 |
-  | -------- | -------- |
-  | Original | 按照原图进行渲染，包括颜色。 |
+  | 名称       | 描述                    |
+  | -------- | --------------------- |
+  | Original | 按照原图进行渲染，包括颜色。        |
  | Template | 将图像渲染为模板图像，忽略图片的颜色信息。 |


 ## 事件

-| 名称 | 功能描述 |
-| -------- | -------- |
-| onComplete(callback:&nbsp;(event?:&nbsp;{&nbsp;width:&nbsp;number,&nbsp;height:&nbsp;number,&nbsp;componentWidth:&nbsp;number,<br>&nbsp;componentHeight:&nbsp;number,&nbsp;loadingStatus:&nbsp;number&nbsp;})&nbsp;=&gt;&nbsp;void) | 图片成功加载时触发该回调，返回成功加载的图源尺寸。 |
-| onError(callback:&nbsp;(event?:&nbsp;{&nbsp;componentWidth:&nbsp;number,&nbsp;componentHeight:&nbsp;number&nbsp;})&nbsp;=&gt;&nbsp;void) | 图片加载出现异常时触发该回调。 |
+| 名称                                       | 功能描述                                     |
+| ---------------------------------------- | ---------------------------------------- |
+| onComplete(callback:&nbsp;(event?:&nbsp;{&nbsp;width:&nbsp;number,&nbsp;height:&nbsp;number,&nbsp;componentWidth:&nbsp;number,<br>&nbsp;componentHeight:&nbsp;number,&nbsp;loadingStatus:&nbsp;number&nbsp;})&nbsp;=&gt;&nbsp;void) | 图片成功加载时触发该回调，返回成功加载的图源尺寸。                |
+| onError(callback:&nbsp;(event?:&nbsp;{&nbsp;componentWidth:&nbsp;number,&nbsp;componentHeight:&nbsp;number&nbsp;})&nbsp;=&gt;&nbsp;void) | 图片加载出现异常时触发该回调。                          |
 | onFinish(callback:&nbsp;()&nbsp;=&gt;&nbsp;void) | 当加载的源文件为带动效的svg图片时，当svg动效播放完成时会触发这个回调，如果动效为无限循环动效，则不会触发这个回调。 |



--- a/zh-cn/application-dev/ui/ts-component-based-builder.md
+++ b/zh-cn/application-dev/ui/ts-component-based-builder.md
@@ -8,12 +8,12 @@
 @Entry
 @Component
 struct CompA {
-  size : number = 100;
+  size1 : number = 100;

  @Builder SquareText(label: string) {
    Text(label)
-      .width(1 * this.size)
-      .height(1 * this.size)
+      .width(1 * this.size1)
+      .height(1 * this.size1)
  }

  @Builder RowOfSquareTexts(label1: string, label2: string) {
@@ -21,8 +21,8 @@ struct CompA {
      this.SquareText(label1)
      this.SquareText(label2)
    }
-    .width(2 * this.size)
-    .height(1 * this.size)
+    .width(2 * this.size1)
+    .height(1 * this.size1)
  }

  build() {
@@ -32,12 +32,12 @@ struct CompA {
        this.SquareText("B")
        // or as long as tsc is used
      }
-      .width(2 * this.size)
-      .height(1 * this.size)
+      .width(2 * this.size1)
+      .height(1 * this.size1)
      this.RowOfSquareTexts("C", "D")
    }
-    .width(2 * this.size)
-    .height(2 * this.size)
+    .width(2 * this.size1)
+    .height(2 * this.size1)
  }
 }
 ```