Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
aa2d1e93
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
aa2d1e93
编写于
8月 17, 2023
作者:
O
openharmony_ci
提交者:
Gitee
8月 17, 2023
浏览文件
操作
浏览文件
下载
差异文件
!22455 规范性问题修改
Merge pull request !22455 from LiAn/master
上级
47ca3529
a981c76b
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
11 addition
and
12 deletion
+11
-12
zh-cn/application-dev/quick-start/arkts-observed-and-objectlink.md
...lication-dev/quick-start/arkts-observed-and-objectlink.md
+1
-1
zh-cn/application-dev/quick-start/arkts-persiststorage.md
zh-cn/application-dev/quick-start/arkts-persiststorage.md
+9
-9
zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md
...cation-dev/quick-start/arkts-rendering-control-foreach.md
+1
-1
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+0
-1
未找到文件。
zh-cn/application-dev/quick-start/arkts-observed-and-objectlink.md
浏览文件 @
aa2d1e93
...
@@ -15,7 +15,7 @@
...
@@ -15,7 +15,7 @@
-
被
\@
Observed装饰的类,可以被观察到属性的变化;
-
被
\@
Observed装饰的类,可以被观察到属性的变化;
-
子组件中
\@
ObjectLink装饰器装饰的状态变量用于接收
\@
Observed装饰的类的实例,和父组件中对应的状态变量建立双向数据绑定。这个实例可以是数组中的被
\@
Observed装饰的项,或者是class object中
是
属性,这个属性同样也需要被
\@
Observed装饰。
-
子组件中
\@
ObjectLink装饰器装饰的状态变量用于接收
\@
Observed装饰的类的实例,和父组件中对应的状态变量建立双向数据绑定。这个实例可以是数组中的被
\@
Observed装饰的项,或者是class object中
的
属性,这个属性同样也需要被
\@
Observed装饰。
-
单独使用
\@
Observed是没有任何作用的,需要搭配
\@
ObjectLink或者
[
\@Prop
](
arkts-prop.md
)
使用。
-
单独使用
\@
Observed是没有任何作用的,需要搭配
\@
ObjectLink或者
[
\@Prop
](
arkts-prop.md
)
使用。
...
...
zh-cn/application-dev/quick-start/arkts-persiststorage.md
浏览文件 @
aa2d1e93
...
@@ -78,10 +78,10 @@ struct Index {
...
@@ -78,10 +78,10 @@ struct Index {
```
```
-
新应用安装后首次启动运行:
-
新应用安装后首次启动运行:
1.
调用PersistProp初始化PersistentStorage,首先查询在PersistentStorage本地文件中是否存在“aProp”,查询结果为不存在,因为应用是第一次安装
;
1.
调用PersistProp初始化PersistentStorage,首先查询在PersistentStorage本地文件中是否存在“aProp”,查询结果为不存在,因为应用是第一次安装
。
2.
接着查询属性“aProp”在AppStorage中是否存在,依旧不存在
;
2.
接着查询属性“aProp”在AppStorage中是否存在,依旧不存在
。
3.
在AppStorge中创建名为“aProp”的number类型属性,属性初始值是定义的默认值47
;
3.
在AppStorge中创建名为“aProp”的number类型属性,属性初始值是定义的默认值47
。
4.
PersistentStorage将属性“aProp”和值47写入磁盘,AppStorage中“aProp”对应的值和其后续的更改将被持久化
;
4.
PersistentStorage将属性“aProp”和值47写入磁盘,AppStorage中“aProp”对应的值和其后续的更改将被持久化
。
5.
在Index组件中创建状态变量
\@
StorageLink('aProp') aProp,和AppStorage中“aProp”双向绑定,在创建的过程中会在AppStorage中查找,成功找到“aProp”,所以使用其在AppStorage找到的值47。
5.
在Index组件中创建状态变量
\@
StorageLink('aProp') aProp,和AppStorage中“aProp”双向绑定,在创建的过程中会在AppStorage中查找,成功找到“aProp”,所以使用其在AppStorage找到的值47。
**图1**
PersistProp初始化流程
**图1**
PersistProp初始化流程
...
@@ -89,14 +89,14 @@ struct Index {
...
@@ -89,14 +89,14 @@ struct Index {
![
zh-cn_image_0000001553348833
](
figures/zh-cn_image_0000001553348833.png
)
![
zh-cn_image_0000001553348833
](
figures/zh-cn_image_0000001553348833.png
)
-
触发点击事件后:
-
触发点击事件后:
1.
状态变量
\@
StorageLink('aProp') aProp改变,触发Text组件重新刷新
;
1.
状态变量
\@
StorageLink('aProp') aProp改变,触发Text组件重新刷新
。
2.
\@
StorageLink装饰的变量是和AppStorage中建立双向同步的,所以
\@
StorageLink('aProp') aProp的变化会被同步回AppStorage中
;
2.
\@
StorageLink装饰的变量是和AppStorage中建立双向同步的,所以
\@
StorageLink('aProp') aProp的变化会被同步回AppStorage中
。
3.
AppStorage中“aProp”属性的改变会同步到所有绑定该“aProp”的单向或者双向变量,在本示例中没有其他的绑定“aProp”的变量
;
3.
AppStorage中“aProp”属性的改变会同步到所有绑定该“aProp”的单向或者双向变量,在本示例中没有其他的绑定“aProp”的变量
。
4.
因为“aProp”对应的属性已经被持久化,所以在AppStorage中“aProp”的改变会触发PersistentStorage,将新的改变写入本地磁盘。
4.
因为“aProp”对应的属性已经被持久化,所以在AppStorage中“aProp”的改变会触发PersistentStorage,将新的改变写入本地磁盘。
-
后续启动应用:
-
后续启动应用:
1.
执行PersistentStorage.PersistProp('aProp', 47),在首先查询在PersistentStorage本地文件查询“aProp”属性,成功查询到
;
1.
执行PersistentStorage.PersistProp('aProp', 47),在首先查询在PersistentStorage本地文件查询“aProp”属性,成功查询到
。
2.
将在PersistentStorage查询到的值写入AppStorage中
;
2.
将在PersistentStorage查询到的值写入AppStorage中
。
3.
在Index组件里,
\@
StorageLink绑定的“aProp”为PersistentStorage写入AppStorage中的值,即为上一次退出引用存入的值。
3.
在Index组件里,
\@
StorageLink绑定的“aProp”为PersistentStorage写入AppStorage中的值,即为上一次退出引用存入的值。
...
...
zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md
浏览文件 @
aa2d1e93
...
@@ -22,7 +22,7 @@ ForEach(
...
@@ -22,7 +22,7 @@ ForEach(
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------------- | ---------------------------------------- | ---- | ---------------------------------------- |
| ------------- | ---------------------------------------- | ---- | ---------------------------------------- |
| arr | Array | 是 | 必须是数组,允许设置为空数组,空数组场景下将不会创建子组件。同时允许设置返回值为数组类型的函数,例如arr.slice(1,
3),设置的函数不得改变包括数组本身在内的任何状态变量,如Array.splice、Array.sort或Array.reverse这些改变原数组的函数。 |
| arr | Array | 是 | 必须是数组,允许设置为空数组,空数组场景下将不会创建子组件。同时允许设置返回值为数组类型的函数,例如arr.slice(1,
3),设置的函数不得改变包括数组本身在内的任何状态变量,如Array.splice、Array.sort或Array.reverse这些改变原数组的函数。 |
| itemGenerator | (item:
any,
index?:
number)
=
>
void | 是 | 生成子组件的lambda函数,为数组中的每一个数据项创建一个或多个子组件,单个子组件或子组件列表必须包括在大括号“{...}”中。
<br/>
**说明:**
<br/>
-
子组件的类型必须是ForEach的父容器组件所允许的(例如,只有当ForEach父级为List组件时,才允许Li
tem
Item子组件)。
<br/>
-
允许子类构造函数返回if或另一个ForEach。ForEach可以在if内的任意位置。
<br/>
-
可选index参数如在函数体中使用,则必须仅在函数签名中指定。 |
| itemGenerator | (item:
any,
index?:
number)
=
>
void | 是 | 生成子组件的lambda函数,为数组中的每一个数据项创建一个或多个子组件,单个子组件或子组件列表必须包括在大括号“{...}”中。
<br/>
**说明:**
<br/>
-
子组件的类型必须是ForEach的父容器组件所允许的(例如,只有当ForEach父级为List组件时,才允许Li
st
Item子组件)。
<br/>
-
允许子类构造函数返回if或另一个ForEach。ForEach可以在if内的任意位置。
<br/>
-
可选index参数如在函数体中使用,则必须仅在函数签名中指定。 |
| keyGenerator | (item:
any,
index?:
number)
=
>
string | 否 | 匿名函数,用于给数组中的每一个数据项生成唯一且固定的键值。键值生成器的功能是可选的,但是,为了使开发框架能够更好地识别数组更改,提高性能,建议提供。如将数组反向时,如果没有提供键值生成器,则ForEach中的所有节点都将重建。
<br/>
**说明:**
<br/>
-
同一数组中的不同项绝对不能计算出相同的ID。
<br/>
-
如果未使用index参数,则项在数组中的位置变动不得改变项的键值。如果使用了index参数,则当项在数组中的位置有变动时,键值必须更改。
<br/>
-
当某个项目被新项替换(值不同)时,被替换的项键值和新项的键值必须不同。
<br/>
-
在构造函数中使用index参数时,键值生成函数也必须使用该参数。
<br>
-
键值生成函数不允许改变任何组件状态。 |
| keyGenerator | (item:
any,
index?:
number)
=
>
string | 否 | 匿名函数,用于给数组中的每一个数据项生成唯一且固定的键值。键值生成器的功能是可选的,但是,为了使开发框架能够更好地识别数组更改,提高性能,建议提供。如将数组反向时,如果没有提供键值生成器,则ForEach中的所有节点都将重建。
<br/>
**说明:**
<br/>
-
同一数组中的不同项绝对不能计算出相同的ID。
<br/>
-
如果未使用index参数,则项在数组中的位置变动不得改变项的键值。如果使用了index参数,则当项在数组中的位置有变动时,键值必须更改。
<br/>
-
当某个项目被新项替换(值不同)时,被替换的项键值和新项的键值必须不同。
<br/>
-
在构造函数中使用index参数时,键值生成函数也必须使用该参数。
<br>
-
键值生成函数不允许改变任何组件状态。 |
...
...
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
aa2d1e93
...
@@ -204,7 +204,6 @@
...
@@ -204,7 +204,6 @@
-
[
@ohos.arkui.inspector (布局回调)
](
js-apis-arkui-inspector.md
)
-
[
@ohos.arkui.inspector (布局回调)
](
js-apis-arkui-inspector.md
)
-
[
@ohos.arkui.performanceMonitor (性能监测)
](
js-apis-arkui-performancemonitor.md
)
-
[
@ohos.arkui.performanceMonitor (性能监测)
](
js-apis-arkui-performancemonitor.md
)
-
[
@ohos.arkui.UIContext (UIContext)
](
js-apis-arkui-UIContext.md
)
-
[
@ohos.arkui.UIContext (UIContext)
](
js-apis-arkui-UIContext.md
)
-
[
@ohos.arkui.componentUtils (componentUtils)
](
js-apis-arkui-componentUtils.md
)
-
[
@ohos.curves (插值计算)
](
js-apis-curve.md
)
-
[
@ohos.curves (插值计算)
](
js-apis-curve.md
)
-
[
@ohos.font (注册自定义字体)
](
js-apis-font.md
)
-
[
@ohos.font (注册自定义字体)
](
js-apis-font.md
)
-
[
@ohos.matrix4 (矩阵变换)
](
js-apis-matrix4.md
)
-
[
@ohos.matrix4 (矩阵变换)
](
js-apis-matrix4.md
)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录