Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
dfeeecfb
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
提交
dfeeecfb
编写于
12月 15, 2022
作者:
H
HelloCrease
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs
Signed-off-by:
N
HelloCrease
<
lian15@huawei.com
>
上级
6bb03c36
变更
4
显示空白变更内容
内联
并排
Showing
4 changed file
with
60 addition
and
61 deletion
+60
-61
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-xcomponent.md
...-dev/reference/arkui-ts/ts-basic-components-xcomponent.md
+13
-14
zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
...ation-dev/reference/arkui-ts/ts-media-components-video.md
+31
-31
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-file.md
.../reference/js-service-widget-ui/js-service-widget-file.md
+2
-2
zh-cn/application-dev/ui/arkui-overview.md
zh-cn/application-dev/ui/arkui-overview.md
+14
-14
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-xcomponent.md
浏览文件 @
dfeeecfb
...
@@ -7,10 +7,9 @@
...
@@ -7,10 +7,9 @@
> 该组件从API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 该组件从API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
## 子组件
构造参数type为"surface"时不支持。
\
构造参数type为"surface"时不支持。
从API version 9开始,构造参数type为"component"时可以包含子组件。
从API version 9开始,构造参数type为"component"时可以包含子组件。
## 接口
## 接口
...
@@ -20,7 +19,7 @@
...
@@ -20,7 +19,7 @@
**参数:**
**参数:**
| 参数名 | 参数类型 | 必填 | 描述 |
| 参数名 | 参数类型 | 必填 | 描述 |
| ---------
| ------ | ---- |
----- |
| ---------
-- | ---------------------------------------- | ---- | -----------------------------------
----- |
| id | string | 是 | 组件的唯一标识,支持最大的字符串长度128。 |
| id | string | 是 | 组件的唯一标识,支持最大的字符串长度128。 |
| type | string | 是 | 用于指定XComponent组件类型,可选值为:
<br/>
-"surface":用于EGL/OpenGLES和媒体数据写入,组件内容单独送显,直接合成到屏幕。
<br/>
-"component"
<sup>
9+
</sup>
:XComponent将变成一个容器组件,并可在其中执行非UI逻辑以动态加载显示内容。 |
| type | string | 是 | 用于指定XComponent组件类型,可选值为:
<br/>
-"surface":用于EGL/OpenGLES和媒体数据写入,组件内容单独送显,直接合成到屏幕。
<br/>
-"component"
<sup>
9+
</sup>
:XComponent将变成一个容器组件,并可在其中执行非UI逻辑以动态加载显示内容。 |
| libraryname | string | 否 | 应用Native层编译输出动态库名称,仅XComponent类型为"surface"时有效。 |
| libraryname | string | 否 | 应用Native层编译输出动态库名称,仅XComponent类型为"surface"时有效。 |
...
@@ -46,7 +45,7 @@
...
@@ -46,7 +45,7 @@
## 事件
## 事件
仅type为"surface"时以下事件有效。不支持
[
通用事件和手势
](
./Readme-CN
.md
)
。
仅type为"surface"时以下事件有效。不支持
不支持
[
通用事件
](
ts-universal-events-click.md
)
和
[
手势
](
ts-gesture-settings
.md
)
。
### onLoad
### onLoad
...
@@ -57,7 +56,7 @@ onLoad(callback: (event?: object) => void )
...
@@ -57,7 +56,7 @@ onLoad(callback: (event?: object) => void )
**参数:**
**参数:**
| 参数名 | 参数类型 | 必填 | 描述 |
| 参数名 | 参数类型 | 必填 | 描述 |
| -----
-------- | ------ | ---- |
----------------------- |
| -----
| ------ | ---- | -----------------
----------------------- |
| event | object | 否 | 获取XComponent实例对象的context,context上挂载的方法由开发者在c++层定义。 |
| event | object | 否 | 获取XComponent实例对象的context,context上挂载的方法由开发者在c++层定义。 |
### onDestroy
### onDestroy
...
...
zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
浏览文件 @
dfeeecfb
...
@@ -23,8 +23,8 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
...
@@ -23,8 +23,8 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
**参数:**
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------------------- | ----------------------------------------
-------------------- | ---- | --------------------
---------------------------------------- |
| ------------------- | ----------------------------------------
| ---- |
---------------------------------------- |
| src | string
\|
[
Resource
](
ts-types.md
)
| 否 | 视频播放源的路径,支持本地视频路径和网络路径。
<br>
支持在resources下面的video或rawfile文件夹里放置媒体资源。
<br>
支持dataability://的路径前缀,用于访问通过Data Ability提供的视频路径,具体路径信息详见
[
DataAbility说明
](
../../ability/fa-dataability
.md
)
。
<br/>
**说明:**
<br/>
视频支持的格式是:mp4、mkv、webm、TS。 |
| src | string
\|
[
Resource
](
ts-types.md
)
| 否 | 视频播放源的路径,支持本地视频路径和网络路径。
<br>
支持在resources下面的video或rawfile文件夹里放置媒体资源。
<br>
支持dataability://的路径前缀,用于访问通过Data Ability提供的视频路径,具体路径信息详见
[
DataAbility说明
](
../../application-models/dataability-overview
.md
)
。
<br/>
**说明:**
<br/>
视频支持的格式是:mp4、mkv、webm、TS。 |
| currentProgressRate | number
\|
string
\|
PlaybackSpeed
<sup>
8+
</sup>
| 否 | 视频播放倍速。
<br/>
**说明:**
<br/>
number取值仅支持:0.75,1.0,1.25,1.75,2.0。
<br/>
默认值:1.0
\|
PlaybackSpeed.Speed_Forward_1_00_X |
| currentProgressRate | number
\|
string
\|
PlaybackSpeed
<sup>
8+
</sup>
| 否 | 视频播放倍速。
<br/>
**说明:**
<br/>
number取值仅支持:0.75,1.0,1.25,1.75,2.0。
<br/>
默认值:1.0
\|
PlaybackSpeed.Speed_Forward_1_00_X |
| previewUri | string
\|
PixelMap
<sup>
8+
</sup>
\|
[
Resource
](
ts-types.md
)
| 否 | 视频未播放时的预览图片路径。 |
| previewUri | string
\|
PixelMap
<sup>
8+
</sup>
\|
[
Resource
](
ts-types.md
)
| 否 | 视频未播放时的预览图片路径。 |
| controller |
[
VideoController
](
#videocontroller
)
| 否 | 设置视频控制器。 |
| controller |
[
VideoController
](
#videocontroller
)
| 否 | 设置视频控制器。 |
...
@@ -44,7 +44,7 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
...
@@ -44,7 +44,7 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
| 名称 | 参数类型 | 描述 |
| 名称 | 参数类型 | 描述 |
| --------- | ---------------------------------------- | ----------------------------
-------------------
|
| --------- | ---------------------------------------- | ---------------------------- |
| muted | boolean | 是否静音。
<br/>
默认值:false |
| muted | boolean | 是否静音。
<br/>
默认值:false |
| autoPlay | boolean | 是否自动播放。
<br/>
默认值:false |
| autoPlay | boolean | 是否自动播放。
<br/>
默认值:false |
| controls | boolean | 控制视频播放的控制栏是否显示。
<br/>
默认值:true |
| controls | boolean | 控制视频播放的控制栏是否显示。
<br/>
默认值:true |
...
@@ -56,7 +56,7 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
...
@@ -56,7 +56,7 @@ Video(value: {src?: string | Resource, currentProgressRate?: number | string | P
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还支持以下事件:
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还支持以下事件:
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| ----------------------------------------
-------------------- | --------------------
---------------------------------------- |
| ----------------------------------------
|
---------------------------------------- |
| onStart(event:()
=
>
void) | 播放时触发该事件。 |
| onStart(event:()
=
>
void) | 播放时触发该事件。 |
| onPause(event:()
=
>
void) | 暂停时触发该事件。 |
| onPause(event:()
=
>
void) | 暂停时触发该事件。 |
| onFinish(event:()
=
>
void) | 播放结束时触发该事件。 |
| onFinish(event:()
=
>
void) | 播放结束时触发该事件。 |
...
@@ -107,7 +107,7 @@ setCurrentTime(value: number)
...
@@ -107,7 +107,7 @@ setCurrentTime(value: number)
**参数:**
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -----
- | -------- | ---- | -------------
-------------- |
| -----
| ------ | ---- |
-------------- |
| value | number | 是 | 视频播放进度位置,单位为s。 |
| value | number | 是 | 视频播放进度位置,单位为s。 |
### requestFullscreen
### requestFullscreen
...
@@ -119,7 +119,7 @@ requestFullscreen(value: boolean)
...
@@ -119,7 +119,7 @@ requestFullscreen(value: boolean)
**参数:**
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ----- | ------
| ---- |
------- |
| ----- | ------
- | ---- | --------------
------- |
| value | boolean | 是 | 是否全屏播放。
<br/>
默认值:false |
| value | boolean | 是 | 是否全屏播放。
<br/>
默认值:false |
### exitFullscreen
### exitFullscreen
...
@@ -137,7 +137,7 @@ setCurrentTime(value: number, seekMode: SeekMode)
...
@@ -137,7 +137,7 @@ setCurrentTime(value: number, seekMode: SeekMode)
**参数:**
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | ---- | --------------
----
|
| -------- | -------- | ---- | -------------- |
| value | number | 是 | 视频播放进度位置,单位为s。 |
| value | number | 是 | 视频播放进度位置,单位为s。 |
| seekMode | SeekMode | 是 | 跳转模式。 |
| seekMode | SeekMode | 是 | 跳转模式。 |
...
...
zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-file.md
浏览文件 @
dfeeecfb
...
@@ -58,6 +58,6 @@ JS服务卡片(entry/src/main/js/Widget)的典型开发目录结构如下:
...
@@ -58,6 +58,6 @@ JS服务卡片(entry/src/main/js/Widget)的典型开发目录结构如下:
## 配置文件
## 配置文件
FA卡片需要在应用配置文件config.json中进行配置。详细的配置内容请参考
[
FA卡片配置文件说明
](
../../a
bility/fa-formability
.md#配置卡片配置文件
)
。
FA卡片需要在应用配置文件config.json中进行配置。详细的配置内容请参考
[
FA卡片配置文件说明
](
../../a
pplication-models/widget-development-fa
.md#配置卡片配置文件
)
。
Stage卡片需要在应用配置文件module.json5中的extensionAbilities标签下,配置ExtensionAbility相关信息。详细的配置内容请参考
[
Stage卡片配置文件说明
](
../../ability/stage-formextension.md#配置卡片配置文件
)
。
Stage卡片需要在应用配置文件module.json5中的extensionAbilities标签下,配置ExtensionAbility相关信息。详细的配置内容请参考
[
Stage卡片配置文件说明
](
../../application-models/widget-development-stage.md#配置卡片配置文件
)
。
\ No newline at end of file
\ No newline at end of file
zh-cn/application-dev/ui/arkui-overview.md
浏览文件 @
dfeeecfb
...
@@ -37,24 +37,24 @@
...
@@ -37,24 +37,24 @@
## UI与Ability框架的关系
## UI与Ability框架的关系
Ability也是OpenHarmony应用的重要组成部分,
[
Ability框架
](
../ability/ability-brief.md
)
包括FA模型与Stage模型两种模型。下表给出了Ability框架的
两种模型分别与方舟开发框架的两种开发范式的关系。
OpenHarmony提供了FA模型与Stage模型两种
[
应用模型
](
../application-models/application-model-description.md
)
。下表给出了
两种模型分别与方舟开发框架的两种开发范式的关系。
**FA模型:**
**FA模型:**
| 类型 | UI开发范式 | 说明
|
| 类型 | UI开发范式 | 说明
|
| -------- | --------------------------- |
--------------------------- |
| ---- | -------- | -------------
--------------------------- |
| 应用
| 类web开发范式 | UI开发语言:使用hml/css/js
<br>
业务入口:使用固定文件名app.ets(Page类型Ability)/service.ts(Service类型Ability)/data.ts(Data类型Ability)
<br>
业务逻辑语言:js/ts |
| 应用
| 类web开发范式 | UI开发语言:使用hml/css/js
<br>
业务入口:使用固定文件名app.ets(Page类型Ability)/service.ts(Service类型Ability)/data.ts(Data类型Ability)
<br>
业务逻辑语言:js/ts |
| | 声明式开发范式
| UI开发语言:ArkTS
<br>
业务入口:使用固定文件名app.ets(Page类型Ability)/service.ts(Service类型Ability)/data.ts(Data类型Ability)
<br>
业务逻辑语言:js/ts |
| | 声明式开发范式
| UI开发语言:ArkTS
<br>
业务入口:使用固定文件名app.ets(Page类型Ability)/service.ts(Service类型Ability)/data.ts(Data类型Ability)
<br>
业务逻辑语言:js/ts |
| 服务卡片 | 类web开发范式 | UI开发语言:卡片显示使用hml+css+json(action)
<br>
业务入口:form.ts
<br>
卡片业务逻辑语言:js/ts |
| 服务卡片 | 类web开发范式 | UI开发语言:卡片显示使用hml+css+json(action)
<br>
业务入口:form.ts
<br>
卡片业务逻辑语言:js/ts |
| | 声明式开发范式 | 当前不支持
|
| | 声明式开发范式 | 当前不支持
|
**Stage模型:**
**Stage模型:**
| 类型 | UI开发范式 | 说明
|
| 类型 | UI开发范式 | 说明
|
| -------- | --------------------------- |
--------------------------- |
| ---- | -------- | -------------
--------------------------- |
| 应用 | 类web开发范式 | 当前不支持
|
| 应用 | 类web开发范式 | 当前不支持
|
| | 声明式开发范式
| UI开发语言:ArkTS
<br>
业务入口:应用模型基于ohos.application.Ability/ExtensionAbility等派生
<br>
业务逻辑语言:ts |
| | 声明式开发范式
| UI开发语言:ArkTS
<br>
业务入口:应用模型基于ohos.application.Ability/ExtensionAbility等派生
<br>
业务逻辑语言:ts |
| 服务卡片 | 类web开发范式 | UI开发语言:卡片显示使用hml+css+json(action)
<br>
业务入口:从FormExtensionAbility派生
<br>
业务逻辑语言:ts |
| 服务卡片 | 类web开发范式 | UI开发语言:卡片显示使用hml+css+json(action)
<br>
业务入口:从FormExtensionAbility派生
<br>
业务逻辑语言:ts |
| | 声明式开发范式 | 当前不支持
|
| | 声明式开发范式 | 当前不支持
|
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录