!9414 VOD修改

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

!9414 VOD修改
Merge pull request !9414 from LiAn/OpenHarmony-3.1-Release
4973650e · openharmony_ci · Gitee · 8857ef18 · 5e6cd010 · 4973650e
9 changed file
--- a/zh-cn/application-dev/reference/apis/js-apis-prompt.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-prompt.md
 # 弹窗

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明**
+创建并显示文本提示框、对话框和操作菜单。
+
+> **说明：**
+>
 > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 导入模块

-```
+```js
 import prompt from '@ohos.prompt'
 ```
-## 权限列表
-
-无

 ## prompt.showToast

@@ -21,32 +21,31 @@ showToast(options: ShowToastOptions): void
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full

 **参数：**
+
 | 参数名     | 类型                                    | 必填   | 说明      |
 | ------- | ------------------------------------- | ---- | ------- |
 | options | [ShowToastOptions](#showtoastoptions) | 是    | 文本弹窗选项。 |

 **示例：**
-  ```
-  export default {    
-    showToast() {        
-      prompt.showToast({            
+
+```js
+prompt.showToast({            
  message: 'Message Info',
    duration: 2000,      
-      });
-    }
-  }
-  ```
+});
+```
+
 ## ShowToastOptions

 文本提示框的选项。

-**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full。

 | 名称       | 类型              | 必填   | 说明                                       |
-| -------- | -------------- | ---- | ---------------------------------------- |
+| -------- | --------------- | ---- | ---------------------------------------- |
 | message  | string          | 是    | 显示的文本信息。                                 |
 | duration | number          | 否    | 默认值1500ms，取值区间：1500ms-10000ms。若小于1500ms则取默认值，若大于10000ms则取上限值10000ms。 |
-| bottom   | &lt;length&gt; | 否    | 设置弹窗边框距离屏幕底部的位置。                         |
+| bottom   | string\| number | 否    | 设置弹窗边框距离屏幕底部的位置。                         |

 ## prompt.showDialog

@@ -57,6 +56,7 @@ showDialog(options: ShowDialogOptions): Promise&lt;ShowDialogSuccessResponse&gt;
 **系统能力：**  SystemCapability.ArkUI.ArkUI.Full

 **参数：**
+
 | 参数名     | 类型                                      | 必填   | 说明     |
 | ------- | --------------------------------------- | ---- | ------ |
 | options | [ShowDialogOptions](#showdialogoptions) | 是    | 对话框选项。 |
@@ -69,10 +69,8 @@ showDialog(options: ShowDialogOptions): Promise&lt;ShowDialogSuccessResponse&gt;

 **示例：**

-  ```
-  export default {
-    showDialog() {
-      prompt.showDialog({
+```js
+prompt.showDialog({
  title: 'Title Info',
  message: 'Message Info',
  buttons: [
@@ -85,16 +83,14 @@ showDialog(options: ShowDialogOptions): Promise&lt;ShowDialogSuccessResponse&gt;
      color: '#000000',
    }
  ],
-      })
+})
  .then(data => {
    console.info('showDialog success, click button: ' + data.index);
  })
  .catch(err => {
    console.info('showDialog error: ' + err);
  })
-    }
-  }
-  ```
+```

 ## prompt.showDialog

@@ -104,25 +100,17 @@ showDialog(options: ShowDialogOptions, callback: AsyncCallback&lt;ShowDialogSucc

 **系统能力：**  SystemCapability.ArkUI.ArkUI.Full

-
 **参数：**
+
 | 参数名      | 类型                                       | 必填   | 说明           |
 | -------- | ---------------------------------------- | ---- | ------------ |
 | options  | [ShowDialogOptions](#showdialogoptions)  | 是    | 页面显示对话框信息描述。 |
 | callback | AsyncCallback&lt;[ShowDialogSuccessResponse](#showdialogsuccessresponse)&gt; | 是    | 对话框响应结果回调。   |

 **示例：**
-  ```
-  export default {
-    callback(err, data) {
-      if(err) {
-        console.info('showDialog err: ' + err);
-        return;
-      }
-      console.info('showDialog success callback, click button: ' + data.index);
-    },
-    showDialog() {
-      prompt.showDialog({
+
+```js
+prompt.showDialog({
  title: 'showDialog Title Info',
  message: 'Message Info',
  buttons: [
@@ -135,19 +123,23 @@ showDialog(options: ShowDialogOptions, callback: AsyncCallback&lt;ShowDialogSucc
      color: '#000000',
    }
  ]
-      }, this.callback);
-    }
+}, (err, data) => {
+  if (err) {
+    console.info('showDialog err: ' + err);
+    return;
  }
-  ```
+  console.info('showDialog success callback, click button: ' + data.index);
+});
+```

 ## ShowDialogOptions

 对话框的选项。

-**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full

 | 名称      | 类型      | 必填   | 说明                                       |
-| ------- | ------ | ---- | ---------------------------------------- |
+| ------- | ------- | ---- | ---------------------------------------- |
 | title   | string | 否    | 标题文本。                                    |
 | message | string  | 否    | 内容文本。                                    |
 | buttons | Array   | 否    | 对话框中按钮的数组，结构为：{text:'button',&nbsp;color:&nbsp;'\#666666'}，支持1-3个按钮。其中第一个为positiveButton；第二个为negativeButton；第三个为neutralButton。 |
@@ -156,7 +148,7 @@ showDialog(options: ShowDialogOptions, callback: AsyncCallback&lt;ShowDialogSucc

 对话框的响应结果。

-**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+**系统能力：**  SystemCapability.ArkUI.ArkUI.Full

 | 名称    | 类型     | 说明                  |
 | ----- | ------ | ------------------- |
@@ -172,6 +164,7 @@ showActionMenu(options: ActionMenuOptions, callback: AsyncCallback&lt;ActionMenu
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。

 **参数：**
+
 | 参数名      | 类型                                       | 必填   | 说明        |
 | -------- | ---------------------------------------- | ---- | --------- |
 | options  | [ActionMenuOptions](#actionmenuoptions)  | 是    | 操作菜单选项。   |
@@ -179,17 +172,9 @@ showActionMenu(options: ActionMenuOptions, callback: AsyncCallback&lt;ActionMenu


 **示例：**
-  ```
-  export default {
-    callback(err, data) {
-      if(err) {
-        console.info('showActionMenu err: ' + err);
-        return;
-      }
-      console.info('showActionMenu success callback, click button: ' + data.index);
-    },
-    showActionMenu() {
-      prompt.showActionMenu({
+
+```js
+prompt.showActionMenu({
  title: 'Title Info',
  buttons: [
    {
@@ -201,34 +186,39 @@ showActionMenu(options: ActionMenuOptions, callback: AsyncCallback&lt;ActionMenu
      color: '#000000',
    },
  ]
-      }, this.callback)
-    }
+}, (err, data) => {
+  if (err) {
+    console.info('showActionMenu err: ' + err);
+    return;
  }
-  ```
+  console.info('showActionMenu success callback, click button: ' + data.index);
+})
+```

 ## prompt.showActionMenu

-showActionMenu(options: ActionMenuOptions): Promise\<ActionMenuSuccessResponse>
+showActionMenu(options: ActionMenuOptions): Promise&lt;ActionMenuSuccessResponse&gt;

 创建并显示操作菜单，菜单响应后同步返回结果。

 **系统能力：** SystemCapability.ArkUI.ArkUI.Full

 **参数：**
+
 | 参数名     | 类型                                      | 必填   | 说明      |
 | ------- | --------------------------------------- | ---- | ------- |
 | options | [ActionMenuOptions](#actionmenuoptions) | 是    | 操作菜单选项。 |

 **返回值：**
+
 | 类型                                       | 说明      |
 | ---------------------------------------- | ------- |
 | Promise&lt;[ActionMenuSuccessResponse](#actionmenusuccessresponse)&gt; | 菜单响应结果。 |

 **示例：**
-  ```
-  export default {
-    showActionMenu() {
-      prompt.showActionMenu({
+
+```js
+prompt.showActionMenu({
  title: 'showActionMenu Title Info',
  buttons: [
    {
@@ -240,34 +230,42 @@ showActionMenu(options: ActionMenuOptions): Promise\<ActionMenuSuccessResponse>
      color: '#000000',
    },
  ]
-      })
+})
  .then(data => {
    console.info('showActionMenu success, click button: ' + data.index);
  })
  .catch(err => {
    console.info('showActionMenu error: ' + err);
  })
-    }
-  }
-  ```
+```
 ## ActionMenuOptions

 操作菜单的选项。

-**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full。

 | 名称      | 类型                             | 必填   | 说明                                       |
-| ------- | ------ | ---- | ---------------------------------------- |
+| ------- | ------------------------------ | ---- | ---------------------------------------- |
 | title   | string                         | 否    | 标题文本。                                    |
-| buttons | Array  | 是    | 菜单中菜单项按钮的数组，结构为：{text:'button',&nbsp;color:&nbsp;'\#666666'}，支持1-6个按钮。大于6个按钮时弹窗不显示。 |
+| buttons | Array&lt;[Button](#button)&gt; | 是    | 菜单中菜单项按钮的数组，结构为：{text:'button',&nbsp;color:&nbsp;'\#666666'}，支持1-6个按钮。大于6个按钮时弹窗不显示。 |

 ## ActionMenuSuccessResponse

 操作菜单的响应结果。

-**系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full

 | 名称    | 类型     | 必填   | 说明                       |
 | ----- | ------ | ---- | ------------------------ |
 | index | number | 否    | 选中按钮在buttons数组中的索引，从0开始。 |

+## Button
+
+菜单中的菜单项按钮。
+
+**系统能力：** SystemCapability.ArkUI.ArkUI.Full
+
+| 名称    | 类型     | 必填   | 说明      |
+| ----- | ------ | ---- | ------- |
+| text  | string | 是    | 按钮文本内容。 |
+| color | string | 是    | 按钮文本颜色。 |
--- 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
@@ -6,21 +6,9 @@
 >
 >  该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

+## 需要权限

-## 权限说明
-
-使用网络图片时，需要在config.json文件对应的"abilities"中添加网络使用权限ohos.permission.INTERNET。
-
-```
-"abilities": [
-  {
-    ...
-    "permissions": ["ohos.permission.INTERNET"],
-    ...
-  }
-] 
-```
-
+使用网络图片时，需要申请权限ohos.permission.INTERNET。具体申请方式请参考[权限申请声明](../../security/accesstoken-guidelines.md)。

 ## 子组件

@@ -34,13 +22,13 @@ Image(src: string | PixelMap | Resource)
 **参数：**

 | 参数名  | 参数类型                                     | 必填   | 默认值  | 参数描述                                     |
-| ------ | ------------------------------------------------------------ | ---- | ------ | ------------------------------------------------------------ |
+| ---- | ---------------------------------------- | ---- | ---- | ---------------------------------------- |
 | src  | string\|&nbsp;[PixelMap](../apis/js-apis-image.md#pixelmap7)\|&nbsp;[Resource](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](ts-types.md#resource) | -        | 加载时显示的占位图。支持本地图片和网络路径。                   |
 | objectFit             | [ImageFit](ts-appendix-enums.md#imagefit) | Cover    | 设置图片的缩放类型。                               |
 | objectRepeat          | [ImageRepeat](ts-appendix-enums.md#imagerepeat枚举说明) | NoRepeat | 设置图片的重复样式。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;-&nbsp;svg类型图源不支持该属性。 |

--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-timepicker.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-timepicker.md
@@ -21,7 +21,7 @@

 TimePicker(options?: {selected?: Date})

-默认以00：00至23：59的时间区间创建滑动选择器。
+默认以00: 00至23: 59的时间区间创建滑动选择器。

 **参数：**


--- a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
@@ -6,20 +6,9 @@
 >
 >  该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

-## 权限列表
-
-使用网络视频时，需要在config或者module.json对应的"abilities"中添加网络使用权限ohos.permission.INTERNET。
-
-```
-"abilities":[
-  {
-    ...
-    "permissions": ["ohos.permission.INTERNET"],
-    ...
-  }
-]
-```
+## 需要权限

+使用网络视频时，需要申请权限ohos.permission.INTERNET。具体申请方式请参考[权限申请声明](../../security/accesstoken-guidelines.md)。

 ## 子组件

@@ -33,7 +22,7 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
 **参数：**

 | 参数名                 | 参数类型                                     | 必填   | 默认值                                      | 参数描述                                     |
-| ------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------- | ------------------------------------------------------------ |
+| ------------------- | ---------------------------------------- | ---- | ---------------------------------------- | ---------------------------------------- |
 | src                 | string \| [Resource](ts-types.md#resource) | 否    | -                                        | 视频播放源的路径，支持本地视频路径和网络路径。<br>支持在resources下面的video或rawfile文件夹里放置媒体资源。<br>支持dataability://的路径前缀，用于访问通过Data Ability提供的视频路径，具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。 |
 | currentProgressRate | number&nbsp;\|&nbsp;PlaybackSpeed<sup>8+</sup> | 否    | 1.0&nbsp;\|&nbsp;PlaybackSpeed.<br>Speed_Forward_1_00_X | 视频播放倍速。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;number取值仅支持：0.75，1.0，1.25，1.75，2.0。<br/> |
 | previewUri          | string&nbsp;\|&nbsp;PixelMap<sup>8+</sup>&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 否    | -                                        | 预览图片的路径。                                 |

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-enable.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-enable.md
 # 禁用控制

+组件是否可交互，可交互状态下响应[点击事件](ts-universal-events-click.md)、[触摸事件](ts-universal-events-touch.md)、[拖拽事件](ts-universal-events-drag-drop.md)、[按键事件](ts-universal-events-key.md)、[焦点事件](ts-universal-focus-event.md)和[鼠标事件](ts-universal-mouse-key.md)。
+
 >  **说明：**
+>
 >  从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。


-## 权限列表
-
-无
-
-
 ## 属性


 | 名称      | 参数类型    | 默认值  | 描述                                       |
-| -------- | -------- | -------- | -------- |
-| enabled | boolean | true | 值为true表示组件可用，可响应点击等操作；值为false时，不响应点击等操作。 | 
+| ------- | ------- | ---- | ---------------------------------------- |
+| enabled | boolean | true | 值为true表示组件可交互，响应点击等操作。<br>值为false表示组件不可交互，不响应点击等操作。<br>默认值：true |


 ## 示例

--- a/zh-cn/application-dev/reference/js-service-widget-ui/Readme-CN.md
+++ b/zh-cn/application-dev/reference/js-service-widget-ui/Readme-CN.md
@@ -2,7 +2,6 @@

 - JS服务卡片UI框架说明
    - [文件组织](js-service-widget-file.md)
-    - [配置文件](js-service-widget-config-file.md)
    - 语法
        - [HML语法参考](js-service-widget-syntax-hml.md)
        - [CSS语法参考](js-service-widget-syntax-css.md)

--- a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-config-file.md
+++ b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-config-file.md
-# 配置文件
-
-
-js标签中包含了实例名称、窗口样式和卡片页面信息。
-
-
-| 标签     | 类型     | 默认值     | 必填   | 描述                          |
-| ------ | ------ | ------- | ---- | --------------------------- |
-| name   | String | default | 是    | 标识JS实例的名字。                  |
-| pages  | Array  | -       | 是    | 路由信息，详见“[pages](#pages)”。   |
-| window | Object | -       | 否    | 窗口信息，详见“[window](#window)”。 |
-
-> **说明：**
-> name、pages、window等标签配置需在[配置文件]()中的“js”标签中完成设置。
-
-
-## pages
-
-定义卡片页面信息，由卡片页面路径和卡片页面名组成，卡片仅包含一个页面。比如：
-
-
-```
-{
-  ...
-  "src": "./js/widget/pages/index/index" //卡片仅包含一个页面
-  ...
-}
-```
-
-
->  **说明：**
->  - pages列表中仅包含一个页面。
->
->  - 页面文件名不能使用组件名称，比如：text.hml、button.hml等。
-
-
-## window
-
-window用于定义与显示窗口相关的配置。对于卡片尺寸适配问题，有2种配置方法，建议使用autoDesignWidth：
-
- 指定卡片designWidth 150px（2×2），所有与大小相关的样式（例如width、font-size）均以designWidth和实际卡片宽度的比例进行缩放，例如在designWidth为150时，如果设置width为100px时，在卡片实际宽度为300物理像素时，width实际渲染像素为200物理像素。
-
- 设置autoDesignWidth为true，此时designWidth字段将会被忽略，渲染组件和布局时按屏幕密度进行缩放。屏幕逻辑宽度由设备宽度和屏幕密度自动计算得出，在不同设备上可能不同，请使用相对布局来适配多种设备。例如：在466\*466分辨率，320dpi的设备上，屏幕密度为2（以160dpi为基准），1px等于渲染出的2物理像素。
-  > **说明：**
-  > - 组件样式中&lt;length&gt;类型的默认值，按屏幕密度进行计算和绘制，如：在屏幕密度为2（以160dpi为基准）的设备上，默认&lt;length&gt;为1px时，设备上实际渲染出2物理像素。
-  >
-  > - autoDesignWidth、designWidth的设置不影响默认值计算方式和绘制结果。
-
-| 属性              | 类型      | 必填   | 默认值   | 描述                                       |
-| --------------- | ------- | ---- | ----- | ---------------------------------------- |
-| designWidth     | number  | 否    | 150px | 页面显示设计时的参考值，实际显示效果基于设备宽度与参考值之间的比例进行缩放。   |
-| autoDesignWidth | boolean | 否    | false | 页面设计基准宽度是否自动计算，当设为true时，designWidth将会被忽略，设计基准宽度由设备宽度与屏幕密度计算得出。 |
-
-  示例如下：
-    {
-      ...
-      "window": {
-        "autoDesignWidth": true
-      }
-      ...
-    }
-
-
-## 示例
-
-
-```json
-{
-  "forms": [
-    {
-      "name": "widget",
-      "description": "This is a service widget.",
-      "src": "./js/widget/pages/index/index",
-      "window": {
-        "designWidth": 720,
-        "autoDesignWidth": true
-      },
-      "colorMode": "auto",
-      "isDefault": true,
-      "updateEnabled": true,
-      "scheduledUpdateTime": "10:30",
-      "updateDuration": 1,
-      "defaultDimension": "2*2",
-      "supportDimensions": [
-        "1*2","2*2","2*4","4*4"
-      ],
-      "formConfigAbility": "ability://xxxxx"
-    }
-  ]
-}
-```
--- a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-file.md
+++ b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-file.md
@@ -55,3 +55,9 @@ JS服务卡片(entry/src/main/js/Widget)的典型开发目录结构如下：
 > - 如果代码文件A和文件B位于不同目录，则代码文件B引用资源文件时必须使用绝对路径。因为Webpack打包时，代码文件B的目录会发生变化。
 >
 > - 在json文件中定义的数据为资源文件路径时，需使用绝对路径。
+
+## 配置文件
+
+FA卡片需要在应用配置文件config.json中进行配置。详细的配置内容请参考[FA卡片配置文件说明](../../ability/fa-formability.md#配置卡片配置文件)。
+
+Stage卡片需要在应用配置文件module.json5中的extensionAbilities标签下，配置ExtensionAbility相关信息。详细的配置内容请参考[Stage卡片配置文件说明](../../ability/stage-formextension.md#配置卡片配置文件)。
\ No newline at end of file
--- a/zh-cn/application-dev/ui/ui-ts-building-data-model.md
+++ b/zh-cn/application-dev/ui/ui-ts-building-data-model.md
@@ -50,7 +50,15 @@

 3. 存入食物图片资源。在resources &gt;base&gt; media目录下存入食物图片资源，图片名称为食物名称。

-4. 创建食物资源数据。在model文件夹下创建FoodDataModels.ets，在该页面中声明食物成分数组FoodComposition。
+4. 创建食物资源数据。在model文件夹下创建FoodDataModels.ets，在该页面中声明食物成分数组FoodComposition。以下示例创建了两个食物数据。
+
+   ```
+   const FoodComposition: any[] = [
+     { 'name': 'Tomato', 'image': $r('app.media.Tomato'), 'category': Category.Vegetable, 'calories': 17, 'protein': 0.9, 'fat': 0.2, 'carbohydrates': 3.9, 'vitaminC': 17.8 },
+     { 'name': 'Walnut', 'image': $r('app.media.Walnut'), 'category': Category.Nut, 'calories': 654 , 'protein': 15, 'fat': 65, 'carbohydrates': 14, 'vitaminC': 1.3 }
+     ]
+   ```
+
   实际开发中，开发者可以自定义更多的数据资源，当食物资源很多时，建议使用数据懒加载LazyForEach。

 5. 创建initializeOnStartUp方法来初始化FoodData的数组。在FoodDataModels.ets中使用了定义在FoodData.ets的FoodData和Category，所以要将FoodData.ets的FoodData类export，在FoodDataModels.ets内import FoodData和Category。