Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
7aea4206
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
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,发现更多精彩内容 >>
未验证
提交
7aea4206
编写于
4月 13, 2023
作者:
O
openharmony_ci
提交者:
Gitee
4月 13, 2023
浏览文件
操作
浏览文件
下载
差异文件
!17240 规范格式
Merge pull request !17240 from LiAn/master
上级
b14244ad
cdbbd5e1
变更
12
显示空白变更内容
内联
并排
Showing
12 changed file
with
36 addition
and
26 deletion
+36
-26
zh-cn/application-dev/quick-start/arkts-builderparam.md
zh-cn/application-dev/quick-start/arkts-builderparam.md
+1
-0
zh-cn/application-dev/quick-start/arkts-environment.md
zh-cn/application-dev/quick-start/arkts-environment.md
+1
-0
zh-cn/application-dev/quick-start/arkts-persiststorage.md
zh-cn/application-dev/quick-start/arkts-persiststorage.md
+1
-1
zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md
...ion-dev/reference/arkui-ts/ts-components-canvas-lottie.md
+11
-13
zh-cn/application-dev/ui/arkts-common-components-video-player.md
...pplication-dev/ui/arkts-common-components-video-player.md
+3
-0
zh-cn/application-dev/ui/arkts-common-components-xcomponent.md
.../application-dev/ui/arkts-common-components-xcomponent.md
+2
-0
zh-cn/application-dev/ui/arkts-common-events-focus-event.md
zh-cn/application-dev/ui/arkts-common-events-focus-event.md
+5
-4
zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md
...lication-dev/ui/arkts-common-events-touch-screen-event.md
+1
-1
zh-cn/application-dev/ui/arkts-drawing-customization-on-canvas.md
...plication-dev/ui/arkts-drawing-customization-on-canvas.md
+2
-1
zh-cn/application-dev/ui/arkts-graphics-display.md
zh-cn/application-dev/ui/arkts-graphics-display.md
+4
-1
zh-cn/application-dev/ui/arkts-navigation-navigation.md
zh-cn/application-dev/ui/arkts-navigation-navigation.md
+2
-1
zh-cn/application-dev/ui/arkts-routing.md
zh-cn/application-dev/ui/arkts-routing.md
+3
-4
未找到文件。
zh-cn/application-dev/quick-start/arkts-builderparam.md
浏览文件 @
7aea4206
...
...
@@ -157,6 +157,7 @@ struct Parent {
在自定义组件中使用
\@
BuilderParam装饰的属性时也可通过尾随闭包进行初始化。在初始化自定义组件时,组件后紧跟一个大括号“{}”形成尾随闭包场景。
> **说明:**
>
> 此场景下自定义组件内有且仅有一个使用\@BuilderParam装饰的属性。
开发者可以将尾随闭包内的内容看做
\@
Builder装饰的函数传给
\@
BuilderParam。示例如下:
...
...
zh-cn/application-dev/quick-start/arkts-environment.md
浏览文件 @
7aea4206
...
...
@@ -29,6 +29,7 @@ Environment是ArkUI框架在应用程序启动时创建的单例对象。它为A
设备环境到Component的更新链:Environment --
>
AppStorage --
>
Component。
> **说明:**
>
> \@StorageProp关联的环境参数可以在本地更改,但不能同步回AppStorage中,因为应用对环境变量参数是不可写的,只能在Environment中查询。
...
...
zh-cn/application-dev/quick-start/arkts-persiststorage.md
浏览文件 @
7aea4206
...
...
@@ -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”对应的值和其后续的更改将被持久化;
...
...
zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-lottie.md
浏览文件 @
7aea4206
...
...
@@ -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
...
...
@@ -32,7 +30,7 @@ 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”。 |
...
...
zh-cn/application-dev/ui/arkts-common-components-video-player.md
浏览文件 @
7aea4206
...
...
@@ -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
...
...
zh-cn/application-dev/ui/arkts-common-components-xcomponent.md
浏览文件 @
7aea4206
...
...
@@ -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
)
...
...
zh-cn/application-dev/ui/arkts-common-events-focus-event.md
浏览文件 @
7aea4206
...
...
@@ -50,6 +50,7 @@
!
[
zh-cn_image_0000001511740580
](
figures/zh-cn_image_0000001511740580.png
)
>**说明:**
>
> - TAB/SHIFT+TAB键在以上两种走焦规则上的功能和方向键一致。TAB键等同于“先执行方向键右,若无法走焦,再执行方向键下”,SHIFT+TAB键等同于“先执行方向键左,若无法走焦,再执行方向键上”。
>
> - 触发走焦的按键是按下的事件(DOWN事件)。
...
...
zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md
浏览文件 @
7aea4206
...
...
@@ -4,7 +4,7 @@
触屏事件指当手指/手写笔在组件上按下、滑动、抬起时触发的回调事件。包括
[
点击事件
](
#点击事件
)
、
[
拖拽事件
](
#拖拽事件
)
和
[
触摸事件
](
#触摸事件
)
。
**图1
**
触摸事件原理
**图1**
触摸事件原理
![
zh-cn_image_0000001562700461
](
figures/zh-cn_image_0000001562700461.png
)
...
...
zh-cn/application-dev/ui/arkts-drawing-customization-on-canvas.md
浏览文件 @
7aea4206
...
...
@@ -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
...
...
zh-cn/application-dev/ui/arkts-graphics-display.md
浏览文件 @
7aea4206
...
...
@@ -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
)
...
...
zh-cn/application-dev/ui/arkts-navigation-navigation.md
浏览文件 @
7aea4206
...
...
@@ -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个图标的菜单栏
...
...
zh-cn/application-dev/ui/arkts-routing.md
浏览文件 @
7aea4206
...
...
@@ -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()方法,并根据参数决定如何执行跳转。
### 自定义询问框
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录