!9584 update AppStoreage

Merge pull request !9584 from 田雨/master

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

@@ -28,6 +28,7 @@ export default {
 
 ```html
 <!-- xxx.hml -->
+<element name='comp' src='../../common/comp/comp.hml'></element>
 <div class="container">  
    <text>父组件：{{text}}</text> 
    <comp @event-type1="textClicked"></comp>  
@@ -46,3 +47,5 @@ export default {
   },
 }
 ```
+
+![EventParameters](figures/EventParameters.gif)
\ No newline at end of file

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md

@@ -80,12 +80,16 @@ struct PatternLockExample {
         .backgroundColor(Color.White)
         .autoReset(true)
         .onPatternComplete((input: Array<number>) => {
-          if (input == null || input == undefined || input.length < 5) {
+          // 判断输出的密码格式
+          if (input === null || input === undefined || input.length < 5) {
             this.message = 'The password length needs to be greater than 5.'
+            // 重新触发该回调
             return
           }
+          // 判断密码长度是否大于0
           if (this.passwords.length > 0) {
-            if (this.passwords.toString() == input.toString()) {
+              // 判断俩次输入的密码是否相等
+            if (this.passwords.toString() === input.toString()) {
               this.passwords = input
               this.message = 'Set password successfully: ' + this.passwords.toString()
             } else {

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

@@ -24,7 +24,7 @@ Scroll(scroller?: Scroller)
 
 | 名称             | 参数类型                                     | 描述        |
 | -------------- | ---------------------------------------- | --------- |
-| scrollable     | ScrollDirection                          | 设置滚动方法。<br/>默认值：ScrollDirection.Vertical |
+| scrollable     | ScrollDirection                          | 设置滚动方向。<br/>默认值：ScrollDirection.Vertical |
 | scrollBar      | [BarState](ts-appendix-enums.md#barstate) | 设置滚动条状态。<br/>默认值：BarState.Off |
 | scrollBarColor | string&nbsp;\|&nbsp;number&nbsp;\|&nbsp;Color   | 设置滚动条的颜色。 |
 | scrollBarWidth | string&nbsp;\|&nbsp;number         | 设置滚动条的宽度。 |
@@ -140,7 +140,7 @@ scrollToIndex(value: number): void
 | value  | number   | 是   | 要滑动到的列表项在列表中的索引值。 |
 
 
-### scrollBy
+### scrollBy<sup>9+</sup>
 
 scrollBy(dx: Length, dy: Length): void
 

zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md

@@ -55,7 +55,7 @@
 - GestureEvent对象说明
   | 名称 | 类型 | 描述 |
   | -------- | -------- | -------- |
-  | timestamp<sup>8+</sup> | number | 事件时间戳。 |
+  | timestamp<sup>8+</sup> | number | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。 |
   | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
   | source<sup>8+</sup> | SourceType | 事件输入设备。 |
   | repeat | boolean | 是否为重复触发事件，用于LongPressGesture手势触发场景。 |
@@ -79,8 +79,8 @@
   | 名称 | 类型 | 描述 |
   | -------- | -------- | -------- |
   | id | number | 手指的索引编号。 |
-  | globalX | number | 相对于设备屏幕左上角的x轴坐标。 |
-  | globalY | number | 相对于设备屏幕左上角的y轴坐标。 |
+  | globalX | number | 相对于应用窗口左上角的x轴坐标。 |
+  | globalY | number | 相对于应用窗口左上角的y轴坐标。 |
   | localX | number | 相对于当前组件元素左上角的x轴坐标。 |
   | localY | number | 相对于当前组件元素左上角的y轴坐标。 |
 

zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md

@@ -14,15 +14,14 @@
 | onClick(event: (event?: ClickEvent) => void) | 否    | 点击动作触发该方法调用，event参数见ClickEvent介绍。 |
 
 ## ClickEvent对象说明
-
-| 属性名称                | 类型                               | 描述                  |
-| ------------------- | -------------------------------- | ------------------- |
-| screenX             | number                           | 点击点相对于设备屏幕左边沿的X坐标。  |
-| screenY             | number                           | 点击点相对于设备屏幕上边沿的Y坐标。  |
-| x                   | number                           | 点击点相对于被点击元素左边沿的X坐标。 |
-| y                   | number                           | 点击点相对于被点击元素上边沿的Y坐标。 |
-| target<sup>8+</sup> | [EventTarget](#eventtarget8对象说明) | 被点击元素对象。            |
-| timestamp           | number                           | 事件时间戳。              |
+| 属性名称            | 类型                                 | 描述                                                     |
+| ------------------- | ------------------------------------ | -------------------------------------------------------- |
+| screenX             | number                               | 点击点相对于应用窗口左上角的X坐标。                      |
+| screenY             | number                               | 点击点相对于应用窗口左上角的Y坐标。                      |
+| x                   | number                               | 点击点相对于被点击元素左上角的X坐标。                    |
+| y                   | number                               | 点击点相对于被点击元素左上角的Y坐标。                    |
+| target<sup>8+</sup> | [EventTarget](#eventtarget8对象说明) | 被点击元素对象。                                         |
+| timestamp           | number                               | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。 |
 
 ## EventTarget<sup>8+</sup>对象说明
 

zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md

@@ -16,27 +16,27 @@
 
 ## TouchEvent对象说明
 
-  | 名称                | 类型                                       | 描述           |
-  | ------------------- | ---------------------------------------- | ------------ |
-  | type                | [TouchType](ts-appendix-enums.md#touchtype)      | 触摸事件的类型。     |
-  | touches             | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。      |
-  | changedTouches      | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 |
-  | stopPropagation      | () => void | 阻塞事件冒泡。 |
-  | timestamp<sup>8+</sup> | number | 事件时间戳。 |
-  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
-  | source<sup>8+</sup> | [SourceType](ts-gesture-settings.md) | 事件输入设备。 |
+| 名称                | 类型                                       | 描述           |
+| ------------------- | ---------------------------------------- | ------------ |
+| type                | [TouchType](ts-appendix-enums.md#touchtype)      | 触摸事件的类型。     |
+| touches             | Array&lt;[TouchObject](#touchobject对象说明)&gt; | 全部手指信息。      |
+| changedTouches      | Array&lt;[TouchObject](#touchobject对象说明)&gt; | 当前发生变化的手指信息。 |
+| stopPropagation      | () => void | 阻塞事件冒泡。 |
+| timestamp<sup>8+</sup> | number | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。 |
+| target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
+| source<sup>8+</sup> | [SourceType](ts-gesture-settings.md) | 事件输入设备。 |
 
 
 ## TouchObject对象说明
 
-| 名称    | 类型                          | 描述                  |
-| ------- | --------------------------- | ------------------- |
-| type    | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。            |
-| id      | number                      | 手指唯一标识符。            |
-| screenX | number                      | 触摸点相对于设备屏幕左边沿的X坐标。  |
-| screenY | number                      | 触摸点相对于设备屏幕上边沿的Y坐标。  |
-| x       | number                      | 触摸点相对于被触摸元素左边沿的X坐标。 |
-| y       | number                      | 触摸点相对于被触摸元素上边沿的Y坐标。 |
+| 名称    | 类型                                        | 描述                                  |
+| ------- | ------------------------------------------- | ------------------------------------- |
+| type    | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。                      |
+| id      | number                                      | 手指唯一标识符。                      |
+| screenX | number                                      | 触摸点相对于应用窗口左上角的X坐标。   |
+| screenY | number                                      | 触摸点相对于应用窗口左上角的Y坐标。   |
+| x       | number                                      | 触摸点相对于被触摸元素左上角的X坐标。 |
+| y       | number                                      | 触摸点相对于被触摸元素左上角的Y坐标。 |
 
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md

@@ -19,14 +19,14 @@
 
 | 名称      | 属性类型                            | 描述                   |
 | --------- | ------------------------------- | -------------------- |
-| screenX   | number                          | 点击触点相对于屏幕左上角的x轴坐标。   |
-| screenY   | number                          | 点击触点相对于屏幕左上角的y轴坐标。   |
+| screenX   | number                          | 点击触点相对于应用窗口左上角的x轴坐标。 |
+| screenY   | number                          | 点击触点相对于应用窗口左上角的y轴坐标。 |
 | x         | number                          | 点击触点相对于当前组件左上角的x轴坐标。 |
 | y         | number                          | 点击触点相对于当前组件左上角的y轴坐标。 |
 | button    | [MouseButton](ts-appendix-enums.md#mousebutton) | 鼠标按键。                |
 | action    | [MouseAction](ts-appendix-enums.md#mouseaction) | 事件动作。                |
 | stopPropagation      | () => void | 阻塞事件冒泡。                         |
-| timestamp<sup>8+</sup> | number | 事件时间戳。                                  |
+| timestamp<sup>8+</sup> | number | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。          |
 | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
 | source<sup>8+</sup> | [SourceType](ts-gesture-settings.md) | 事件输入设备。           |
 

zh-cn/application-dev/ui/js-framework-syntax-hml.md

@@ -136,8 +136,10 @@ export default {
 
 - 绑定并阻止冒泡事件向上冒泡：grab:{event}.bubble。grab:{event}等价于grab:{event}.bubble。
   > **说明：**
+  >
+  > 冒泡事件是指多个组件嵌套时，组件之间会有层次关系，当这些组件注册了相同的事件时，这个事件会首先运行在该元素上的处理程序，然后运行其父元素上的处理程序，一直向上到其他祖先上的处理程序。如果当一个组件触发了这个事件，它会首先触发该组件的回调函数，然后触发其父元素上的回调函数，然后触发其他祖先上的处理程序。
+  >
   > 详细冒泡事件说明参见[通用事件](../reference/arkui-js/js-components-common-events.md)章节。
-
 - 示例
   ```html
   <!-- xxx.hml -->

zh-cn/application-dev/ui/ts-application-states-appstorage.md

@@ -64,21 +64,35 @@ struct ComponentA {
   }
 
   build() {
-    Row({ space: 20 }) {
-
-      Button(`${this.label}: ${this.varA}`)
-        .onClick(() => {
-          AppStorage.Set<number>('varA', AppStorage.Get<number>('varA') + 1)
-        })
-      Button(`lang: ${this.lang}`)
-        .onClick(() => {
-          if (this.lang === 'zh') {
-            AppStorage.Set<string>('languageCode', 'en')
-          } else {
-            AppStorage.Set<string>('languageCode', 'zh')
-          }
-          this.label = (this.lang === 'zh') ? '数' : 'Count'
-        })
+    Column(){
+      Row({ space: 20 }) {
+        Button(`${this.label}: ${this.varA}`)
+          .onClick(() => {
+            AppStorage.Set<number>('varA', AppStorage.Get<number>('varA') + 1)
+          })
+        Button(`lang: ${this.lang}`)
+          .onClick(() => {
+            if (this.lang === 'zh') {
+              AppStorage.Set<string>('languageCode', 'en')
+            } else {
+              AppStorage.Set<string>('languageCode', 'zh')
+            }
+            this.label = (this.lang === 'zh') ? '数' : 'Count'
+          })
+      }
+      .margin({ bottom: 50 })
+      Row(){
+        Button(`更改@StorageLink修饰的变量：${this.varA}`).fontSize(10)
+          .onClick(() => {
+            this.varA++
+          })
+      }.margin({ bottom: 50 })
+      Row(){
+        Button(`更改@StorageProp修饰的变量：${this.lang}`).fontSize(10)
+          .onClick(() => {
+            this.lang = 'test'
+          })
+      }
     }
   }
 }

zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md

@@ -9,8 +9,8 @@
 | ---------------- | ------------------------------------------------------------ |
 | aboutToAppear    | 函数在创建自定义组件的新实例后，在执行其build函数之前执行。允许在aboutToAppear函数中改变状态变量，更改将在后续执行build函数中生效。 |
 | aboutToDisappear | 函数在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量，特别是@Link变量的修改可能会导致应用程序行为不稳定。 |
-| onPageShow       | 页面显示时触发一次，包括路由过程、应用进入前后台等场景，仅@Entry修饰的自定义组件生效。 |
-| onPageHide       | 页面消失时触发一次，包括路由过程、应用进入前后台等场景，仅@Entry修饰的自定义组件生效。 |
+| onPageShow       | 页面每次显示时触发一次，包括路由过程、应用进入前后台等场景，仅@Entry修饰的自定义组件生效。 |
+| onPageHide       | 页面每次隐藏时触发一次，包括路由过程、应用进入前后台等场景，仅@Entry修饰的自定义组件生效。 |
 | onBackPress      | 当用户点击返回按钮时触发，仅\@Entry修饰的自定义组件生效。<br/>-&nbsp;返回true表示页面自己处理返回逻辑,&nbsp;不进行页面路由。<br/>-&nbsp;返回false表示使用默认的返回逻辑。<br/>-&nbsp;不返回值会作为false处理。 |