!7958 update docs

Merge pull request !7958 from 关明月/master

zh-cn/application-dev/reference/apis/js-apis-system-router.md

@@ -374,12 +374,12 @@ export default {
 
 **系统能力：**  以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
 
-| 名称       | 参数类型                     | 必填   | 说明                        |
-| -------- | ------------------------ | ---- | ------------------------- |
-| message  | string                   | 是    | 询问对话框内容。                  |
-| success  | (errMsg: string) => void | 否    | 弹出对话框时调用，errMsg表示返回信息。    |
-| fail     | (errMsg: string) => void | 否    | 接口调用失败的回调函数，errMsg表示返回信息。 |
-| complete | () => void               | 否    | 接口调用结束的回调函数。              |
+| 名称     | 参数类型                 | 必填 | 说明                                               |
+| -------- | ------------------------ | ---- | -------------------------------------------------- |
+| message  | string                   | 是   | 询问对话框内容。                                   |
+| success  | (errMsg: string) => void | 否   | 用户选择对话框确认按钮时触发，errMsg表示返回信息。 |
+| cancel   | (errMsg: string) => void | 否   | 用户选择对话框取消按钮时触发，errMsg表示返回信息。 |
+| complete | () => void               | 否   | 接口调用结束的回调函数。                           |
 
 ## DisableAlertBeforeBackPageOptions<sup>6+</sup>
 
@@ -387,11 +387,11 @@ export default {
 
 **系统能力：**  以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full
 
-| 名称       | 参数类型                     | 必填   | 说明                        |
-| -------- | ------------------------ | ---- | ------------------------- |
-| success  | (errMsg: string) => void | 否    | 弹出对话框时调用，errMsg表示返回信息。    |
-| fail     | (errMsg: string) => void | 否    | 接口调用失败的回调函数，errMsg表示返回信息。 |
-| complete | () => void               | 否    | 接口调用结束的回调函数。              |
+| 名称     | 参数类型                 | 必填 | 说明                                               |
+| -------- | ------------------------ | ---- | -------------------------------------------------- |
+| success  | (errMsg: string) => void | 否   | 关闭询问对话框能力成功时触发，errMsg表示返回信息。 |
+| cancel   | (errMsg: string) => void | 否   | 关闭询问对话框能力失败时触发，errMsg表示返回信息。 |
+| complete | () => void               | 否   | 接口调用结束的回调函数。                           |
 
 ## ParamsInterface
 

zh-cn/application-dev/reference/arkui-js/js-components-custom-lifecycle.md

@@ -7,15 +7,15 @@
 我们为自定义组件提供了一系列生命周期回调方法，便于开发者管理自定义组件的内部逻辑。生命周期主要包括：onInit，onAttached，onDetached，onLayoutReady，onDestroy，onPageShow和onPageHide。下面我们依次介绍一下各个生命周期回调的时机。
 
 
-| 属性            | 类型       | 描述          | 触发时机                                     |
-| ------------- | -------- | ----------- | ---------------------------------------- |
-| onInit        | Function | 初始化自定义组件    | 自定义组件初始化生命周期回调，当自定义组件创建时，触发该回调，主要用于自定义组件中必须使用的数据初始化，该回调只会触发一次调用。 |
+| 属性          | 类型     | 描述               | 触发时机                                                     |
+| ------------- | -------- | ------------------ | ------------------------------------------------------------ |
+| onInit        | Function | 初始化自定义组件   | 自定义组件初始化生命周期回调，当自定义组件创建时，触发该回调，主要用于自定义组件中必须使用的数据初始化，该回调只会触发一次调用。 |
 | onAttached    | Function | 自定义组件装载     | 自定义组件被创建后，加入到Page组件树时，触发该回调，该回调触发时，表示组件将被进行显示，该生命周期可用于初始化显示相关数据，通常用于加载图片资源、开始执行动画等场景。 |
-| onLayoutReady | Function | 自定义组件布局完成   | 自定义组件插入Page组件树后，将会对自定义组件进行布局计算，调整其内容元素尺寸与位置，当布局计算结束后触发该回调。 |
-| onDetached    | Function | 自定义组件摘除     | 自定义组件摘除时，触发该回调，常用于停止动画或异步逻辑停止执行的场景。      |
-| onDestroy     | Function | 自定义组件销毁     | 自定义组件销毁时，触发该回调，常用于资源释放。                  |
-| onPageShow    | Function | 自定义组件Page显示 | 自定义组件所在Page显示后，触发该回调。                    |
-| onPageHide    | Function | 自定义组件Page隐藏 | 自定义组件所在Page隐藏后，触发该回调。                    |
+| onLayoutReady | Function | 自定义组件布局完成 | 自定义组件插入Page组件树后，将会对自定义组件进行布局计算，调整其内容元素尺寸与位置，当布局计算结束后触发该回调。 |
+| onDetached    | Function | 自定义组件摘除     | 自定义组件摘除时，触发该回调，常用于停止动画或异步逻辑停止执行的场景。 |
+| onDestroy     | Function | 自定义组件销毁     | 自定义组件销毁时，触发该回调，常用于资源释放。               |
+| onShow        | Function | 自定义组件Page显示 | 自定义组件所在Page显示后，触发该回调。                       |
+| onHide        | Function | 自定义组件Page隐藏 | 自定义组件所在Page隐藏后，触发该回调。                       |
 
 
 ## 示例
@@ -42,10 +42,10 @@ export default {
   onDetached() {
     this.value = ""
   },
-  onPageShow() {
+  onShow() {
     console.log("Page显示")
   },
-  onPageHide() {
+  onHide() {
     console.log("Page隐藏")
   }
 }

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md

@@ -20,7 +20,7 @@ PanGesture(options?: { fingers?: number, direction?: PanDirection, distance?: nu
   | -------- | -------- | -------- | -------- | -------- |
   | fingers | number | 否 | 1 | 触发滑动的最少手指数，最小为1指， 最大取值为10指。 |
   | direction | PanDirection | 否 | All | 设置滑动方向，此枚举值支持逻辑与(&)和逻辑或（\|）运算。 |
-  | distance | number | 否 | 5.0 | 最小滑动识别距离，单位为vp。 |
+  | distance | number | 否 | 5.0 | 最小滑动识别距离，单位为vp。<br/>**说明：**<br/>> tab滑动与该拖动手势事件同时存在时，可将distance值设为1，使拖动更灵敏，避免造成事件错乱。 |
 
 - PanDirection枚举说明
   | 名称 | 描述 |

zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md

@@ -20,7 +20,7 @@
 
 ## 接口
 
-Grid(value:{scroller?: Scroller})
+Grid(scroller?: Scroller)
 
 - 参数
   | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |

zh-cn/application-dev/reference/arkui-ts/ts-container-list.md

 # List
 
 > **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>
+> - 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> - 该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。
 
 
 列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据，例如图片和文本。

zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md

 # Scroll
 
 >  **说明：**
-> - 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-> - 该组件嵌套List子组件滚动时，若List不设置宽高，则默认全部加载，在对性能有要求的场景下建议指定List的宽高。
+>  - 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>  - 该组件嵌套List子组件滚动时，若List不设置宽高，则默认全部加载，在对性能有要求的场景下建议指定List的宽高。
+>  - 该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。
 
 
 可滚动的容器组件，当子组件的布局尺寸超过父组件的视口时，内容可以滚动。

zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-path.md

@@ -15,7 +15,7 @@
 
 无
 
-# 接口
+## 接口
 
 Path(value?: { width?: number | string; height?: number | string; commands?: string })
 

zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md

@@ -6,6 +6,9 @@
 > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
 
 
+通过CustomDialogController类显示自定义弹窗。使用弹窗组件时，可优先考虑自定义弹窗，便于自定义弹窗的样式与内容。
+
+
 ## 接口
 
 CustomDialogController(value:{builder: CustomDialog, cancel?: () => void, autoCancel?: boolean, alignment?: DialogAlignment, offset?: Offset, customStyle?: boolean})

zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md

@@ -18,9 +18,9 @@
   | -------- | -------- | -------- | -------- | -------- |
   | type | TransitionType                                               | TransitionType.All | 否 | 默认包括组件新增和删除。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;不指定Type时说明插入删除使用同一种效果。 |
   | opacity | number | 1 | 否 | 设置组件转场时的透明度效果，为插入时起点和删除时终点的值。 |
-  | translate | {<br/>x?&nbsp;:&nbsp;number,<br/>y?&nbsp;:&nbsp;number,<br/>z?&nbsp;:&nbsp;number<br/>} | - | 否 | 设置组件转场时的平移效果，为插入时起点和删除时终点的值。 |
-  | scale | {<br/>x?&nbsp;:&nbsp;number,<br/>y?&nbsp;:&nbsp;number,<br/>z?&nbsp;:&nbsp;number,<br/>centerX?&nbsp;:&nbsp;number,<br/>centerY?&nbsp;:&nbsp;number<br/>} | - | 否 | 设置组件转场时的缩放效果，为插入时起点和删除时终点的值。<br/>**说明：**<br/>>&nbsp;中心点为0时，默认的是组件的左上角<br/>>&nbsp;centerX、centerY设置百分比时，是基于自身布局的尺寸缩放的 |
-  | rotate | {<br/>x?:&nbsp;number,<br/>y?:&nbsp;number,<br/>z?:&nbsp;number,<br/>angle?:&nbsp;Angle,<br/>centerX?:&nbsp;Length,<br/>centerY?:&nbsp;Length<br/>} | - | 否 | 设置组件转场时的旋转效果，为插入时起点和删除时终点的值。<br/>**说明：**<br/>>&nbsp;中心点为0时，默认的是组件的左上角 |
+  | translate | {<br/>x?&nbsp;:&nbsp;number,<br/>y?&nbsp;:&nbsp;number,<br/>z?&nbsp;:&nbsp;number<br/>} | - | 否 | 设置组件转场时的平移效果，为插入时起点和删除时终点的值。<br/>**说明：**<br/>>&nbsp;x、y、z分别是横向、纵向、竖向的平移距离 |
+  | scale | {<br/>x?&nbsp;:&nbsp;number,<br/>y?&nbsp;:&nbsp;number,<br/>z?&nbsp;:&nbsp;number,<br/>centerX?&nbsp;:&nbsp;number,<br/>centerY?&nbsp;:&nbsp;number<br/>} | - | 否 | 设置组件转场时的缩放效果，为插入时起点和删除时终点的值。<br/>**说明：**<br/>>&nbsp;x、y、z分别是横向、纵向、竖向放大倍数（或缩小到原来的多少）<br/>>&nbsp;centerX、centerY缩放中心点<br/>>&nbsp;中心点为0时，默认的是组件的左上角<br/> |
+  | rotate | {<br/>x?:&nbsp;number,<br/>y?:&nbsp;number,<br/>z?:&nbsp;number,<br/>angle?:&nbsp;Angle,<br/>centerX?:&nbsp;Length,<br/>centerY?:&nbsp;Length<br/>} | - | 否 | 设置组件转场时的旋转效果，为插入时起点和删除时终点的值。<br/>**说明：**<br/>>&nbsp;x、y、z分别是横向、纵向、竖向的旋转向量<br/>>&nbsp;centerX,centerY指旋转中心点<br/>>&nbsp;中心点为0时，默认的是组件的左上角 |
 
 - TransitionType枚举说明
   | 名称 | 描述 |

zh-cn/application-dev/ui/ui-ts-layout-mediaquery.md

@@ -43,9 +43,9 @@ listener.on('change', onPortrait)
 
 `(max-height: 800)` ：当高度小于800时条件成立
 
-`(height <= 800) ` ：当高度小于800时条件成立
+`(height <= 800) ` ：当高度小于等于800时条件成立
 
-`screen and (device-type: tv) or (resolution &lt; 2)` ：包含多个媒体特征的多条件复杂语句查询
+`screen and (device-type: tv) or (resolution < 2)` ：包含多个媒体特征的多条件复杂语句查询
 
 ###  媒体类型(media-type)