) => void
-DedicatedWorkerGlobalScope的onmessage属性表示Worker线程收到来自其宿主线程通过worker.postMessage接口发送的消息时被调用的事件处理程序,处理程序在Worker线程中执行。
+DedicatedWorkerGlobalScope的onmessage属性表示Worker线程收到来自其宿主线程通过postMessage接口发送的消息时被调用的事件处理程序,处理程序在Worker线程中执行。
**系统能力:** SystemCapability.Utils.Lang
@@ -513,7 +514,7 @@ DedicatedWorkerGlobalScope的onmessage属性表示Worker线程收到来自其宿
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ----------------------------- | ---- | ---------------------- |
-| event | [MessageEvent](#messageevent) | 否 | 收到的Worker消息数据。 |
+| event | [MessageEvent](#messageevent) | 否 | 收到宿主线程发送的数据。 |
**示例:**
@@ -583,7 +584,7 @@ parentPort.onmessageerror= function(e) {
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| --------- | -------- | ---- | ---- | ---------------------------------- |
-| type | string | 是 | 否 | 指定事件的type。 |
+| type | string | 是 | 否 | 指定事件的类型。 |
| timeStamp | number | 是 | 否 | 事件创建时的时间戳(精度为毫秒)。 |
@@ -653,7 +654,7 @@ Worker线程自身的运行环境,WorkerGlobalScope类继承[EventTarget](#eve
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| ---- | ------------------------------------------------------------ | ---- | ---- | --------------------------------------- |
-| name | string | 是 | 否 | Worker的名字,有new Worker时指定。 |
+| name | string | 是 | 否 | Worker的名字,new Worker时指定。 |
| self | [WorkerGlobalScope](#workerglobalscope) & typeof globalThis | 是 | 否 | WorkerGlobalScope本身。 |
@@ -689,6 +690,20 @@ parentPort.onerror = function(e){
## 其他说明
+### 序列化支持类型
+| Type | 备注 | 是否支持 |
+| ------------------- | -------------------------------------------------------- | -------------------- |
+| All Primitive Type | 不包括symbol | 是 |
+| Date | | 是 |
+| String | | 是 |
+| RegExp | | 是 |
+| Array | | 是 |
+| Map | | 是 |
+| Set | | 是 |
+| Object | 只支持Create from literal的简单Object,不支持带function的 | 是 |
+| ArrayBuffer | 提供transfer能力 | 是 |
+| TypedArray | | 是 |
+
### 内存模型
Worker基于Actor并发模型实现。在Worker的交互流程中,JS主线程可以创建多个Worker子线程,各个Worker线程间相互隔离,并通过序列化传递对象,等到Worker线程完成计算任务,再把结果返回给主线程。
diff --git a/zh-cn/application-dev/reference/arkui-js/figures/EventParameters.gif b/zh-cn/application-dev/reference/arkui-js/figures/EventParameters.gif
new file mode 100644
index 0000000000000000000000000000000000000000..a0477de83ff1977f2554ab2d3e29daf49bcf3007
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-js/figures/EventParameters.gif differ
diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-custom-event-parameter.md b/zh-cn/application-dev/reference/arkui-js/js-components-custom-event-parameter.md
index ba98fb2c28321fadf3f00ded3a47fa0248c8a14b..f134127293bc49786845f7a2d42cd46a39072426 100644
--- a/zh-cn/application-dev/reference/arkui-js/js-components-custom-event-parameter.md
+++ b/zh-cn/application-dev/reference/arkui-js/js-components-custom-event-parameter.md
@@ -28,6 +28,7 @@ export default {
```html
+
父组件:{{text}}
@@ -46,3 +47,5 @@ export default {
},
}
```
+
+![EventParameters](figures/EventParameters.gif)
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md
index 61beb6e4dc7b89160fe5346990a22cba6d1348e7..c832a0840a16df0460aac5e5775460b362144e83 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md
+++ b/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) => {
- 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 {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
index da4a7c5d1e6a719dfb03e7c07688b6422ebe8a7b..3683017871d40b86882a5568bc7e4879fa510be9 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
@@ -24,7 +24,7 @@ Scroll(scroller?: Scroller)
| 名称 | 参数类型 | 描述 |
| -------------- | ---------------------------------------- | --------- |
-| scrollable | ScrollDirection | 设置滚动方法。
默认值:ScrollDirection.Vertical |
+| scrollable | ScrollDirection | 设置滚动方向。
默认值:ScrollDirection.Vertical |
| scrollBar | [BarState](ts-appendix-enums.md#barstate) | 设置滚动条状态。
默认值:BarState.Off |
| scrollBarColor | string \| number \| Color | 设置滚动条的颜色。 |
| scrollBarWidth | string \| number | 设置滚动条的宽度。 |
@@ -140,7 +140,7 @@ scrollToIndex(value: number): void
| value | number | 是 | 要滑动到的列表项在列表中的索引值。 |
-### scrollBy
+### scrollBy9+
scrollBy(dx: Length, dy: Length): void
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md b/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
index b5f9d553232b155d94c76e8ad0e2c218cff0d45d..63826b2cdda7592545f76c14f93ea3f356564b8f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
@@ -74,8 +74,8 @@
| 名称 | 类型 | 描述 |
| -------- | -------- | -------- |
| id | number | 手指的索引编号。 |
- | globalX | number | 相对于设备屏幕左上角的x轴坐标。 |
- | globalY | number | 相对于设备屏幕左上角的y轴坐标。 |
+ | globalX | number | 相对于应用窗口左上角的x轴坐标。 |
+ | globalY | number | 相对于应用窗口左上角的y轴坐标。 |
| localX | number | 相对于当前组件元素左上角的x轴坐标。 |
| localY | number | 相对于当前组件元素左上角的y轴坐标。 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
index 3090c9135d7e0e6427c587f1d7d384b2d6a4cb9a..c83bcdf3dddd087b3b82061fd663516bdede767f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
@@ -16,7 +16,7 @@
| height | [Length](ts-types.md#length) | 设置组件自身的高度,缺省时使用元素自身内容需要的高度。若子组件的高大于父组件的高,则会画出父组件的范围。 |
| size | {
width?: [Length](ts-types.md#length),
height?: [Length](ts-types.md#length)
} | 设置高宽尺寸。 |
| padding | [Padding](ts-types.md#padding) \| [Length](ts-types.md#length) | 设置内边距属性。
参数为Length类型时,四个方向内边距同时生效。
默认值:0
padding设置百分比时,上下左右内边距均以父容器的width作为基础值。 |
-| margin | [Margin](ts-types.md#margin)) \| [Length](ts-types.md#length) | 设置外边距属性。
参数为Length类型时,四个方向外边距同时生效。
默认值:0
margin设置百分比时,上下左右内边距均以父容器的width作为基础值。|
+| margin | [Margin](ts-types.md#margin)) \| [Length](ts-types.md#length) | 设置外边距属性。
参数为Length类型时,四个方向外边距同时生效。
默认值:0
margin设置百分比时,上下左右外边距均以父容器的width作为基础值。|
| constraintSize | {
minWidth?: [Length](ts-types.md#length),
maxWidth?: [Length](ts-types.md#length),
minHeight?: [Length](ts-types.md#length),
maxHeight?: [Length](ts-types.md#length)
} | 设置约束尺寸,组件布局时,进行尺寸范围限制。constraintSize的优先级高于Width和Height。
默认值:
{
minWidth: 0,
maxWidth: Infinity,
minHeight: 0,
maxHeight: Infinity
} |
| layoutWeight | number \| string | 容器尺寸确定时,元素与兄弟节点主轴布局尺寸按照权重进行分配,忽略本身尺寸设置,表示自适应占满剩余空间。
**说明:**
仅在Row/Column/Flex布局中生效。
默认值:0 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
index 46e34939e9882daa55cb17a25e4c2c98b8d1c81f..ec4e7e0f29fea2bc64b5c7e122587f78f4be99dc 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
+++ b/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坐标。 |
-| target8+ | [EventTarget](#eventtarget8对象说明) | 被点击元素对象。 |
-| timestamp | number | 事件时间戳。 |
+| 属性名称 | 类型 | 描述 |
+| ------------------- | ------------------------------------ | -------------------------------------------------------- |
+| screenX | number | 点击点相对于应用窗口左上角的X坐标。 |
+| screenY | number | 点击点相对于应用窗口左上角的Y坐标。 |
+| x | number | 点击点相对于被点击元素左上角的X坐标。 |
+| y | number | 点击点相对于被点击元素左上角的Y坐标。 |
+| target8+ | [EventTarget](#eventtarget8对象说明) | 被点击元素对象。 |
+| timestamp | number | 事件时间戳。触发事件时距离系统启动的时间间隔,单位纳秒。 |
## EventTarget8+对象说明
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
index 1cc889bcd5323976abdca059e4dda68e163f0185..f671f750b9073e8dd8ea70ee5645f9d0b3abfe53 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
+++ b/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 | 阻塞事件冒泡。 |
- | timestamp8+ | number | 事件时间戳。 |
- | target8+ | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
- | source8+ | [SourceType](ts-gesture-settings.md) | 事件输入设备。 |
+| 名称 | 类型 | 描述 |
+| ------------------- | ---------------------------------------- | ------------ |
+| type | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。 |
+| touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 |
+| changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 |
+| stopPropagation | () => void | 阻塞事件冒泡。 |
+| timestamp8+ | number | 事件时间戳。触发事件时距离系统启动的时间间隔,单位纳秒。 |
+| target8+ | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
+| source8+ | [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坐标。 |
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
index cd618184f538eede08735b458bcf9727e002dd69..8f0eb3cfa01685a36211438aa8bfafc67b8e62d0 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
+++ b/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 | 阻塞事件冒泡。 |
-| timestamp8+ | number | 事件时间戳。 |
+| timestamp8+ | number | 事件时间戳。触发事件时距离系统启动的时间间隔,单位纳秒。 |
| target8+ | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
| source8+ | [SourceType](ts-gesture-settings.md) | 事件输入设备。 |
diff --git a/zh-cn/application-dev/security/hapsigntool-guidelines.md b/zh-cn/application-dev/security/hapsigntool-guidelines.md
index c9e74bd157039e2916c5c408a68ef18ffaa584ab..fc36ed99b1b25c7f977b622bfaea7fb577eb63ba 100644
--- a/zh-cn/application-dev/security/hapsigntool-guidelines.md
+++ b/zh-cn/application-dev/security/hapsigntool-guidelines.md
@@ -391,12 +391,12 @@ OpenHarmony系统内置密钥库文件,文件名称为OpenHarmony.p12,内含
- **现象描述**
- 执行命令后提示:`NOT_SUPPORT_ERROR, code: 105. Details: SignAlg params is incorrect, signature algorithms include SHA256withECDSA,SHA384withECDSA`
+ 执行命令后提示:`NOT_SUPPORT_ERROR, code: 105. Details: SignAlg params is incorrect, signature algorithms include SHA256withECDSA,SHA384withECDSA`。
- **可能原因**
- 签名算法不支持,signAlg参数填写错误
+ 签名算法不支持,signAlg参数填写错误。
- **解决办法**
- 最终实体证书密钥对推荐使用ECC生成,hap签名算法修改为ECC对应的SHA256withECDSA,SHA384withECDSA
+ 最终实体证书密钥对推荐使用ECC生成,hap签名算法修改为ECC对应的SHA256withECDSA,SHA384withECDSA。
diff --git a/zh-cn/application-dev/ui/js-framework-syntax-hml.md b/zh-cn/application-dev/ui/js-framework-syntax-hml.md
index be8967e462a13e3a9154c3e6dfbadda5c2721d25..684d16fbc4effc17e7b6ba957472fe3b63fed44e 100644
--- a/zh-cn/application-dev/ui/js-framework-syntax-hml.md
+++ b/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
diff --git a/zh-cn/application-dev/ui/ts-application-states-appstorage.md b/zh-cn/application-dev/ui/ts-application-states-appstorage.md
index 649e226686acafc413700428582506264b1bc8a2..503d3a225b777cfb00cfb55245f69d4be5f92d45 100644
--- a/zh-cn/application-dev/ui/ts-application-states-appstorage.md
+++ b/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('varA', AppStorage.Get('varA') + 1)
- })
- Button(`lang: ${this.lang}`)
- .onClick(() => {
- if (this.lang === 'zh') {
- AppStorage.Set('languageCode', 'en')
- } else {
- AppStorage.Set('languageCode', 'zh')
- }
- this.label = (this.lang === 'zh') ? '数' : 'Count'
- })
+ Column(){
+ Row({ space: 20 }) {
+ Button(`${this.label}: ${this.varA}`)
+ .onClick(() => {
+ AppStorage.Set('varA', AppStorage.Get('varA') + 1)
+ })
+ Button(`lang: ${this.lang}`)
+ .onClick(() => {
+ if (this.lang === 'zh') {
+ AppStorage.Set('languageCode', 'en')
+ } else {
+ AppStorage.Set('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'
+ })
+ }
}
}
}
diff --git a/zh-cn/application-dev/ui/ts-component-based-builder.md b/zh-cn/application-dev/ui/ts-component-based-builder.md
index 23abd1f50cd482f0f5580d476b2f8ed4a2cc072b..7f21c9e5e18d080b28bd9ac6d4d0b65c57daa633 100644
--- a/zh-cn/application-dev/ui/ts-component-based-builder.md
+++ b/zh-cn/application-dev/ui/ts-component-based-builder.md
@@ -1,15 +1,43 @@
# @Builder
-@Builder装饰的方法用于定义组件的声明式UI描述,在一个自定义组件内快速生成多个布局内容。\@Builder装饰方法的功能和语法规范与[build函数](ts-function-build.md)相同。
+@Builder装饰的方法用于定义组件的声明式UI描述,在一个自定义组件内快速生成多个布局内容。如果\@Builder装饰的方法中使用了自定义组件,那么该方法每次被调用时,对应的自定义组件均会重新创建。\@Builder装饰方法的功能和语法规范与[build函数](ts-function-build.md)相同。
```ts
// xxx.ets
+
+@Component
+struct CompB {
+ @State CompValue: string = '';
+
+ aboutToAppear() {
+ console.info('CompB aboutToAppear.');
+ }
+
+ aboutToDisappear() {
+ console.info('CompB aboutToDisappear.');
+ }
+
+ build() {
+ Column() {
+ Button(this.CompValue);
+ }
+ }
+}
+
@Entry
@Component
struct CompA {
- size1 : number = 100;
+ size1: number = 100;
+ @State CompValue1: string = "Hello,CompValue1";
+ @State CompValue2: string = "Hello,CompValue2";
+ @State CompValue3: string = "Hello,CompValue3";
+
+ // @Builder装饰的函数内使用自定义组件
+ @Builder CompC(value: string) {
+ CompB({ CompValue: value });
+ }
@Builder SquareText(label: string) {
Text(label)
@@ -35,7 +63,16 @@ struct CompA {
}
.width(2 * this.size1)
.height(1 * this.size1)
+
this.RowOfSquareTexts("C", "D")
+ Column() {
+ // 使用三次@Builder装饰的自定义组件
+ this.CompC(this.CompValue1);
+ this.CompC(this.CompValue2);
+ this.CompC(this.CompValue3);
+ }
+ .width(2 * this.size1)
+ .height(2 * this.size1)
}
.width(2 * this.size1)
.height(2 * this.size1)
diff --git a/zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md b/zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md
index d048a2579e1835856250d2882361cdbb9b68dbda..f413d22973221a435a408b6a2cc6993ea379e1a2 100644
--- a/zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md
+++ b/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修饰的自定义组件生效。
- 返回true表示页面自己处理返回逻辑, 不进行页面路由。
- 返回false表示使用默认的返回逻辑。
- 不返回值会作为false处理。 |
diff --git a/zh-cn/contribute/template/js-template.md b/zh-cn/contribute/template/js-template.md
index fe3ed9c8c1dc972d89ac87fd5ae91e7eeee97bfb..05fe7ca32ad5e0a02e227090e86039f41e0214a6 100644
--- a/zh-cn/contribute/template/js-template.md
+++ b/zh-cn/contribute/template/js-template.md
@@ -11,7 +11,7 @@
| 4 | 目录修改 | 新增文件,需要修改对应的Readme,即`docs/zh-cn/application-dev/reference/apis/Readme-CN.md`。 |
| 5 | 文档结构 | - 模块说明
- 起始版本说明
- 导入模块/使用说明
- 接口(属性、方法、枚举、自定义类型)
描述顺序和代码保持一致,如果某些接口具有逻辑顺序,请注意排列。 |
| 6 | 接口版本说明 | 1. 每个模块要有起始版本说明,使用引用语法“>”对接口的起始版本进行说明。接口没有标记的,默认与模块同一个起始版本。
2. 已有模块新增接口使用\标签标记对应版本号。写法:`版本号+`
例如`7+`
示例:API 6已有的模块,在API 7新增了一个属性字段,则在属性后加标记,即newAttribute7+。
如果新增了一个方法,则在方法标题后增加标记,即 sim.getSimIccId7+,interface、class、枚举等同理。 |
-| 7 | 废弃接口说明 | 废弃内容不能直接删去,在废弃内容后面加标注deprecated,并使用“>”引用语法建议使用的替代方式,加上对应的链接。
示例:abandonmentMethod(deprecated)
> 从API Version 7 开始不再维护,建议使用[newMethod]\(#newmethod)替代。 |
+| 7 | 废弃接口说明 | 废弃内容不能直接删去,在废弃内容后面加标注deprecated,并使用“>”引用语法建议使用的替代方式,加上对应的链接。
示例:abandonmentMethod(deprecated)
> 从API version 7 开始不再维护,建议使用[newMethod]\(#newmethod)替代。 |
| 8 | 权限说明 | 与代码保持一致,下沉到各个方法、枚举、属性字段中。
1. 如果仅系统应用可申请,格式:
**需要权限:** ohos.permission.xxxx,仅系统应用可用。
2. 如果该权限所有应用可申请,格式:
**需要权限:** ohos.permission.xxxx
3. 如果该接口涉及多个权限,则采用“和、或”进行分割,格式:
**需要权限:** ohos.permission.A 和 ohos.permission.B
**需要权限:** ohos.permission.A 或 ohos.permission.B |
| 9 | @syscap | 1. 每个方法都需要进行描述,格式:
**系统能力**:SystemCapability.xxx.xxx
2. 每个表格(属性、枚举、常量、变量)可统一进行说明,分两种情况:
1)每个表格下系统能力无差异的,同方法的写法:
**系统能力**:SystemCapability.xxx.xxx
2)有差异的:在每一个表格项里进行描述。 |
| 10 | @system api | 1. 如果某个模块全部接口均为system api,则在模块开头的版本说明下一行,增加:
- 本模块接口为系统接口。
2. 如果某个接口为system api,仅供OEM厂商使用,则需要在描述中增加:
**系统接口:** 此接口为系统接口。 |
diff --git a/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md b/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md
index 5cf1365a2e2339198005a14a5be0b747dc91ea3d..1a05a0e689fb773071c779e82d03e3be67a48889 100644
--- a/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md
+++ b/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md
@@ -186,31 +186,29 @@ _[API差异报告](api-change/v3.2-beta1/readme.md)_
| 子系统 | 名称 | 简介 | 开发语言 |
| -------- | -------- | -------- | -------- |
-| ArkUI | MouseEvent | 本示例模拟了简单的扫雷游戏调用了鼠标事件的相关接口 | eTS |
-| ArkUI | Vibrator | 本示例模拟倒计时场景,展示振动接口的使用方法。 | eTS |
-| DFX | FaultLogger | 本示例展示了在eTS中如何获取应用故障相关信息。 | eTS |
-| ArkUI | Gallery | 本Demo通过不同示例向用户介绍通用事件、通用属性、手势处理等不同组件的功能。 | eTS |
-| 图形 | JsWebGL | 本示例调用GPU资源绘制了五角星和矩形,展示WebGL相关接口的使用方法。 | JS |
-| ArkUI | Clock | 本示例使用eTS UI能力实现一个简单的时钟应用。 | eTS |
-| 网络管理 | Http | 本示例仿postman输入API接口地址,获取相应数据,介绍数据请求接口的用法。 | eTS |
-| ArkUI | FlishLight | 本示例通过屏幕的亮度变化来模拟手电筒功能,屏幕变亮模拟手电筒打开,屏幕变暗模拟手电筒关闭。 | eTS |
-| 网络管理 | Socket | 本示例主要演示了Socket在网络通信方面的应用,展示了Socket在两端设备的连接验证、聊天通信方面的应用。 | eTS |
-| 分布式数据管理 | DistributedRdb | 本示例展示了在eTS中分布式关系型数据库的使用,在增、删、改、查的基本操作外,还包括分布式数据库的数据同步能力。 | eTS |
-| 元能力 | BackgroundTaskManager | 本示例模拟下载功能,将下载任务通过后台任务管理进行处理,实现退出应用后任务仍能够执行,直至任务结束。 | eTS |
-| 元能力 | BringApp | 本示例使用FeatureAbility接口,通过应用的包名与Ability名,拉起系统应用。 | eTS |
-| 媒体 | VideoPlayer | 本示例展示了在eTS中VideoPlayer如何播放视频,同时提供一个可供其他应用调用播放视频的Ability。 | eTS |
-| 元能力 | DistributeCalc | 本示例使用JS分布式能力实现了一个简单的计算器应用,可以进行简单的数值计算,支持远程拉起另一个计算器FA,两个FA进行协同计算。 | eTS |
-| 媒体 | JSRecorder | 本示例通过调用媒体相关接口来实现音频录制和播放的功能。 | eTS |
-| Web | Browser | 本示例运用OpenHarmony系统提供的Stage模型与相关接口展示了一个简易的浏览器。 | eTS |
-| 元能力 | DeviceUsageStatistics | 本示例主要展示了设备使用信息情况。 | eTS |
-| ArkUI | AdaptiveCapabilities | 本示例展示在eTS中的多设备自适应能力,包括资源限定词、原子布局和响应式布局。 | eTS |
-| ArkUI | Game2048 | 2048是一款比较流行的数字游戏,此游戏demo是grid组件基础上进行开发完成的。 | eTS |
-| 窗口 | Window | 本示例展示了创建新窗口,将应用悬浮在其他界面,及应用分屏等功能 | eTS |
-| 分布式数据管理 | Preference | 本示例主要展示了首选项在主题切换方面的功能。 | eTS |
-| ArkUI | NativeAPI | 本示例展示了在eTS中如何调用C++的接口以及C++如何回调JS,完成了一个简单的五子棋游戏,在native层完成计算逻辑,eTS完成界面绘制和刷新。 | eTS/C++ |
-| 全球化 | International | 本示例展示了i18n,intl,resourceManager在eTS中的使用,使用相关api实现系统语言和地区设置、时间和时区设置,展示了区域格式化示例。 | eTS |
-
-请访问[Samples](https://gitee.com/openharmony/app_samples)仓了解更多信息。
+| ArkUI | [MouseEvent](https://gitee.com/openharmony/applications_app_samples/tree/master/ETSUI/MouseEvent) | 本示例模拟了简单的扫雷游戏调用了鼠标事件的相关接口 | eTS |
+| ArkUI | [Vibrator](https://gitee.com/openharmony/applications_app_samples/tree/master/device/Vibrator) | 本示例模拟倒计时场景,展示振动接口的使用方法。 | eTS |
+| DFX | [FaultLogger](https://gitee.com/openharmony/applications_app_samples/tree/master/DFX/FaultLogger) | 本示例展示了在eTS中如何获取应用故障相关信息。 | eTS |
+| ArkUI | [Gallery](https://gitee.com/openharmony/applications_app_samples/tree/master/ETSUI/Gallery) | 本Demo通过不同示例向用户介绍通用事件、通用属性、手势处理等不同组件的功能。 | eTS |
+| 图形 | [JsWebGL](https://gitee.com/openharmony/applications_app_samples/tree/master/Graphics/JsWebGL) | 本示例调用GPU资源绘制了五角星和矩形,展示WebGL相关接口的使用方法。 | JS |
+| ArkUI | [Clock](https://gitee.com/openharmony/applications_app_samples/tree/master/Preset/Clock) | 本示例使用eTS UI能力实现一个简单的时钟应用。 | eTS |
+| 网络管理 | [Http](https://gitee.com/openharmony/applications_app_samples/tree/master/Network/Http) | 本示例仿postman输入API接口地址,获取相应数据,介绍数据请求接口的用法。 | eTS |
+| 网络管理 | [Socket](https://gitee.com/openharmony/applications_app_samples/tree/master/Network/Socket) | 本示例主要演示了Socket在网络通信方面的应用,展示了Socket在两端设备的连接验证、聊天通信方面的应用。 | eTS |
+| 分布式数据管理 | [DistributedRdb](https://gitee.com/openharmony/applications_app_samples/tree/master/data/DistributedRdb) | 本示例展示了在eTS中分布式关系型数据库的使用,在增、删、改、查的基本操作外,还包括分布式数据库的数据同步能力。 | eTS |
+| 元能力 | [BackgroundTaskManager](https://gitee.com/openharmony/applications_app_samples/tree/master/ResourcesSchedule/BackgroundTaskManager) | 本示例模拟下载功能,将下载任务通过后台任务管理进行处理,实现退出应用后任务仍能够执行,直至任务结束。 | eTS |
+| 元能力 | [BringApp](https://gitee.com/openharmony/applications_app_samples/tree/master/ETSUI/BringApp) | 本示例使用FeatureAbility接口,通过应用的包名与Ability名,拉起系统应用。 | eTS |
+| 媒体 | [VideoPlayer](https://gitee.com/openharmony/applications_app_samples/tree/master/media/VideoPlayer) | 本示例展示了在eTS中VideoPlayer如何播放视频,同时提供一个可供其他应用调用播放视频的Ability。 | eTS |
+| 元能力 | [DistributeCalc](https://gitee.com/openharmony/applications_app_samples/tree/master/Preset/DistributeCalc) | 本示例使用JS分布式能力实现了一个简单的计算器应用,可以进行简单的数值计算,支持远程拉起另一个计算器FA,两个FA进行协同计算。 | eTS |
+| Web | [Browser](https://gitee.com/openharmony/applications_app_samples/tree/master/device/Browser) | 本示例运用OpenHarmony系统提供的Stage模型与相关接口展示了一个简易的浏览器。 | eTS |
+| 元能力 | [DeviceUsageStatistics](https://gitee.com/openharmony/applications_app_samples/tree/master/device/DeviceUsageStatistics) | 本示例主要展示了设备使用信息情况。 | eTS |
+| ArkUI | [AdaptiveCapabilities](https://gitee.com/openharmony/applications_app_samples/tree/master/MultiDeviceAppDev/AdaptiveCapabilities) | 本示例展示在eTS中的多设备自适应能力,包括资源限定词、原子布局和响应式布局。 | eTS |
+| ArkUI | [Game2048](https://gitee.com/openharmony/applications_app_samples/tree/master/ETSUI/Game2048) | 2048是一款比较流行的数字游戏,此游戏demo是grid组件基础上进行开发完成的。 | eTS |
+| 窗口 | [Window](https://gitee.com/openharmony/applications_app_samples/tree/master/Graphics/Window) | 本示例展示了创建新窗口,将应用悬浮在其他界面,及应用分屏等功能 | eTS |
+| 分布式数据管理 | [Preference](https://gitee.com/openharmony/applications_app_samples/tree/master/data/Preferences) | 本示例主要展示了首选项在主题切换方面的功能。 | eTS |
+| ArkUI | [NativeAPI](https://gitee.com/openharmony/applications_app_samples/tree/master/Native/NativeAPI) | 本示例展示了在eTS中如何调用C++的接口以及C++如何回调JS,完成了一个简单的五子棋游戏,在native层完成计算逻辑,eTS完成界面绘制和刷新。 | eTS/C++ |
+| 全球化 | [International](https://gitee.com/openharmony/applications_app_samples/tree/master/common/International) | 本示例展示了i18n,intl,resourceManager在eTS中的使用,使用相关api实现系统语言和地区设置、时间和时区设置,展示了区域格式化示例。 | eTS |
+
+请访问[Samples](https://gitee.com/openharmony/applications_app_samples)仓了解更多信息。
## 修复缺陷列表
@@ -228,5 +226,4 @@ _[API差异报告](api-change/v3.2-beta1/readme.md)_
| ISSUE | 问题描述 | 影响 | 计划解决日期 |
| ------------------------------------------------------------ | ---------------------------------------------------------- | ------------------------------------------------------------ | ------------ |
| [I4Z3G9](https://gitee.com/openharmony/graphic_graphic_2d/issues/I4Z3G9) | 【RK3568】打开沉浸式主窗口和在主窗口上打开辅助窗口出现闪屏 | 影响开发者体验 | 2022-06-15 |
-| [I59M4Q](https://gitee.com/openharmony/developtools_hdc/issues/I59M4Q) | 使用API 9的hdc_std连接设备小概率断连 | 存在低概率断连(几率小于1/30)。可通过重启IDE或者hdc_std恢复。 | 2022-06-30 |
-| [I54D32](https://gitee.com/openharmony/multimedia_camera_standard/issues/I54D32) | 【RK3568】相机连续多次录像出现黑屏 | 影响开发者体验 | 2022-06-15 |
+| [I59M4Q](https://gitee.com/openharmony/developtools_hdc/issues/I59M4Q) | 使用API 9的hdc_std连接设备小概率断连 | 存在低概率断连(几率小于1/30)。可通过重启IDE或者hdc_std恢复。 | 2022-06-30 |
\ No newline at end of file