Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 65bc6467 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!13379 文档整改 

Merge pull request !13379 from 田雨/master
上级 d477785f 3175b96d
显示空白变更内容
内联 并排
Showing with 146 addition and 161 deletion
zh-cn/application-dev/quick-start/arkts-rendering-control.md
浏览文件 @ 65bc6467
...@@ -267,7 +267,7 @@ struct MyComponent { ...@@ -267,7 +267,7 @@ struct MyComponent {
> >
> - 生成的子组件必须是允许包含在LazyForEach父容器组件中的子组件。 > - 生成的子组件必须是允许包含在LazyForEach父容器组件中的子组件。
> >
> - 允许LazyForEach包含在if/else条件渲染语句中，但不允许LazyForEach中出现if/else条件渲染语句。 > - 允许LazyForEach包含在if/else条件渲染语句中。
> >
> - 为了高性能渲染，通过DataChangeListener对象的onDataChange方法来更新UI时，仅当itemGenerator中创建的子组件内使用了状态变量时，才会触发组件刷新。 > - 为了高性能渲染，通过DataChangeListener对象的onDataChange方法来更新UI时，仅当itemGenerator中创建的子组件内使用了状态变量时，才会触发组件刷新。
> >
......
zh-cn/application-dev/reference/apis/js-apis-curve.md
浏览文件 @ 65bc6467
...@@ -58,7 +58,7 @@ stepsCurve(count: number, end: boolean)：ICurve ...@@ -58,7 +58,7 @@ stepsCurve(count: number, end: boolean)：ICurve
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------- | ----| ------------------------------------------------------------ | | ------ | ------- | ----| ------------------------------------------------------------ |
| count | number | 是 | 阶梯的数量，需要为正整数。 | | count | number | 是 | 阶梯的数量，需要为正整数。 |
| end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。<br>-true：在终点发生阶跃变化。<br>-false:在起点发生阶跃变化。 | | end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。<br>-true：在终点发生阶跃变化。<br>-false：在起点发生阶跃变化。 |
**返回值：** **返回值：**
......
zh-cn/application-dev/reference/apis/js-apis-router.md
浏览文件 @ 65bc6467
...@@ -47,8 +47,7 @@ pushUrl(options: RouterOptions): Promise&lt;void&gt; ...@@ -47,8 +47,7 @@ pushUrl(options: RouterOptions): Promise&lt;void&gt;
**示例：** **示例：**
```js ```js
try { router.pushUrl({
router.pushUrl({
url: 'pages/routerpage2', url: 'pages/routerpage2',
params: { params: {
data1: 'message', data1: 'message',
...@@ -56,16 +55,13 @@ try { ...@@ -56,16 +55,13 @@ try {
data3: [123, 456, 789] data3: [123, 456, 789]
} }
} }
}) })
.then(() => { .then(() => {
// success // success
}) })
.catch(err => { .catch(err => {
console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
}) })
} catch (error) {
console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.pushUrl<sup>9+</sup> ## router.pushUrl<sup>9+</sup>
...@@ -96,8 +92,7 @@ pushUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void ...@@ -96,8 +92,7 @@ pushUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void
**示例：** **示例：**
```js ```js
try { router.pushUrl({
router.pushUrl({
url: 'pages/routerpage2', url: 'pages/routerpage2',
params: { params: {
data1: 'message', data1: 'message',
...@@ -105,16 +100,13 @@ try { ...@@ -105,16 +100,13 @@ try {
data3: [123, 456, 789] data3: [123, 456, 789]
} }
} }
}, (err) => { })
if (err) { .then(() => {
// success
})
.catch(err => {
console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
return; })
}
console.info('pushUrl success');
});
} catch (error) {
console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.pushUrl<sup>9+</sup> ## router.pushUrl<sup>9+</sup>
...@@ -135,7 +127,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt; ...@@ -135,7 +127,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
| 类型 | 说明 | | 类型 | 说明 |
| ------------------- | --------- | | ------------------- | --------- |
| Promise&lt;void&gt; | 异常返回结果 | | Promise&lt;void&gt; | 异常返回结果。 |
**错误码：** **错误码：**
...@@ -150,8 +142,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt; ...@@ -150,8 +142,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
**示例：** **示例：**
```js ```js
try { router.pushUrl({
router.pushUrl({
url: 'pages/routerpage2', url: 'pages/routerpage2',
params: { params: {
data1: 'message', data1: 'message',
...@@ -159,16 +150,13 @@ try { ...@@ -159,16 +150,13 @@ try {
data3: [123, 456, 789] data3: [123, 456, 789]
} }
} }
}, router.RouterMode.Standard) }, router.RouterMode.Standard)
.then(() => { .then(() => {
// success // success
}) })
.catch(err => { .catch(err => {
console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
}) })
} catch (error) {
console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.pushUrl<sup>9+</sup> ## router.pushUrl<sup>9+</sup>
...@@ -200,8 +188,7 @@ pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;voi ...@@ -200,8 +188,7 @@ pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;voi
**示例：** **示例：**
```js ```js
try { router.pushUrl({
router.pushUrl({
url: 'pages/routerpage2', url: 'pages/routerpage2',
params: { params: {
data1: 'message', data1: 'message',
...@@ -209,16 +196,13 @@ try { ...@@ -209,16 +196,13 @@ try {
data3: [123, 456, 789] data3: [123, 456, 789]
} }
} }
}, router.RouterMode.Standard, (err) => { }, router.RouterMode.Standard, (err) => {
if (err) { if (err) {
console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
return; return;
} }
console.info('pushUrl success'); console.info('pushUrl success');
}); })
} catch (error) {
console.error(`pushUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.replaceUrl<sup>9+</sup> ## router.replaceUrl<sup>9+</sup>
...@@ -253,22 +237,18 @@ replaceUrl(options: RouterOptions): Promise&lt;void&gt; ...@@ -253,22 +237,18 @@ replaceUrl(options: RouterOptions): Promise&lt;void&gt;
**示例：** **示例：**
```js ```js
try { router.replaceUrl({
router.replaceUrl({
url: 'pages/detail', url: 'pages/detail',
params: { params: {
data1: 'message' data1: 'message'
} }
}) })
.then(() => { .then(() => {
// success // success
}) })
.catch(err => { .catch(err => {
console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
}) })
} catch (error) {
console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.replaceUrl<sup>9+</sup> ## router.replaceUrl<sup>9+</sup>
...@@ -298,22 +278,18 @@ replaceUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void ...@@ -298,22 +278,18 @@ replaceUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void
**示例：** **示例：**
```js ```js
try { router.replaceUrl({
router.replaceUrl({
url: 'pages/detail', url: 'pages/detail',
params: { params: {
data1: 'message' data1: 'message'
} }
}, (err) => { }, (err) => {
if (err) { if (err) {
console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
return; return;
} }
console.info('replaceUrl success'); console.info('replaceUrl success');
}); })
} catch (error) {
console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.replaceUrl<sup>9+</sup> ## router.replaceUrl<sup>9+</sup>
...@@ -350,22 +326,18 @@ replaceUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt; ...@@ -350,22 +326,18 @@ replaceUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
**示例：** **示例：**
```js ```js
try { router.replaceUrl({
router.replaceUrl({
url: 'pages/detail', url: 'pages/detail',
params: { params: {
data1: 'message' data1: 'message'
} }
}, router.RouterMode.Standard) }, router.RouterMode.Standard)
.then(() => { .then(() => {
// success // success
}) })
.catch(err => { .catch(err => {
console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
}) })
} catch (error) {
console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.replaceUrl<sup>9+</sup> ## router.replaceUrl<sup>9+</sup>
...@@ -396,22 +368,19 @@ replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt; ...@@ -396,22 +368,19 @@ replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;
**示例：** **示例：**
```js ```js
try { router.replaceUrl({
router.replaceUrl({
url: 'pages/detail', url: 'pages/detail',
params: { params: {
data1: 'message' data1: 'message'
} }
}, router.RouterMode.Standard, (err) => { }, router.RouterMode.Standard, (err) => {
if (err) { if (err) {
console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`); console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
return; return;
} }
console.info('replaceUrl success'); console.info('replaceUrl success');
}); });
} catch (error) {
console.error(`replaceUrl args error code is ${error.code}, message is ${error.message}`);
};
``` ```
## router.back ## router.back
...@@ -572,8 +541,8 @@ getParams(): Object ...@@ -572,8 +541,8 @@ getParams(): Object
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------ | ----------------- | | ------ | ---------------------------------- |
| Object | 发起跳转的页面往当前页传入的参数。 | | object | 发起跳转的页面往当前页传入的参数。 |
**示例：** **示例：**
...@@ -636,7 +605,7 @@ export default { ...@@ -636,7 +605,7 @@ export default {
### 基于TS扩展的声明式开发范式 ### 基于TS扩展的声明式开发范式
```ts ```ts
// 通过router.push跳转至目标页携带params参数 // 通过router.pushUrl跳转至目标页携带params参数
import router from '@ohos.router' import router from '@ohos.router'
@Entry @Entry
......
zh-cn/application-dev/reference/apis/js-apis-system-router.md
浏览文件 @ 65bc6467
...@@ -396,5 +396,5 @@ export default { ...@@ -396,5 +396,5 @@ export default {
## ParamsInterface ## ParamsInterface
| 名称 | 参数类型 | 说明 | | 名称 | 参数类型 | 说明 |
| ------------- | ------ | ------- | | ------------- | -------- | -------------- |
| [key: string] | Object | 路由参数列表。 | | [key: string] | object | 路由参数列表。 |
zh-cn/application-dev/reference/arkui-ts/ts-container-listitem.md
浏览文件 @ 65bc6467
# ListItem # ListItem
用来展示列表具体item，宽度默认充满List组件，必须配合List来使用。 用来展示列表具体item，必须配合List来使用。
> **说明：** > **说明：**
> >
......
zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
浏览文件 @ 65bc6467
...@@ -131,7 +131,7 @@ scrollToIndex(value: number): void ...@@ -131,7 +131,7 @@ scrollToIndex(value: number): void
> **说明：** > **说明：**
> >
> 仅支持list组件。 > 仅支持Grid、list、WaterFlow组件。
**参数：** **参数：**
......
zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
浏览文件 @ 65bc6467
...@@ -60,4 +60,20 @@ struct TransitionExample { ...@@ -60,4 +60,20 @@ struct TransitionExample {
} }
``` ```
![animateTo](figures/animateTo.gif) 示意图：
\ No newline at end of file
图片完全显示时：
![animationComponent1](figures/animationComponent1.png)
图片消失时配置顺时针旋转180°的过渡效果：
![animationComponent3](figures/animationComponent3.png)
图片完全消失时：
![animationComponent2](figures/animationComponent2.png)
图片显示时配置横向放大一倍的过渡效果：
![animationComponent4](figures/animationComponent4.png)
\ No newline at end of file
zh-cn/application-dev/ui/ui-ts-building-data-model.md
浏览文件 @ 65bc6467
...@@ -59,7 +59,7 @@ ...@@ -59,7 +59,7 @@
] ]
``` ```
实际开发中，开发者可以自定义更多的数据资源，当食物资源很多时，建议使用数据懒加载LazyForEach。 实际开发中，开发者可以自定义更多的数据资源，当食物资源很多时，建议使用[数据懒加载LazyForEach](../quick-start/arkts-rendering-control.md#数据懒加载)。
5. 创建initializeOnStartUp方法来初始化FoodData的数组。在FoodDataModels.ets中使用了定义在FoodData.ets的FoodData和Category，所以要将FoodData.ets的FoodData类export，在FoodDataModels.ets内import FoodData和Category。 5. 创建initializeOnStartUp方法来初始化FoodData的数组。在FoodDataModels.ets中使用了定义在FoodData.ets的FoodData和Category，所以要将FoodData.ets的FoodData类export，在FoodDataModels.ets内import FoodData和Category。
```ts ```ts
......
zh-cn/application-dev/ui/ui-ts-layout-grid-container-new.md
浏览文件 @ 65bc6467
...@@ -88,7 +88,7 @@ GridRow({ ...@@ -88,7 +88,7 @@ GridRow({
}.backgroundColor(color) }.backgroundColor(color)
}) })
} }
``` ```
![](figures/breakpoints.gif) ![](figures/breakpoints.gif)
...@@ -333,8 +333,8 @@ GridCol组件作为GridRow组件的子组件，通过给GridCol传参或者设 ...@@ -333,8 +333,8 @@ GridCol组件作为GridRow组件的子组件，通过给GridCol传参或者设
### order ### order
栅格子组件的序号，决定子组件排列次序。当子组件不设置order或者设置相同的order, 子组件按照代码顺序展示。当子组件设置不同的order时，order较大的组件在前，较小的在后。 栅格子组件的序号，决定子组件排列次序。当子组件不设置order或者设置相同的order, 子组件按照代码顺序展示。当子组件设置不同的order时，order较小的组件在前，较大的在后。
当子组件部分设置order，部分不设置order时，未设置order的子组件依次排序靠前，设置了order的子组件按照数值从大到小排列。 当子组件部分设置order，部分不设置order时，未设置order的子组件依次排序靠前，设置了order的子组件按照数值从小到大排列。
- 当类型为number时，子组件在任何尺寸下排序次序一致。 - 当类型为number时，子组件在任何尺寸下排序次序一致。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或