Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
10da6fb1
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看板
提交
10da6fb1
编写于
9月 05, 2022
作者:
T
tianyu
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
second
Signed-off-by:
N
tianyu
<
tianyu55@h-partners.com
>
上级
e73dc8a0
变更
15
隐藏空白更改
内联
并排
Showing
15 changed file
with
132 addition
and
185 deletion
+132
-185
zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219982725.jpg
...ference/arkui-ts/figures/zh-cn_image_0000001219982725.jpg
+0
-0
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-line.md
...tion-dev/reference/arkui-ts/ts-drawing-components-line.md
+6
-5
zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
...on-dev/reference/arkui-ts/ts-page-transition-animation.md
+29
-39
zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
...v/reference/arkui-ts/ts-transition-animation-component.md
+15
-13
zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md
...rence/arkui-ts/ts-transition-animation-shared-elements.md
+6
-12
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
.../reference/arkui-ts/ts-universal-attributes-background.md
+9
-13
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-click.md
...n-dev/reference/arkui-ts/ts-universal-attributes-click.md
+6
-10
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md
...reference/arkui-ts/ts-universal-attributes-flex-layout.md
+8
-13
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md
...ev/reference/arkui-ts/ts-universal-attributes-location.md
+10
-13
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
...on-dev/reference/arkui-ts/ts-universal-attributes-size.md
+11
-15
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
...ation-dev/reference/arkui-ts/ts-universal-events-click.md
+3
-7
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md
...n-dev/reference/arkui-ts/ts-universal-events-show-hide.md
+5
-9
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
...ation-dev/reference/arkui-ts/ts-universal-events-touch.md
+17
-20
zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md
...cation-dev/reference/arkui-ts/ts-universal-focus-event.md
+2
-7
zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
...lication-dev/reference/arkui-ts/ts-universal-mouse-key.md
+5
-9
未找到文件。
zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219982725.jpg
查看替换文件 @
e73dc8a0
浏览文件 @
10da6fb1
23.7 KB
|
W:
|
H:
6.7 KB
|
W:
|
H:
2-up
Swipe
Onion skin
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-line.md
浏览文件 @
10da6fb1
...
...
@@ -27,15 +27,15 @@ Line(options?: {width: Length, height: Length})
| options | Object | 否 | - | 见options参数说明。 |
-
options参数说明
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| width | Length | 是 | - | 宽度。 |
| height | Length | 是 | - | 高度。 |
| width | Length | 是 | - | 宽度。 |
| height | Length | 是 | - | 高度。 |
## 属性
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| width |
[
Length
](
../../ui/ts-types.md#length
)
| 0 | 否 | 直线所在矩形的宽度。 |
| height |
[
Length
](
../../ui/ts-types.md#length
)
| 0 | 否 | 直线所在矩形的高度。 |
...
...
@@ -52,7 +52,8 @@ Line(options?: {width: Length, height: Length})
struct
LineExample
{
build
()
{
Column
()
{
Line
({
width
:
50
,
height
:
100
}).
startPoint
([
0
,
0
]).
endPoint
([
50
,
100
])
Line
().
startPoint
([
0
,
0
]).
endPoint
([
50
,
100
])
Line
({
width
:
50
,
height
:
50
}).
startPoint
([
0
,
0
]).
endPoint
([
100
,
100
])
Line
().
width
(
200
).
height
(
200
).
startPoint
([
50
,
50
]).
endPoint
([
150
,
150
])
}.
margin
({
top
:
5
})
}
...
...
zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
浏览文件 @
10da6fb1
# 页面间转场
页面转场通过在全局pageTransition方法内配置页面入场组件和页面退场组件来自定义页面
转场动效。
在全局pageTransition方法内配置页面入场和页面退场时的自定义
转场动效。
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
| 名称
| 参数 | 参数描述
|
| ------------------- | ------
|
------------------------------- |
| PageTransitionEnter |
Object | 页面入场组件,用于自定义当前页面的入场效果,详见动效参数说明
。 |
| PageTransitionExit |
Object | 页面退场组件,用于自定义当前页面的退场效果,详见动效参数说明
。 |
| 名称
| 参数 | 参数描述
|
| ------------------- | ------
------------------------------------------------------ | -----------------------------
------------------------------- |
| PageTransitionEnter |
{
<br/>
type: RouteType,
<br/>
duration: number,
<br/>
curve: Curve
\|
Curves,
<br>
delay: number
<br/>
} | 设置当前页面的自定义入场动效。
<br/>
-
type:不配置时表明pop为push时效果的逆播。
<br/>
-
duration:动画的时长,单位为毫秒。
<br/>
-
curve:动画曲线,有效值参见[Curve](ts-animatorproperty.md)
。
<br/>
默认值:Curve.Linear
<br/>
-
delay:动画延迟时长,单位为毫秒,默认不延迟播放
。 |
| PageTransitionExit |
{
<br/>
type: RouteType,
<br/>
duration: number,
<br/>
curve: Curve
\|
Curves,
<br/>
delay: number
<br/>
} | 设置当前页面的自定义退场动效。
<br/>
-
type:不配置时表明pop为push时效果的逆播
<br/>
-
duration:动画的时长,单位为毫秒。
<br/>
-
curve:动画曲线,有效值参见[Curve](ts-animatorproperty.md)
。
<br/>
默认值:Curve.Linear
<br/>
-
delay:动画延迟时长,单位为毫秒,默认不延迟播放
。 |
## RouteType枚举说明
-
动效参数说明
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | ------------------------- | ------ | ---- | ---------------------------------------- |
| type | RouteType | - | 否 | 不配置时表明pop为push时效果的逆播。 |
| duration | number | 1000 | 否 | 动画时长,单位为毫秒。 |
| curve | Curve
\|
Curves | Linear | 否 | 动画曲线,有效值参见
[
Curve
](
ts-animatorproperty.md
)
说明。 |
| delay | number | 0 | 否 | 动画延迟时长,单位为毫秒,默认不延时播放。 |
-
RouteType枚举说明
| 名称 | 描述 |
| ---- | ---------------- |
| Pop | 重定向指定页面。PageA跳转到PageB时,PageA为Exit+Push,PageB为Enter+Push。 |
| Push | 跳转到下一页面。PageB返回至PageA时,PageA为Enter+Pop,PageB为Exit+Pop。 |
| 名称 | 描述 |
| ---- | ------------------------------------------------------------ |
| Pop | 重定向指定页面。PageA跳转到PageB时,PageA为Exit+Push,PageB为Enter+Push。 |
| Push | 跳转到下一页面。PageB返回至PageA时,PageA为Enter+Pop,PageB为Exit+Pop。 |
| None | 页面未重定向。 |
## 属性
PageTransitionEnter和PageTransitionExit组件支持的属性:
| 参数名称 | 参数类型 | 必填 | 参数描述 |
| --------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| slide | SlideEffect | 否 | 设置页面转场时的滑入滑出效果。
<br/>
默认值:SlideEffect.Right |
| translate | {
<br/>
x?
:
number
\|
string,
<br/>
y?
:
number
\|
string,
<br/>
z?
:
number
\|
string
<br/>
} | 否 | 设置页面转场时的平移效果,为入场时起点和退场时终点的值,和slide同时设置时默认生效slide。
<br/>
-
x:横向的平移距离。
<br/>
-
y:纵向的平移距离。
<br/>
-
z:竖向的平移距离。 |
| scale | {
<br/>
x?
:
number,
<br/>
y?
:
number,
<br/>
z?
:
number,
<br/>
centerX?
:
number
\|
string,
<br/>
centerY?
:
number
\|
string
<br/>
} | 否 | 设置页面转场时的缩放效果,为入场时起点和退场时终点的值。
<br/>
-
x:横向放大倍数(或缩小比例)。
<br/>
-
y:纵向放大倍数(或缩小比例)。
<br/>
-
z:竖向放大倍数(或缩小比例)。
<br/>
-
centerX、centerY缩放中心点。
<br/>
-
中心点为0时,默认的是组件的左上角。
<br/>
|
| opacity | number | 否 | 设置入场的起点透明度值或者退场的终点透明度值。
<br/>
默认值:1 |
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| --------- | ---------------------------------------- | ----------------- | ---- | ---------------------------------------- |
| slide | SlideEffect | SlideEffect.Right | 否 | 设置转场的滑入效果,有效值参见SlideEffect枚举说明。 |
| translate | {
<br/>
x?
:
number
\|
string,
<br/>
y?
:
number
\|
string,
<br/>
z?
:
number
\|
string
<br/>
} | - | 否 | 设置页面转场时的平移效果,为入场时起点和退场时终点的值,和slide同时设置时默认生效slide。 |
| scale | {
<br/>
x?
:
number,
<br/>
y?
:
number,
<br/>
z?
:
number,
<br/>
centerX?
:
number
\|
string,
<br/>
centerY?
:
number
\|
string
<br/>
} | - | 否 | 设置页面转场时的缩放效果,为入场时起点和退场时终点的值。 |
| opacity | number | 1 | 否 | 设置入场的起点透明度值或者退场的终点透明度值。 |
## SlideEffect枚举说明
-
SlideEffect枚举说明
| 名称 | 描述 |
| ------ | ------------------------- |
| Left | 设置到入场时表示从左边滑入,出场时表示滑出到左边。 |
| Right | 设置到入场时表示从右边滑入,出场时表示滑出到右边。 |
| Top | 设置到入场时表示从上边滑入,出场时表示滑出到上边。 |
| Bottom | 设置到入场时表示从下边滑入,出场时表示滑出到下边。 |
| 名称 | 描述 |
| ------ | ------------------------- |
| Left | 设置到入场时表示从左边滑入,出场时表示滑出到左边。 |
| Right | 设置到入场时表示从右边滑入,出场时表示滑出到右边。 |
| Top | 设置到入场时表示从上边滑入,出场时表示滑出到上边。 |
| Bottom | 设置到入场时表示从下边滑入,出场时表示滑出到下边。 |
## 事件
PageTransitionEnter和PageTransitionExit组件支持的事件:
| 事件 | 功能描述 |
| ---------------------------------------- | ----------------------------------- |
| onEnter(type:
RouteType,
progress:
number)
=
>
void | 回调入参为当前入场动画的归一化进度[0
-
1]。 |
| onExit(type:
RouteType,
progress:
number)
=
>
void | 回调入参为当前退场动画的归一化进度[0
-
1]。 |
| 事件 | 功能描述 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| onEnter(event: (type:
RouteType,
progress:
number)
=
>
void) | 回调入参为当前入场动画的归一化进度[0
-
1]。
<br/>
-
type:跳转方法。
<br/>
-
progress:当前进度。 |
| onExit(event: (type:
RouteType,
progress:
number)
=
>
void) | 回调入参为当前退场动画的归一化进度[0
-
1]。
<br/>
-
type:跳转方法。
<br/>
-
progress:当前进度。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
浏览文件 @
10da6fb1
# 组件内转场
组件
转场主要通过transition属性进行配置转场参数,在组件插入和删除时进行过渡动效,主要用于容器组件子组件插入删除时提升用户体验(需要配合animateTo才能生效,动效时长、曲线、延时跟随animateTo中的配置)。
组件
内转场主要通过transition属性配置转场参数,在组件插入和删除时显示过渡动效,主要用于容器组件中的子组件插入和删除时,提升用户体验(需要配合
[
animateTo
](
ts-explicit-animation.md
)
才能生效,动效时长、曲线、延时跟随animateTo中的配置)。
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数类型 | 默认值 | 参数描述 |
| 名称 | 参数类型 | 参数描述 |
| -------- | -------- | -------- |
| transition | TransitionOptions | 所有参数均为可选参数,详细描述见TransitionOptions参数说明。 |
## TransitionOptions参数说明
| 参数名称 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| transition | Object | - | 所有参数均为可选参数,详细描述见transition入参说明。 |
-
transition入参说明
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| type |
[
TransitionType
](
ts-appendix-enums.md#transitiontype
)
| TransitionType.All | 否 | 默认包括组件新增和删除。
<br/>
>
**说明:**
<br/>
>
不指定Type时说明插入删除使用同一种效果。 |
| opacity | number | 1 | 否 | 设置组件转场时的透明度效果,为插入时起点和删除时终点的值。 |
| translate | {
<br/>
x?
:
number,
<br/>
y?
:
number,
<br/>
z?
:
number
<br/>
} | - | 否 | 设置组件转场时的平移效果,为插入时起点和删除时终点的值。
<br/>
-x:横向的平移距离。
<br/>
-y:纵向的平移距离。
<br/>
-z:竖向的平移距离。 |
| scale | {
<br/>
x?
:
number,
<br/>
y?
:
number,
<br/>
z?
:
number,
<br/>
centerX?
:
number,
<br/>
centerY?
:
number
<br/>
} | - | 否 | 设置组件转场时的缩放效果,为插入时起点和删除时终点的值。
<br/>
-x:横向放大倍数(或缩小比例)。
<br/>
-y:纵向放大倍数(或缩小比例)。
<br/>
-z:竖向放大倍数(或缩小比例)。
<br/>
-
centerX、centerY缩放中心点。
<br/>
-
中心点为0时,默认的是组件的左上角。
<br/>
|
| rotate | {
<br/>
x?:
number,
<br/>
y?:
number,
<br/>
z?:
number,
<br/>
angle?:
Angle,
<br/>
centerX?:
Length,
<br/>
centerY?:
Length
<br/>
} | - | 否 | 设置组件转场时的旋转效果,为插入时起点和删除时终点的值。
<br/>
-x:横向的旋转向量。
<br/>
-y:纵向的旋转向量。
<br/>
-z:竖向的旋转向量。
<br/>
-
centerX,centerY指旋转中心点。
<br/>
-
中心点为(0,0)时,默认的是组件的左上角。 |
| type |
[
TransitionType
](
ts-appendix-enums.md#transitiontype
)
| 否 | 默认包括组件新增和删除。
<br/>
默认值:TransitionType.All
<br/>
**说明:**
<br/>
不指定Type时说明插入删除使用同一种效果。 |
| opacity | number | 否 | 设置组件转场时的透明度效果,为插入时起点和删除时终点的值。
<br/>
默认值:1 |
| translate | {
<br/>
x?
:
number,
<br/>
y?
:
number,
<br/>
z?
:
number
<br/>
} | 否 | 设置组件转场时的平移效果,为插入时起点和删除时终点的值。
<br/>
-x:横向的平移距离。
<br/>
-y:纵向的平移距离。
<br/>
-z:竖向的平移距离。 |
| scale | {
<br/>
x?
:
number,
<br/>
y?
:
number,
<br/>
z?
:
number,
<br/>
centerX?
:
number,
<br/>
centerY?
:
number
<br/>
} | 否 | 设置组件转场时的缩放效果,为插入时起点和删除时终点的值。
<br/>
-x:横向放大倍数(或缩小比例)。
<br/>
-y:纵向放大倍数(或缩小比例)。
<br/>
-z:竖向放大倍数(或缩小比例)。
<br/>
-
centerX、centerY缩放中心点。
<br/>
-
中心点为0时,默认的是组件的左上角。
<br/>
|
| rotate | {
<br/>
x?:
number,
<br/>
y?:
number,
<br/>
z?:
number,
<br/>
angle?:
Angle,
<br/>
centerX?:
Length,
<br/>
centerY?:
Length
<br/>
} | 否 | 设置组件转场时的旋转效果,为插入时起点和删除时终点的值。
<br/>
-x:横向的旋转向量。
<br/>
-y:纵向的旋转向量。
<br/>
-z:竖向的旋转向量。
<br/>
-
centerX,centerY指旋转中心点。
<br/>
-
中心点为(0,0)时,默认的是组件的左上角。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md
浏览文件 @
10da6fb1
# 共享元素转场
共享元素转场支持页面间的转场,如当前页面的图片转场至下一页面中。
设置页面间转场时共享元素的转场动效。
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数 | 默认值 | 参数描述 |
| ---------------- | ---------------------------------------- | ---- | ---------------------------------------- |
| sharedTransition | id:
string,
<br/>
options?:
Object | - | 两个页面的组件配置为同一个id,则转场过程中会进行共享元素转场,配置为空字符串时不会有共享元素转场效果。 |
-
options参数说明
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | ------------------------- | ------ | ---- | --------------------- |
| duration | number | 1000 | 否 | 单位为毫秒,默认动画时长为1000毫秒。 |
| curve | Curve
\|
Curves | Linear | 否 | 默认曲线为线性,有效值参见Curve说明。 |
| delay | number | 0 | 否 | 单位为毫秒,默认不延时播放。 |
| 名称 | 参数 | 参数描述 |
| ---------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| sharedTransition | id:
string,
<br/>
{
<br/>
duration?: number,
<br/>
curve?: Curve
\|
string,
<br/>
delay?: number,
<br/>
motionPath?:
<br/>
{
<br/>
path: string,
<br/>
form?: number,
<br/>
to?: number,
<br/>
rotatable?: boolean
<br/>
},
<br/>
zIndex?: number,
<br/>
type?:
[
SharedTransitionEffectType
](
ts-appendix-enums.md#sharedtransitioneffecttype
)
<br/>
} | 两个页面中id值相同且不为空字符串的组件即为共享元素,在页面转场时可显示共享元素转场动效。
<br/>
-
id:设置组件的id。
<br/>
-
duration:单位为毫秒,默认动画时长为1000毫秒。
<br/>
-
curve:默认曲线为Linear,有效值参见[Curve](ts-animatorproperty.md)
说明。
<br/>
-
delay:单位为毫秒,默认不延时播放。
<br/>
-
motionPath:运动路径信息。
<br/>
-
path:设置路径。
<br/>
-
from:设置起始值。
<br/>
-
to:设置终止值。
<br/>
-
rotatable:是否旋转。
<br/>
-
zIndex:设置Z轴。
<br/>
-
type:动画类型。 |
## 示例
示例功能为两个页面,共享元素转场页面图片点击后转场至页面B的图片。
示例代码为点击图片跳转页面时,显示共享元素图片的自定义转场动效。
```
ts
// xxx.ets
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
浏览文件 @
10da6fb1
# 背景设置
设置组件的背景
色
。
设置组件的背景
样式
。
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| -------- | -------- | -------- |
-------- |
| backgroundColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- |
设置组件的背景色。 |
| backgroundImage |
src:
[ResourceStr](../../ui/ts-types.md),
<br/>
repeat?:
[
ImageRepeat
](
ts-appendix-enums.md#imagerepeat
)
| - | src参数:图片地址,支持网络图片资源和本地图片资源地址(不支持svg类型的图片)。
<br/>
repeat参数
:设置背景图片的重复样式,默认不重复。 |
| backgroundImageSize | {
<br/>
width?:
Length,
<br/>
height?:
Length
<br/>
}
\|
[
ImageSize
](
ts-appendix-enums.md#imagesize
)
| Auto | 设置背景图像的高度和宽度。当输入为{width:
Length,
height:
Length}对象时,如果只设置一个属性,则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。
|
| backgroundImagePosition | {
<br/>
x?:
Length,
<br/>
y?:
Length
<br/>
}
\|
[
Alignment
](
ts-appendix-enums.md#alignment
)
| {
<br/>
x:
0,
<br/>
y:
0
<br/>
} | 设置背景图在组件中显示位置。
|
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| backgroundColor |
[
ResourceColor
](
../../ui/ts-types.md
)
| 设置组件的背景色。 |
| backgroundImage |
-
src:
[ResourceStr](../../ui/ts-types.md),
<br/>
-
repeat?:
[
ImageRepeat
](
ts-appendix-enums.md#imagerepeat
)
| src:图片地址,支持网络图片资源和本地图片资源地址(不支持svg类型的图片)。
<br/>
repeat
:设置背景图片的重复样式,默认不重复。 |
| backgroundImageSize | {
<br/>
width?:
[Length](../../ui/ts-types.md#length),
<br/>
height?:
[Length](../../ui/ts-types.md#length)
<br/>
}
\|
[
ImageSize
](
ts-appendix-enums.md#imagesize
)
| 设置背景图像的高度和宽度。当输入为{width:
Length,
height:
Length}对象时,如果只设置一个属性,则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。
<br/>
默认值:ImageSize.Auto
|
| backgroundImagePosition | {
<br/>
x?:
[Length](../../ui/ts-types.md#length),
<br/>
y?:
[Length](../../ui/ts-types.md#length)
<br/>
}
\|
[
Alignment
](
ts-appendix-enums.md#alignment
)
| 设置背景图在组件中显示位置。
<br/>
默认值:
<br/>
{
<br/>
x:
0,
<br/>
y:
0
<br/>
}
|
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-click.md
浏览文件 @
10da6fb1
# 点击控制
设置组件是否可
触摸
。
设置组件是否可
响应点击事件
。
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
|
**名称**
|
**参数类型**
|
**默认值**
|
**描述**
|
| --------- | --------
| ------- |
-------------- |
| touchable | boolean
| true | 设置当前组件是否可以被触摸。
|
|
**名称**
|
**参数类型**
|
**描述**
|
| --------- | --------
---- | -------------------------------
-------------- |
| touchable | boolean
| 设置组件是否可响应点击事件。
<br/>
默认值:true
|
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md
浏览文件 @
10da6fb1
...
...
@@ -3,23 +3,18 @@
> **说明:**
> - 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> - 仅当父组件是Flex组件时生效。
## 权限列表
无
> - 仅当父组件是 Flex、Column、Row 时生效。
## 属性
| 名称 | 参数说明 |
默认值 |
描述 |
| -------- | -------- | -------- |
-------- |
| flexBasis |
'auto'
\|
Length | 'auto' | 此属性所在的组件在Flex容器中主轴方向上基准尺寸。
|
| flexGrow | number |
0 | Flex容器的剩余空间分配给此属性所在组件的比例。
|
| flexShrink | number |
1 | Flex容器压缩尺寸分配给此属性所在组件的比例。
|
| alignSelf |
[
ItemAlign
](
ts-appendix-enums.md#itemalign
枚举说明
)
| Auto | 覆盖Flex布局容器中alignItems默认配置。
|
| 名称 | 参数说明 | 描述 |
| -------- | -------- | -------- |
| flexBasis |
number
\|
string | 设置组件在父容器主轴方向上的基准尺寸。
<br/>
默认值:'auto'(表示组件在主轴方向上的基准尺寸为组件原本的大小)
|
| flexGrow | number |
设置父容器的剩余空间分配给此属性所在组件的比例。
<br/>
默认值:0
|
| flexShrink | number |
设置父容器压缩尺寸分配给此属性所在组件的比例。
<br/>
默认值:1
|
| alignSelf |
[
ItemAlign
](
ts-appendix-enums.md#itemalign
)
| 子组件在父容器交叉轴的对齐格式,覆盖Flex布局容器中alignItems默认配置。
<br/>
默认值:ItemAlign.Auto
|
## 示例
...
...
@@ -34,7 +29,7 @@ struct FlexExample {
Column
({
space
:
5
})
{
Text
(
'
flexBasis
'
).
fontSize
(
9
).
fontColor
(
0xCCCCCC
).
width
(
'
90%
'
)
// 基于主轴基准尺寸
// flexBasis()值可以是'auto'
(默认值)元素本来的大小 ,如果是数字则类似于.width()/.height() ,基于主轴
// flexBasis()值可以是'auto'
,表示基准尺寸是元素本来的大小 ,也可以是长度设置,相当于.width()/.height()
Flex
()
{
Text
(
'
flexBasis(100)
'
)
.
flexBasis
(
'
100
'
).
height
(
100
).
lineHeight
(
70
)
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md
浏览文件 @
10da6fb1
...
...
@@ -3,24 +3,21 @@
设置组件的对齐方式、布局方向和显示位置。
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
| -------- | -------- | -------- | -------- |
| align |
[
Alignment
](
ts-appendix-enums.md#alignment
)
| Center | 设置元素内容的对齐方式,只有当设置的width和height大小超过元素本身内容大小时生效。 |
| direction |
[
Direction
](
ts-appendix-enums.md#direction
)
| Auto | 设置元素水平方向的布局,可选值参照Direction枚举说明。 |
| position | {
<br/>
x:
Length,
<br/>
y:
Length
<br/>
} | - | 使用绝对定位,设置元素锚点相对于父容器顶部起点偏移位置。在布局容器中,设置该属性不影响父容器布局,仅在绘制时进行位置调整。 |
| markAnchor | {
<br/>
x:
Length,
<br/>
y:
Length
<br/>
} | {
<br/>
x:
0,
<br/>
y:
0
<br/>
} | 设置元素在位置定位时的锚点,以元素顶部起点作为基准点进行偏移。 |
| offset | {
<br/>
x:
Length,
<br/>
y:
Length
<br/>
} | {
<br/>
x:
0,
<br/>
y:
0
<br/>
} | 相对布局完成位置坐标偏移量,设置该属性,不影响父容器布局,仅在绘制时进行位置调整。 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| align |
[
Alignment
](
ts-appendix-enums.md#alignment
)
| 设置元素内容的对齐方式,只有当设置的width和height大小超过元素本身内容大小时生效。
<br/>
默认值:Alignment.Center |
| direction |
[
Direction
](
ts-appendix-enums.md#direction
)
| 设置元素水平方向的布局。
<br/>
默认值:Direction.Auto |
| position | {
<br/>
x:
[Length](../../ui/ts-types.md#length),
<br/>
y:
[
Length
](
../../ui/ts-types.md#length
)
<br/>
} | 使用绝对定位,设置元素锚点相对于父容器顶部起点偏移位置。在布局容器中,设置该属性不影响父容器布局,仅在绘制时进行位置调整。 |
| markAnchor | {
<br/>
x:
[Length](../../ui/ts-types.md#length),
<br/>
y:
[
Length
](
../../ui/ts-types.md#length
)
<br/>
} | 设置元素在位置定位时的锚点,以元素顶部起点作为基准点进行偏移。
<br/>
默认值:
<br/>
{
<br/>
x: 0,
<br/>
y: 1
<br/>
} |
| offset | {
<br/>
x:
[Length](../../ui/ts-types.md#length),
<br/>
y:
[
Length
](
../../ui/ts-types.md#length
)
<br/>
} | 相对布局完成位置坐标偏移量,设置该属性,不影响父容器布局,仅在绘制时进行位置调整。
<br/>
默认值:
<br/>
{
<br/>
x: 0,
<br/>
y: 1
<br/>
} |
| alignRules
<sup>
9+
</sup>
| {
<br/>
left?: { anchor: string, align:
[
HorizontalAlign
](
ts-appendix-enums.md#horizontalalign
)
};
<br/>
right?: { anchor: string, align:
[
HorizontalAlign
](
ts-appendix-enums.md#horizontalalign
)
};
<br/>
middle?: { anchor: string, align:
[
HorizontalAlign
](
ts-appendix-enums.md#horizontalalign
)
};
<br/>
top?: { anchor: string, align:
[
VerticalAlign
](
ts-appendix-enums.md#verticalalign
)
};
<br/>
bottom?: { anchor: string, align:
[
VerticalAlign
](
ts-appendix-enums.md#verticalalign
)
};
<br/>
center?: { anchor: string, align:
[
VerticalAlign
](
ts-appendix-enums.md#verticalalign
)
}
<br/>
} | 指定相对容器的对齐规则。
<br/>
-
left:设置左对齐参数。
<br/>
-
right:设置右对齐参数。
<br/>
-
middle:设置中间对齐的参数。
<br/>
-
top:设置顶部对齐的参数。
<br/>
-
bottom:设置底部对齐的参数。
<br/>
-
center:设置中心对齐的参数。
<br/>
**说明:**
<br/>
-
anchor:设置作为锚点的组件的id值。
<br>
-
align:设置相对于锚点组件的对齐方式。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
浏览文件 @
10da6fb1
...
...
@@ -3,26 +3,22 @@
用于设置组件的宽高、边距等显示尺寸进行设置。
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数说明 |
默认值 |
描述 |
| -------- | -------- | -------- |
-------- |
| width |
Length | -
| 设置组件自身的宽度,缺省时使用元素自身内容需要的宽度。 |
| height |
Length | -
| 设置组件自身的高度,缺省时使用元素自身内容需要的高度。 |
| size | {
<br/>
width?:
Length,
<br/>
height?:
Length
<br/>
} | - | 设置高宽尺寸。
|
| padding |
{
<br/>
top?:
Length,
<br/>
right?:
Length,
<br/>
bottom?:
Length,
<br/>
left?:
Length
<br/>
}
\|
Length | 0 | 设置内边距属性。
<br/>
参数为Length类型时,四个方向内边距同时生效。
|
| margin |
{
<br/>
top?:
Length,
<br/>
right?:
Length,
<br/>
bottom?:
Length,
<br/>
left?:
Length
<br/>
}
<br/>
\|
Length | 0 | 设置外边距属性。
<br/>
参数为Length类型时,四个方向外边距同时生效。
|
| constraintSize | {
<br/>
minWidth?:
Length,
<br/>
maxWidth?:
Length,
<br/>
minHeight?:
Length,
<br/>
maxHeight?:
Length
<br/>
} | {
<br/>
minWidth:
0,
<br/>
maxWidth:
Infinity,
<br/>
minHeight:
0,
<br/>
maxHeight:
Infinity
<br/>
} | 设置约束尺寸,组件布局时,进行尺寸范围限制。
|
| layoutWeight | number
\|
string |
0 | 容器尺寸确定时,元素与兄弟节点主轴布局尺寸按照权重进行分配,忽略本身尺寸设置,表示自适应占满剩余空间。
<br/>
>
**说明:**
<br/>
>
仅在Row/Column/Flex布局中生效。 |
| 名称 | 参数说明 | 描述 |
| -------- | -------- | -------- |
| width |
[
Length
](
../../ui/ts-types.md#length
)
| 设置组件自身的宽度,缺省时使用元素自身内容需要的宽度。 |
| height |
[
Length
](
../../ui/ts-types.md#length
)
| 设置组件自身的高度,缺省时使用元素自身内容需要的高度。 |
| size | {
<br/>
width?:
[Length](../../ui/ts-types.md#length),
<br/>
height?:
[
Length
](
../../ui/ts-types.md#length
)
<br/>
} | 设置高宽尺寸。
<br/>
-
width:设置组件的宽度
<br/>
-
height:设置组件的高度
|
| padding |
[
Padding
](
../../ui/ts-types.md#Padding
)
\|
[
Length
](
../../ui/ts-types.md#length
)
| 设置内边距属性。
<br/>
参数为
[
Length
](
../../ui/ts-types.md#length
)
类型时,四个方向内边距同时生效。
<br/>
默认值:0
|
| margin |
[
Margin
](
../../ui/ts-types.md#Margin
)
\|
[
Length
](
../../ui/ts-types.md#length
)
| 设置外边距属性。
<br/>
参数为
[
Length
](
../../ui/ts-types.md#length
)
类型时,四个方向外边距同时生效。
<br/>
默认值:0
|
| constraintSize | {
<br/>
minWidth?:
[Length](../../ui/ts-types.md#length),
<br/>
maxWidth?:
[Length](../../ui/ts-types.md#length),
<br/>
minHeight?:
[Length](../../ui/ts-types.md#length),
<br/>
maxHeight?:
[
Length
](
../../ui/ts-types.md#length
)
<br/>
} | 设置约束尺寸,组件布局时,进行尺寸范围限制。
<br/>
-
minWidth:设置组件的最小宽度
<br/>
-
maxWidth:设置组件的最大宽度
<br/>
-
minHeight:设置组件的最小高度
<br/>
-
maxHeight:设置组件的最大高度
<br/>
默认值:
<br/>
{
<br/>
minWidth:
0,
<br/>
maxWidth:
Infinity,
<br/>
minHeight:
0,
<br/>
maxHeight:
Infinity
<br/>
}
|
| layoutWeight | number
\|
string |
容器尺寸确定时,元素与兄弟节点主轴布局尺寸按照权重进行分配,忽略本身尺寸设置,表示自适应占满剩余空间。
<br/>
默认值:0
<br/>
**说明:**
<br/>
仅在Row/Column/Flex布局中生效。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
浏览文件 @
10da6fb1
...
...
@@ -6,16 +6,12 @@
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 事件
| 名称
| 支持冒泡 | 功能描述
|
| ----------------------------------------
| ---- |
--------------------------------- |
| onClick(
callback:
(event?:
ClickEvent)
=
>
void) | 否
| 点击动作触发该方法调用,event参数见ClickEvent介绍。 |
| 名称
| 支持冒泡 | 功能描述
|
| ----------------------------------------
-------------------- | -------- | ------------------
--------------------------------- |
| onClick(
event:
(event?:
ClickEvent)
=
>
void) | 否
| 点击动作触发该方法调用,event参数见ClickEvent介绍。 |
## ClickEvent对象说明
| 属性名称 | 类型 | 描述 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md
浏览文件 @
10da6fb1
...
...
@@ -3,20 +3,16 @@
挂载卸载事件指组件从组件树上挂载、卸载时触发的事件。
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 事件
| 名称
| 支持冒泡 | 功能描述
|
| ----------------------------------------
| ---- |
------------- |
| onAppear(
callback:
()
=
>
void) | 否
| 组件挂载显示时触发此回调。 |
| onDisappear(
callback:
()
=
>
void) | 否
| 组件卸载消失时触发此回调。 |
| 名称
| 支持冒泡 | 功能描述
|
| ----------------------------------------
-------- | -------- | -------------
------------- |
| onAppear(
event:
()
=
>
void) | 否
| 组件挂载显示时触发此回调。 |
| onDisappear(
event:
()
=
>
void) | 否
| 组件卸载消失时触发此回调。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
浏览文件 @
10da6fb1
...
...
@@ -3,37 +3,34 @@
当手指放在组件上、滑动或从组件上移开时触发。
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 事件
| 名称
| 是否冒泡 | 功能描述
|
| ----------------------------------------
| ---- |
---------------------------------------- |
| onTouch(
callback:
(event?:
TouchEvent)
=
>
void) | 是
| 触摸动作触发该方法调用,event参数见
[
TouchEvent
](
#touchevent对象说明
)
介绍。 |
| 名称
| 是否冒泡 | 功能描述
|
| ----------------------------------------
-------------------- | -------- | --------------------
---------------------------------------- |
| onTouch(
event:
(event?:
TouchEvent)
=
>
void) | 是
| 触摸动作触发该方法调用,event参数见
[
TouchEvent
](
#touchevent对象说明
)
介绍。 |
## TouchEvent对象说明
-
属性
| 属性名称 | 类型 | 描述 |
| ------------------- | ---------------------------------------- | ------------ |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| touches | Array
<
[TouchObject](#touchobject对象说明)
>
| 全部手指信息。 |
| changedTouches | Array
<
[TouchObject](#touchobject对象说明)
>
| 当前发生变化的手指信息。 |
| timestamp | number | 距离开机时间的时间戳,单位为毫秒。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md#eventtarget8对象说明
)
| 被触摸元素对象。 |
**属性:**
| 属性名称 | 类型 | 描述 |
| ------------------- | ---------------------------------------- | ------------ |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| touches | Array
<
[TouchObject](#touchobject对象说明)
>
| 全部手指信息。 |
| changedTouches | Array
<
[TouchObject](#touchobject对象说明)
>
| 当前发生变化的手指信息。 |
| timestamp | number | 距离开机时间的时间戳,单位为毫秒。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md#eventtarget8对象说明
)
| 被触摸元素对象。 |
**接口:**
-
接口
| 接口名称 | 功能描述 |
| ---------------------- | ------- |
| stopPropagation():void | 阻塞事件冒泡。 |
| 接口名称 | 功能描述 |
| ---------------------- | ------- |
| stopPropagation():void | 阻塞事件冒泡。 |
## TouchObject对象说明
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md
浏览文件 @
10da6fb1
...
...
@@ -8,17 +8,12 @@
> - 目前仅支持通过外接键盘的tab键、方向键触发。
## 权限列表
无
## 事件
|
**名称**
|
**支持冒泡**
|
**功能描述**
|
| -------- | -------- | -------- |
| onFocus(
callback
:
()
=
>
void) | 否 | 当前组件获取焦点时触发的回调。 |
| onBlur(
callback
:()
=
>
void) | 否 | 当前组件失去焦点时触发的回调。 |
| onFocus(
event
:
()
=
>
void) | 否 | 当前组件获取焦点时触发的回调。 |
| onBlur(
event
:()
=
>
void) | 否 | 当前组件失去焦点时触发的回调。 |
> **说明:**
> 支持焦点事件的组件:Button、Text、Image、List、Grid。
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
浏览文件 @
10da6fb1
...
...
@@ -3,20 +3,16 @@
在单个动作触发多个事件时,事件的顺序是固定的,鼠标事件默认透传。
> **说明:**
>
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 事件
| 名称
| 支持冒泡 | 描述
|
| ----------------------------------------
| ---- |
---------------------------------------- |
| onHover(
callback:
(isHover?:
boolean)
=
>
void) | 否
| 鼠标进入或退出组件时触发该回调。
<br/>
isHover:表示鼠标是否悬浮在组件上,鼠标进入时为true,
退出时为false。 |
| onMouse(
callback:
(event?:
MouseEvent)
=
>
void) | 是
| 当前组件被鼠标按键点击时或者鼠标在组件上移动时,触发该回调,event参数包含触发事件时的时间戳、鼠标按键、动作、点击触点在整个屏幕上的坐标和点击触点相对于当前组件的坐标。 |
| 名称
| 支持冒泡 | 描述
|
| ----------------------------------------
-------------------- | -------- | --------------------
---------------------------------------- |
| onHover(
event:
(isHover?:
boolean)
=
>
void) | 否
| 鼠标进入或退出组件时触发该回调。
<br/>
isHover:表示鼠标是否悬浮在组件上,鼠标进入时为true,
退出时为false。 |
| onMouse(
event:
(event?:
MouseEvent)
=
>
void) | 是
| 当前组件被鼠标按键点击时或者鼠标在组件上移动时,触发该回调,event参数包含触发事件时的时间戳、鼠标按键、动作、点击触点在整个屏幕上的坐标和点击触点相对于当前组件的坐标。 |
## MouseEvent对象说明
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录