diff --git a/zh-cn/application-dev/quick-start/arkts-builderparam.md b/zh-cn/application-dev/quick-start/arkts-builderparam.md index cb4b6e274ab20da9fe3493a0d1d167883648986a..dc606cb66e6ba4731d611f4769f2b90d6e452437 100644 --- a/zh-cn/application-dev/quick-start/arkts-builderparam.md +++ b/zh-cn/application-dev/quick-start/arkts-builderparam.md @@ -157,6 +157,7 @@ struct Parent { 在自定义组件中使用\@BuilderParam装饰的属性时也可通过尾随闭包进行初始化。在初始化自定义组件时，组件后紧跟一个大括号“{}”形成尾随闭包场景。 > **说明：** +> > 此场景下自定义组件内有且仅有一个使用\@BuilderParam装饰的属性。 开发者可以将尾随闭包内的内容看做\@Builder装饰的函数传给\@BuilderParam。示例如下： diff --git a/zh-cn/application-dev/quick-start/arkts-environment.md b/zh-cn/application-dev/quick-start/arkts-environment.md index 240e4358842abcd0beb42e21fc819af60032abcb..65f0b59d95f7da17638b65ec145409d691659ba9 100644 --- a/zh-cn/application-dev/quick-start/arkts-environment.md +++ b/zh-cn/application-dev/quick-start/arkts-environment.md @@ -29,6 +29,7 @@ Environment是ArkUI框架在应用程序启动时创建的单例对象。它为A 设备环境到Component的更新链：Environment --> AppStorage -->Component。 > **说明：** +> > \@StorageProp关联的环境参数可以在本地更改，但不能同步回AppStorage中，因为应用对环境变量参数是不可写的，只能在Environment中查询。 diff --git a/zh-cn/application-dev/quick-start/arkts-persiststorage.md b/zh-cn/application-dev/quick-start/arkts-persiststorage.md index a50cbe24ed891c59250e206ccfa291da2c974481..f6af22c37e5621c8102087df49f03910f52d7811 100644 --- a/zh-cn/application-dev/quick-start/arkts-persiststorage.md +++ b/zh-cn/application-dev/quick-start/arkts-persiststorage.md @@ -77,7 +77,7 @@ struct Index { ``` - 新应用安装后首次启动运行： - 1. 调用PersistProp初始化PersistentStorage，首先查询在PersistentStorage本地文件中是否存在“aProp”，查询结果为不存在，因为应用是第一次安装。； + 1. 调用PersistProp初始化PersistentStorage，首先查询在PersistentStorage本地文件中是否存在“aProp”，查询结果为不存在，因为应用是第一次安装； 2. 接着查询属性“aProp”在AppStorage中是否存在，依旧不存在； 3. 在AppStorge中创建名为“aProp”的number类型属性，属性初始值是定义的默认值47； 4. PersistentStorage将属性“aProp”和值47写入磁盘，AppStorage中“aProp”对应的值和其后续的更改将被持久化； diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md b/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md index df3de28fed5d376b25533ec9b27f0a0a83b79f89..4960a4ec7f300407af72a9d8a25eb00ab287100a 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md @@ -3,7 +3,7 @@ 提供Lottie动画。 > **说明：** -> +> > 从 API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 @@ -16,9 +16,7 @@ import lottie from '@ohos/lottieETS' > **说明：** > -> 在Terminal窗口使用 `npm install @ohos/lottieETS` 命令下载Lottie，下载之前需要配置权限。 -> -> 安装ohos npm 三方包时，需要先执行`npm config set @ohos:registry=https://repo.harmonyos.com/npm/`设置仓库地址。 +> 在第一次使用Lottie之前，需要在Terminal窗口运行 `ohpm install @ohos/lottieETS` 命令下载Lottie。 ## lottie.loadAnimation @@ -31,15 +29,15 @@ path: string, container: object, render: string, loop: boolean, autoplay: boolea **参数：** -| 参数 | 类型 | 必填 | 描述 | -| -------------- | --------------------------- | ---- | ------------------------------------------------------------ | -| path | string | 是 | HAP内动画资源文件路径，仅支持json格式。示例：path: "common/lottie/data.json" | -| container | object | 是 | canvas绘图上下文，声明范式需提前声明CanvasRenderingContext2D。 | -| render | string | 是 | 渲染类型，仅支持“canvas”。 | -| loop | boolean \| number | 否 | 动画播放结束后，是否循环播放，默认值true。值类型为number，且大于等于1时为设置的重复播放的次数。 | -| autoplay | boolean | 否 | 是否自动播放动画，默认值true。 | -| name | string | 否 | 开发者自定义的动画名称，后续支持通过该名称引用控制动画，默认为空。 | -| initialSegment | [number, number] | 否 | 指定动画播放的起始帧号，指定动画播放的结束帧号。 | +| 参数 | 类型 | 必填 | 描述 | +| -------------- | --------------------------- | ---- | ---------------------------------------- | +| path | string | 是 | HAP内动画资源文件路径，仅支持json格式。示例：path: "common/lottie/data.json" | +| container | object | 是 | canvas绘图上下文，声明范式需提前声明CanvasRenderingContext2D。 | +| render | string | 是 | 渲染类型，仅支持“canvas”。 | +| loop | boolean \| number | 否 | 动画播放结束后，是否循环播放，默认值true。值类型为number，且大于等于1时为设置的重复播放的次数。 | +| autoplay | boolean | 否 | 是否自动播放动画，默认值true。 | +| name | string | 否 | 开发者自定义的动画名称，后续支持通过该名称引用控制动画，默认为空。 | +| initialSegment | [number, number] | 否 | 指定动画播放的起始帧号，指定动画播放的结束帧号。 | ## lottie.destroy diff --git a/zh-cn/application-dev/ui/arkts-common-components-video-player.md b/zh-cn/application-dev/ui/arkts-common-components-video-player.md index 8bc03f4d17169840af1fe703f27954e12afd2457..efc9efde21295e8bc414e546df5e4ffc2bd43eee 100644 --- a/zh-cn/application-dev/ui/arkts-common-components-video-player.md +++ b/zh-cn/application-dev/ui/arkts-common-components-video-player.md @@ -24,6 +24,7 @@ Video组件支持加载本地视频和网络视频。 ### 加载本地视频 - 普通本地视频。 + 加载本地视频时，首先在本地rawfile目录指定对应的文件，如下图所示。 ![zh-cn_image_0000001562700409](figures/zh-cn_image_0000001562700409.png) @@ -158,6 +159,7 @@ struct VideoPlayer{ Video控制器主要用于控制视频的状态，包括播放、暂停、停止以及设置进度等，详细的使用请参考[VideoController使用说明](../reference/arkui-ts/ts-media-components-video.md#videocontroller)。 - 默认控制器 + 默认的控制器支持视频的开始、暂停、进度调整、全屏显示四项基本功能。 ```ts @@ -184,6 +186,7 @@ Video控制器主要用于控制视频的状态，包括播放、暂停、停止 ``` - 自定义控制器 + 使用自定义的控制器，先将默认控制器关闭掉，之后可以使用button以及slider等组件进行自定义的控制与显示，适合自定义较强的场景下使用。 ```ts diff --git a/zh-cn/application-dev/ui/arkts-common-components-xcomponent.md b/zh-cn/application-dev/ui/arkts-common-components-xcomponent.md index b2e72c0310aba5e3c190db64e39645a0ebaef34d..b3fb7674e968e5153a9215a62e9357727bed702d 100644 --- a/zh-cn/application-dev/ui/arkts-common-components-xcomponent.md +++ b/zh-cn/application-dev/ui/arkts-common-components-xcomponent.md @@ -189,6 +189,7 @@ XComponent({ id: 'xcomponentId1', type: 'surface', libraryname: 'nativerender' } - id : 与XComponent组件为一一对应关系，不可重复。通常开发者可以在native侧通过OH_NativeXComponent_GetXComponentId接口来获取对应的id从而绑定对应的XComponent。 - libraryname：加载模块的名称，必须与在native侧Napi模块注册时nm_modname的名字一致。 + >**说明：** > > 应用加载模块实现跨语言调用有两种方式： @@ -210,6 +211,7 @@ XComponent({ id: 'xcomponentId1', type: 'surface', libraryname: 'nativerender' } ![图片2](figures/图片2.png) - onDestroy事件 + 触发时刻：XComponent组件被销毁时触发与一般ArkUI的组件销毁时机一致，其和native侧的OnSurfaceDestroyed的时序如下图： ![图片3](figures/图片3.png) diff --git a/zh-cn/application-dev/ui/arkts-common-events-focus-event.md b/zh-cn/application-dev/ui/arkts-common-events-focus-event.md index 721b2f932a653d931089daad780254d148c0aa08..75e94b0f315668f54bb76df57a7040354afbb813 100644 --- a/zh-cn/application-dev/ui/arkts-common-events-focus-event.md +++ b/zh-cn/application-dev/ui/arkts-common-events-focus-event.md @@ -37,19 +37,20 @@ - 线性走焦：常见的容器有Flex、Row、Column、List，这些都是典型的单方向容器，组件在这些容器内的排列都是线性的，那么走焦规则也是线性的。走焦的方向和方向键的方向一致。 - **图1** 线性走焦示意图   + **图1** 线性走焦示意图   - ![zh-cn_image_0000001562700537](figures/zh-cn_image_0000001562700537.png) + ![zh-cn_image_0000001562700537](figures/zh-cn_image_0000001562700537.png) 例如Row容器，使用方向键左右（←/→）即可将焦点在相邻的2个可获焦组件之间来回切换。 - 十字走焦：使用方向键上(↑)下(↓)左(←)右(→)可以使焦点在相邻的组件上切换。典型的是Grid容器，如下图： - **图2** Grid组件十字走焦示意图   + **图2** Grid组件十字走焦示意图   - ![zh-cn_image_0000001511740580](figures/zh-cn_image_0000001511740580.png) + ![zh-cn_image_0000001511740580](figures/zh-cn_image_0000001511740580.png) >**说明：** + > > - TAB/SHIFT+TAB键在以上两种走焦规则上的功能和方向键一致。TAB键等同于“先执行方向键右，若无法走焦，再执行方向键下”，SHIFT+TAB键等同于“先执行方向键左，若无法走焦，再执行方向键上”。 > > - 触发走焦的按键是按下的事件（DOWN事件）。 diff --git a/zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md b/zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md index 48e63b278e9d9ad783ce165e15070dd80f8b05fd..0675d83fb4ae6d558b03081a103019aef39e4ec8 100644 --- a/zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md +++ b/zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md @@ -4,7 +4,7 @@ 触屏事件指当手指/手写笔在组件上按下、滑动、抬起时触发的回调事件。包括[点击事件](#点击事件)、[拖拽事件](#拖拽事件)和[触摸事件](#触摸事件)。 -**图1 ** 触摸事件原理 +**图1** 触摸事件原理 ![zh-cn_image_0000001562700461](figures/zh-cn_image_0000001562700461.png) diff --git a/zh-cn/application-dev/ui/arkts-drawing-customization-on-canvas.md b/zh-cn/application-dev/ui/arkts-drawing-customization-on-canvas.md index 6ab0c64456faca68440b8806926794edcda16603..ab01b4499f00cd60e282874ecf0005c62df7c736 100644 --- a/zh-cn/application-dev/ui/arkts-drawing-customization-on-canvas.md +++ b/zh-cn/application-dev/ui/arkts-drawing-customization-on-canvas.md @@ -245,6 +245,7 @@ OffscreenCanvasRenderingContext2D对象和CanvasRenderingContext2D对象提供 ![drawimage](figures/drawimage.PNG) - 其他方法。 + Canvas中还提供其他类型的方法。渐变（[CanvasGradient对象](../reference/arkui-ts/ts-components-canvas-canvasgradient.md)）相关的方法：[createLinearGradient](../reference/arkui-ts/ts-canvasrenderingcontext2d.md#createlineargradient)（创建一个线性渐变色）、[createRadialGradient](../reference/arkui-ts/ts-canvasrenderingcontext2d.md#createradialgradient)（创建一个径向渐变色）等。 ```ts @@ -270,7 +271,7 @@ OffscreenCanvasRenderingContext2D对象和CanvasRenderingContext2D对象提供 ## 场景示例 -- 规则基础形状绘制： +- 规则基础形状绘制。 ```ts @Entry diff --git a/zh-cn/application-dev/ui/arkts-graphics-display.md b/zh-cn/application-dev/ui/arkts-graphics-display.md index 9caa1099285ce8c39dc0d043f174ba98656aff41..0f415eee201bf176ccf23741d554295206afcb43 100644 --- a/zh-cn/application-dev/ui/arkts-graphics-display.md +++ b/zh-cn/application-dev/ui/arkts-graphics-display.md @@ -123,6 +123,7 @@ Image支持加载存档图、多媒体像素图两种类型。 ``` - base64 + 路径格式为data:image/[png|jpeg|bmp|webp];base64,[base64 data]，其中[base64 data]为Base64字符串数据。 Base64格式字符串可用于存储图片的像素数据，在网页上使用较为广泛。 @@ -130,7 +131,7 @@ Image支持加载存档图、多媒体像素图两种类型。 ### 多媒体像素图 -PixelMap是图片解码后的像素图，具体用法请参考[图片开发指导](../media/image.md)。以下示例将加载的网络图片返回的数据解码成PixelMap格式，再显示在Image组件上， +PixelMap是图片解码后的像素图，具体用法请参考[图片开发指导](../media/image-overview.md)。以下示例将加载的网络图片返回的数据解码成PixelMap格式，再显示在Image组件上， 1. 创建PixelMap状态变量。 @@ -201,9 +202,11 @@ Image($r('app.media.cloud')).width(50) ``` **图3** 原始图片   + ![屏幕截图_20230223_141141](figures/屏幕截图_20230223_141141.png) **图4** 设置绘制颜色后的svg图片   + ![屏幕截图_20230223_141404](figures/屏幕截图_20230223_141404.png) diff --git a/zh-cn/application-dev/ui/arkts-navigation-navigation.md b/zh-cn/application-dev/ui/arkts-navigation-navigation.md index 95b29d505205845a7b2429a18eecdda82569b1eb..c809d04fade19c6f9aa6be28fd9c183d7947127b 100644 --- a/zh-cn/application-dev/ui/arkts-navigation-navigation.md +++ b/zh-cn/application-dev/ui/arkts-navigation-navigation.md @@ -15,6 +15,7 @@ NavRouter是和Navigation搭配使用的特殊子组件，默认提供点击响 Navigation组件通过mode属性设置页面的显示模式。 - 自适应模式 + Navigation组件默认为自适应模式，此时mode属性为NavigationMode.Auto。自适应模式下，当设备宽度大于520vp时，Navigation组件采用分栏模式，反之采用单页面模式。 @@ -152,7 +153,7 @@ Navigation组件通过mode属性设置页面的显示模式。 ## 设置菜单栏 -菜单栏位于Navigation组件的右上角，开发者可以通过menus属性进行设置。menus支持Array<[NavigationMenuItem](../reference/arkui-ts/ts-basic-components-navigation.md#navigationmenuitem%E7%B1%BB%E5%9E%8B%E8%AF%B4%E6%98%8E)>和CustomBuilder两种参数类型。使用Array<NavigationMenuItem>类型时，竖屏最多支持显示3个图标，横屏最多支持显示5个图标，多余的图标会被放入自动生成的更多图标。 +菜单栏位于Navigation组件的右上角，开发者可以通过menus属性进行设置。menus支持Array<[NavigationMenuItem](../reference/arkui-ts/ts-basic-components-navigation.md#navigationmenuitem)>和CustomBuilder两种参数类型。使用Array<NavigationMenuItem>类型时，竖屏最多支持显示3个图标，横屏最多支持显示5个图标，多余的图标会被放入自动生成的更多图标。 **图5** 设置了3个图标的菜单栏   diff --git a/zh-cn/application-dev/ui/arkts-routing.md b/zh-cn/application-dev/ui/arkts-routing.md index ce4ea37d5280c74b0fafb694313122b9c1de79e7..cc585fc3975a17eb1a7628d0f1d0e521299bc360 100644 --- a/zh-cn/application-dev/ui/arkts-routing.md +++ b/zh-cn/application-dev/ui/arkts-routing.md @@ -272,11 +272,10 @@ function onBackClick(): void { 其中，router.showAlertBeforeBackPage()方法接收一个对象作为参数，该对象包含以下属性： -- message：string类型，表示询问框的内容。 - 如果调用成功，则会在目标界面开启页面返回询问框；如果调用失败，则会抛出异常，并通过err.code和err.message获取错误码和错误信息。 - - 当用户点击“返回”按钮时，会弹出确认对话框，询问用户是否确认返回。选择“取消”将停留在当前页目标页；选择“确认”将触发router.back()方法，并根据参数决定如何执行跳转。 +message：string类型，表示询问框的内容。 +如果调用成功，则会在目标界面开启页面返回询问框；如果调用失败，则会抛出异常，并通过err.code和err.message获取错误码和错误信息。 +当用户点击“返回”按钮时，会弹出确认对话框，询问用户是否确认返回。选择“取消”将停留在当前页目标页；选择“确认”将触发router.back()方法，并根据参数决定如何执行跳转。 ### 自定义询问框