Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Coping0606
Docs
提交
ca942b4c
D
Docs
项目概览
Coping0606
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
1
Fork
0
代码
文件
提交
分支
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,发现更多精彩内容 >>
提交
ca942b4c
编写于
9月 06, 2022
作者:
T
tianyu
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
release first
Signed-off-by:
N
tianyu
<
tianyu55@h-partners.com
>
上级
6b2ccd9d
变更
15
隐藏空白更改
内联
并排
Showing
15 changed file
with
131 addition
and
193 deletion
+131
-193
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md
...v/reference/arkui-ts/ts-basic-components-checkboxgroup.md
+5
-9
zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
...ication-dev/reference/arkui-ts/ts-container-tabcontent.md
+1
-6
zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md
...n/application-dev/reference/arkui-ts/ts-container-tabs.md
+1
-6
zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
...ation-dev/reference/arkui-ts/ts-media-components-video.md
+9
-8
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
.../reference/arkui-ts/ts-universal-attributes-background.md
+9
-14
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md
...-dev/reference/arkui-ts/ts-universal-attributes-border.md
+10
-15
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
...on-dev/reference/arkui-ts/ts-universal-attributes-menu.md
+7
-12
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-opacity.md
...dev/reference/arkui-ts/ts-universal-attributes-opacity.md
+3
-8
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-polymorphic-style.md
...nce/arkui-ts/ts-universal-attributes-polymorphic-style.md
+13
-16
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md
...n-dev/reference/arkui-ts/ts-universal-attributes-popup.md
+28
-33
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
...on-dev/reference/arkui-ts/ts-universal-attributes-size.md
+9
-14
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-touch-target.md
...eference/arkui-ts/ts-universal-attributes-touch-target.md
+16
-18
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
...ation-dev/reference/arkui-ts/ts-universal-events-click.md
+12
-16
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
...ation-dev/reference/arkui-ts/ts-universal-events-touch.md
+4
-9
zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
...lication-dev/reference/arkui-ts/ts-universal-mouse-key.md
+4
-9
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md
浏览文件 @
ca942b4c
...
...
@@ -6,25 +6,21 @@
>
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 子组件
无
## 接口
CheckboxGroup( option?: {group?: string} )
CheckboxGroup( option
s
?: {group?: string} )
创建多选框群组,可以控制群组内的Checkbox全选或者不全选,相同group的Checkbox和CheckboxGroup为同一群组。
**参数:**
| 参数名
| 参数类型 | 必填 | 默认值 | 参数描述
|
| -----
| ------ | ---- | ---- |
----- |
| group
| string | 否 | -
| 群组名称。 |
| 参数名
| 参数类型 | 必填 | 参数描述
|
| -----
- | -------- | ---- | -----
----- |
| group
| string | 否
| 群组名称。 |
## 属性
...
...
@@ -50,7 +46,7 @@ CheckboxGroup的选中状态或群组内的Checkbox的选中状态发生变化
| 名称 | 参数类型 | 描述 |
| ------ | ------------------- | -------------- |
| name | Array
<
string
>
| checkBox名称。 |
| status |
s
electStatus | 选中状态。 |
| status |
S
electStatus | 选中状态。 |
## SelectStatus枚举说明
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
浏览文件 @
ca942b4c
...
...
@@ -7,11 +7,6 @@
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 子组件
支持单个子组件。
...
...
@@ -28,7 +23,7 @@ TabContent()
| 名称 | 参数类型 | 默认值 | 描述 |
| ------ | ------------------------------------------------------------ | ------ | ------------------------------------------------------------ |
| tabBar | string
\|
[Resource](ts-types.md#resource)
\|
{
<br/>
icon?:
string
\|
[Resource](ts-types.md#resource),
<br/>
text?:
string
\|
[Resource](ts-types.md#resource)
<br/>
}
<br/>
\|
[
CustomBuilder
](
ts-types.md#custombuilder8
)
<sup>
8+
</sup>
| - | 设置TabBar上显示内容。
<br/>
CustomBuilder:
构造器,内部可以传入组件(API8版本以上适用)。
<br/>
>
**说明:**
<br/>
>
如果icon采用svg格式图源,则要求svg图源删除其自有宽高属性值。如采用带有自有宽高属性的svg图源,icon大小则是svg本身内置的宽高属性值大小。 |
| tabBar | string
\|
[Resource](ts-types.md#resource)
\|
{
<br/>
icon?:
string
\|
[Resource](ts-types.md#resource),
<br/>
text?:
string
\|
[Resource](ts-types.md#resource)
<br/>
}
<br/>
\|
[
CustomBuilder
](
ts-types.md#custombuilder8
)
<sup>
8+
</sup>
| - | 设置TabBar上显示内容。
<br/>
CustomBuilder:
构造器,内部可以传入组件(API8版本以上适用)。
<br/>
**说明:**
<br/>
如果icon采用svg格式图源,则要求svg图源删除其自有宽高属性值。如采用带有自有宽高属性的svg图源,icon大小则是svg本身内置的宽高属性值大小。 |
> **说明:**
> - TabContent组件不支持设置通用宽度属性,其宽度默认撑满Tabs父组件。
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md
浏览文件 @
ca942b4c
...
...
@@ -7,11 +7,6 @@
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 子组件
包含子组件
[
TabContent
](
ts-container-tabcontent.md
)
。
...
...
@@ -19,7 +14,7 @@
## 接口说明
Tabs(value: {barPosition?: BarPosition, index?: number, controller?:
[
TabsController
](
#tabscontroller
)
})
Tabs(value
?
: {barPosition?: BarPosition, index?: number, controller?:
[
TabsController
](
#tabscontroller
)
})
**参数:**
...
...
zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
浏览文件 @
ca942b4c
# Video
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
视频播放组件。
> **说明:**
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
使用网络视频时,需要在config或者module.json对应的"abilities"中添加网络使用权限ohos.permission.INTERNET。
...
...
@@ -27,7 +28,7 @@
## 接口
Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})
Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})
**参数:**
...
...
@@ -68,10 +69,10 @@
| onPause(event:()
=
>
void) | 暂停时触发该事件。 |
| onFinish(event:()
=
>
void) | 播放结束时触发该事件。 |
| onError(event:()
=
>
void) | 播放失败时触发该事件。 |
| onPrepared(call
B
ack:(event?:
{
duration:
number
})
=
>
void) | 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为s。
<br/>
- duration: 视频的时长。 |
| onSeeking(call
B
ack:(event?:
{
time:
number
})
=
>
void) | 操作进度条过程时上报时间信息,单位为s。 |
| onSeeked(call
B
ack:(event?:
{
time:
number
})
=
>
void) | 操作进度条完成后,上报播放时间信息,单位为s。 |
| onUpdate(call
B
ack:(event?:
{
time:
number
})
=
>
void) | 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。 |
| onPrepared(call
b
ack:(event?:
{
duration:
number
})
=
>
void) | 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为s。
<br/>
- duration: 视频的时长。 |
| onSeeking(call
b
ack:(event?:
{
time:
number
})
=
>
void) | 操作进度条过程时上报时间信息,单位为s。 |
| onSeeked(call
b
ack:(event?:
{
time:
number
})
=
>
void) | 操作进度条完成后,上报播放时间信息,单位为s。 |
| onUpdate(call
b
ack:(event?:
{
time:
number
})
=
>
void) | 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。 |
## VideoController
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
浏览文件 @
ca942b4c
# 背景设置
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
设置组件的背景色。
## 权限列表
无
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| -------- | -------- | -------- |
-------- |
| backgroundColor |
Color | -
| 设置组件的背景色。 |
| backgroundImage | src:
string,
<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
](
ts-types.md#resourcecolor
)
| 设置组件的背景色。 |
| backgroundImage | src:
[ResourceStr](ts-types.md#resourcestr),
<br/>
repeat?:
[
ImageRepeat
](
ts-appendix-enums.md#imagerepeat
)
| src:图片地址,支持网络图片资源和本地图片资源地址(不支持svg类型的图片)。
<br/>
repeat
:设置背景图片的重复样式,默认不重复。 |
| backgroundImageSize | {
<br/>
width?:
[Length](ts-types.md#length),
<br/>
height?:
[Length](ts-types.md#length)
<br/>
}
\|
[
ImageSize
](
ts-appendix-enums.md#imagesize
)
| 设置背景图像的高度和宽度。当输入为{width:
Length,
height:
Length}对象时,如果只设置一个属性,则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。
<br/>
默认值:ImageSize.Auto
|
| backgroundImagePosition | {
<br/>
x?:
[Length](ts-types.md#length),
<br/>
y?:
[Length](ts-types.md#length)
<br/>
}
\|
[
Alignment
](
ts-appendix-enums.md#alignment
)
| 设置背景图在组件中显示位置。
<br/>
{
<br/>
x:
0,
<br/>
y:
0
<br/>
}
|
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md
浏览文件 @
ca942b4c
# 边框设置
> **说明:**
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
设置组件边框样式。
## 权限列表
无
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| -------- | -------- | -------- |
-------- |
| border | {
<br/>
width?:
Length,
<br/>
color?:
Color,
<br/>
radius?:
Length,
<br/>
style?:
[
BorderStyle
](
ts-appendix-enums.md#borderstyle
)
<br/>
} | -
| 统一边框样式设置接口。 |
| borderStyle |
[
BorderStyle
](
ts-appendix-enums.md#borderstyle
)
|
BorderStyle.Solid | 设置元素的边框样式。
|
| borderWidth |
Length | 0
| 设置元素的边框宽度。 |
| borderColor |
Color | -
| 设置元素的边框颜色。 |
| borderRadius |
Length | 0
| 设置元素的边框圆角半径。 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| border | {
<br/>
width?:
[Length](ts-types.md#length),
<br/>
color?:
[ResourceColor](ts-types.md#resourcecolor),
<br/>
radius?:
[Length](ts-types.md#length),
<br/>
style?:
[
BorderStyle
](
ts-appendix-enums.md#borderstyle
)
<br/>
}
| 统一边框样式设置接口。 |
| borderStyle |
[
BorderStyle
](
ts-appendix-enums.md#borderstyle
)
|
设置元素的边框样式。
<br/>
默认值:BorderStyle.Solid
|
| borderWidth |
[
Length
](
ts-types.md#length
)
| 设置元素的边框宽度。 |
| borderColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置元素的边框颜色。 |
| borderRadius |
[
Length
](
ts-types.md#length
)
| 设置元素的边框圆角半径。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
浏览文件 @
ca942b4c
...
...
@@ -5,24 +5,19 @@
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| ---------------------------- | ------------------------------------------------------------ | ------
| ------
------------------------------------------------------ |
| bindMenu | Array
<MenuItem
&
gt
;&
nbsp
;\|&
nbsp
;[
CustomBuilder
](
ts-types.md#custombuilder8
)
<
sup
>
8+
</sup>
| -
| 给组件绑定菜单,点击后弹出菜单。弹出菜单项支持文本和自定义两种功能。 |
| bindContextMenu
<sup>
8+
</sup>
| content:
[CustomBuilder](ts-types.md#custombuilder8)
<br>
responseType:
[
ResponseType
](
ts-appendix-enums.md#responsetype8
)
|
- |
给组件绑定菜单,触发方式为长按或者右键点击,弹出菜单项需要自定义。 |
| 名称 | 参数类型 | 描述 |
| ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| bindMenu | Array<MenuItem
>
\|
[
CustomBuilder
](
ts-types.md#custombuilder8
)
| 给组件绑定菜单,点击后弹出菜单。弹出菜单项支持文本和自定义两种功能。 |
| bindContextMenu
<sup>
8+
</sup>
| content:
[CustomBuilder](ts-types.md#custombuilder8)
<br>
responseType:
[
ResponseType
](
ts-appendix-enums.md#responsetype8
)
| 给组件绑定菜单,触发方式为长按或者右键点击,弹出菜单项需要自定义。 |
## MenuItem
| 名称
| 类型 | 描述
|
| ------ | ----------------------- | ----------- |
| value | string | 菜单项文本。 |
| 名称
| 类型 | 描述
|
| ------ | ----------------------- | -----------
-----------
|
| value | string | 菜单项文本。
|
| action | ()
=
>
void | 点击菜单项的事件回调。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-opacity.md
浏览文件 @
ca942b4c
...
...
@@ -7,17 +7,12 @@
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 属性
| 名称
| 参数类型 | 默认值 | 描述
|
| ------- | ------
| ---- |
---------------------------------- |
| opacity | number
| 1 | 元素的不透明度,取值范围为0到1,1表示为不透明,0表示为完全透明。
|
| 名称
| 参数类型 | 描述
|
| ------- | ------
---------------------------------------------- | --------------------------
---------------------------------- |
| opacity | number
\|
[
Resource
](
ts-types.md#resource
)
| 元素的不透明度,取值范围为0到1,1表示为不透明,0表示为完全透明。
<br/>
默认值:1
|
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-polymorphic-style.md
浏览文件 @
ca942b4c
# 多态样式
> **说明:**
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
设置组件不同状态下的样式。
## 权限列表
无
> **说明:**
>
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
| 名称
| 参数类型 | 默认值 | 描述
|
| ----------- | ----------- | ----
|
------------ |
| stateStyles | StateStyles |
- |
设置组件不同状态的样式。 |
| 名称
| 参数类型 | 描述
|
| ----------- | ----------- | ----
--------
------------ |
| stateStyles | StateStyles | 设置组件不同状态的样式。 |
## StateStyles接口说明
| 名称 | 类型 | 必填 | 默认值 | 描述 |
| -------- | ----------- | ---- | ---- | ---------- |
| normal | ()=
>
void | 否 | - | 组件无状态时的样式。 |
| pressed | ()=
>
void | 否 | - | 组件按下状态的样式。 |
| disabled | ()=
>
void | 否 | - | 组件禁用状态的样式。 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---- | ---- | -------------------- |
| normal | any | 否 | 组件无状态时的样式。 |
| pressed | any | 否 | 组件按下状态的样式。 |
| disabled | any | 否 | 组件禁用状态的样式。 |
| focused | any | 否 | 组件获焦状态的样式。 |
| clicked | any | 否 | 组件点击状态的样式。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md
浏览文件 @
ca942b4c
...
...
@@ -5,39 +5,34 @@
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
| --------- | ---------------------------------------- | ---- | ---------------------------------------- |
| bindPopup | show:
boolean,
<br/>
popup:
PopupOptions\|
CustomPopupOptions | - | 给组件绑定Popup,点击弹出弹窗。
<br/>
show:
创建页面弹窗提示是否默认显示,默认值为false。
<br/>
popup:
配置当前弹窗提示的参数。 |
## PopupOptions类型接口说明
| 名称 | 类型 | 必填 | 默认值 | 描述 |
| --------------- | ---------------------------------------- | ---- | ----- | ---------------------------------------- |
| message | string | 是 | - | 弹窗信息内容。 |
| placementOnTop | boolean | 否 | false | 是否在组件上方显示,默认值为false。 |
| primaryButton | {
<br/>
value:
string,
<br/>
action:
()
=
>
void
<br/>
} | 否 | - | 第一个按钮。
<br/>
value:
弹窗里主按钮的文本。
<br/>
action:
点击主按钮的回调函数。 |
| secondaryButton | {
<br/>
value:
string,
<br/>
action:
()
=
>
void
<br/>
} | 否 | - | 第二个按钮。
<br/>
value:
弹窗里辅助按钮的文本。
<br/>
action:
点击辅助按钮的回调函数。 |
| onStateChange | (isVisible:
boolean)
=
>
void | 否 | - | 弹窗状态变化事件回调,参数isVisible为弹窗当前的显示状态。 |
## CustomPopupOptions<sup>8+</sup>类型接口说明
| 名称 | 类型 | 必填 | 默认值 | 描述 |
| ------------- | ---------------------------------------------- | ---- | ---------------- | ------------------------------------------------------------ |
| builder | ()
=
>
any | 是 | - | 提示气泡内容的构造器。 |
| placement |
[
Placement
](
ts-appendix-enums.md#placement8
)
| 否 | Placement.Bottom | 气泡组件优先显示的位置,当前位置显示不下时,会自动调整位置。 |
| maskColor |
[
Color
](
ts-appendix-enums.md#color
)
| 否 | - | 提示气泡遮障层的颜色。 |
| popupColor |
[
Color
](
ts-appendix-enums.md#color
)
| 否 | - | 提示气泡的颜色。 |
| enableArrow | boolean | 否 | true | 是否显示箭头,只有上、下方向的气泡会显示箭头。 |
| autoCancel | boolean | 否 | true | 页面有操作时,是否自动关闭气泡 |
| onStateChange | (isVisible:
boolean)
=
>
void | 否 | - | 弹窗状态变化事件回调,参数为弹窗当前的显示状态。 |
## 接口
| 名称 | 参数类型 | 描述 |
| --------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| bindPopup | show:
boolean,
<br/>
popup:
PopupOptions\|
CustomPopupOptions
<sup>
8+
</sup>
| 给组件绑定Popup,点击弹出弹窗。
<br/>
show:
创建页面弹窗提示是否默认显示,默认值为false。
<br/>
popup:
配置当前弹窗提示的参数。 |
## PopupOptions类型说明
| 名称 | 类型 | 必填 | 描述 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| message | string | 是 | 弹窗信息内容。 |
| placementOnTop | boolean | 否 | 是否在组件上方显示,默认值为false。 |
| primaryButton | {
<br/>
value:
string,
<br/>
action:
()
=
>
void
<br/>
} | 否 | 第一个按钮。
<br/>
value:
弹窗里主按钮的文本。
<br/>
action:
点击主按钮的回调函数。 |
| secondaryButton | {
<br/>
value:
string,
<br/>
action:
()
=
>
void
<br/>
} | 否 | 第二个按钮。
<br/>
value:
弹窗里辅助按钮的文本。
<br/>
action:
点击辅助按钮的回调函数。 |
| onStateChange | (event:{isVisible:
boolean })
=
>
void | 否 | 弹窗状态变化事件回调,参数isVisible为弹窗当前的显示状态。 |
## CustomPopupOptions<sup>8+</sup>类型说明
| 名称 | 类型 | 必填 | 描述 |
| ------------- | ------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| builder |
[
CustomBuilder
](
ts-types.md#custombuilder8
)
| 是 | 提示气泡内容的构造器。 |
| placement |
[
Placement
](
ts-appendix-enums.md#placement8
)
| 否 | 气泡组件优先显示的位置,当前位置显示不下时,会自动调整位置。
<br/>
默认值:Placement.Bottom |
| maskColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 提示气泡遮障层的颜色。 |
| popupColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 提示气泡的颜色。 |
| enableArrow | boolean | 否 | 是否显示箭头,只有上、下方向的气泡会显示箭头。
<br/>
默认值:true |
| autoCancel | boolean | 否 | 页面有操作时,是否自动关闭气泡
<br/>
默认值:true |
| onStateChange | (event:{isVisible:
boolean })
=
>
void | 否 | 弹窗状态变化事件回调,参数为弹窗当前的显示状态。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
浏览文件 @
ca942b4c
...
...
@@ -5,23 +5,18 @@
> 从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
| 0 | 容器尺寸确定时,元素与兄弟节点主轴布局尺寸按照权重进行分配,忽略本身尺寸设置,表示自适应占满剩余空间。
<br/>
>
**说明:**
<br/>
>
仅在Row/Column/Flex布局中生效。 |
| 名称 | 参数说明 | 描述 |
| -------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| width |
[
Length
](
ts-types.md#length
)
| 设置组件自身的宽度,缺省时使用元素自身内容需要的宽度。 |
| height |
[
Length
](
ts-types.md#length
)
| 设置组件自身的高度,缺省时使用元素自身内容需要的高度。 |
| size | {
<br/>
width?:
[Length](ts-types.md#length),
<br/>
height?:
[
Length
](
ts-types.md#length
)
<br/>
}
| 设置高宽尺寸。 |
| padding |
[
Padding
](
ts-types.md#padding
)
\|
[
Length
](
ts-types.md#length
)
| 设置内边距属性。
<br/>
参数为Length类型时,四个方向内边距同时生效。
<br/>
默认值:0
|
| margin |
[
Margin
](
ts-types.md#margin
)
\|
[
Length
](
ts-types.md#length
)
| 设置外边距属性。
<br/>
参数为Length类型时,四个方向外边距同时生效。
<br/>
默认值:0
|
| constraintSize | {
<br/>
minWidth?:
[Length](ts-types.md#length),
<br/>
maxWidth?:
[Length](ts-types.md#length),
<br/>
minHeight?:
[Length](ts-types.md#length),
<br/>
maxHeight?:
[
Length
](
ts-types.md#length
)
<br/>
} | 设置约束尺寸,组件布局时,进行尺寸范围限制。
<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-attributes-touch-target.md
浏览文件 @
ca942b4c
# 触摸热区设置
适用于支持通用点击事件、通用触摸事件、通用手势处理的组件。
> **说明:**
>
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
适用于支持通用点击事件、通用触摸事件、通用手势处理的组件。
## 权限列表
无
## 属性
| 名称
| 参数类型 | 默认值 | 描述
|
| -------------- | ----------------------------------------
| ---------------------------------------- |
---------------------------------------- |
| responseRegion | Array
<
Rectangle
>
\|
Rectangle |
{
<br/>
x:0,
<br/>
y:0,
<br/>
width:'100%',
<br/>
height:'100%'
<br/>
} | 设置一个或多个触摸热区,包括位置和大小。
<br/>
>
**说明:**
<br/>
>
-百分比是相对于组件本身来度量的。
<br/>
>
-x和y可以设置正负值百分比。当x设置为'100%'时表示热区往右偏移组件本身宽度大小,当x设置为'-100%'时表示热区往左偏移组件本身宽度大小。当y设置为'100%'时表示热区往下偏移组件本身高度大小,当y设置为'-100%'时表示热区往上偏移组件本身高度大小。
<br/>
>
-width和height只能设置正值百分比。width:'100%'表示热区宽度设置为该组件本身的宽度。比如组件本身宽度是100vp,那么'100%'表示热区宽度也为100vp。height:'100%'表示热区高度设置为该组件本身的高度。
|
| 名称
| 参数类型 | 描述
|
| -------------- | ----------------------------------------
----- | --------------------
---------------------------------------- |
| responseRegion | Array
<
Rectangle
>
\|
Rectangle |
设置一个或多个触摸热区,包括位置和大小。
<br/>
默认值:
<br/>
{
<br/>
x:0,
<br/>
y:0,
<br/>
width:'100%',
<br/>
height:'100%'
<br/>
}
|
### Rectangle对象说明
| 名称
| 类型 | 必填 | 默认值 | 描述
|
| ------ | ------
| ---- | ---- |
------------------ |
| x |
Length | 否 | 0vp | 触摸点相对于组件本身左边沿的X坐标。
|
| y |
Length | 否 | 0vp | 触摸点相对于组件本身左边沿的Y坐标。
|
| width |
Length | 否 | 100% | 触摸热区范围的宽度。
|
| height |
Length | 否 | 100% | 触摸热区范围的高度。
|
| 名称
| 类型 | 必填 | 默认值 | 描述
|
| ------ | ------
---------------------- | ---- | ------ | ---------------------------------
------------------ |
| x |
[
Length
](
ts-types.md#length
)
| 否 | 0vp | 触摸点相对于组件本身左边沿的X坐标。
<br/>
默认值:0vp
|
| y |
[
Length
](
ts-types.md#length
)
| 否 | 0vp | 触摸点相对于组件本身左边沿的Y坐标。
<br/>
默认值:0vp
|
| width |
[
Length
](
ts-types.md#length
)
| 否 | 100% | 触摸热区范围的宽度。
<br/>
默认值:100%
|
| height |
[
Length
](
ts-types.md#length
)
| 否 | 100% | 触摸热区范围的高度。
<br/>
默认值:100%
|
> **说明:**
>
> 当x和y都设置为正值时,表示组件的触摸热区的范围整体往组件本身右下角偏移,偏移的大小可通过数值来设置。
> x和y可以设置正负值百分比。当x设置为'100%'时表示热区往右偏移组件本身宽度大小,当x设置为'-100%'时表示热区往左偏移组件本身宽度大小。当y设置为'100%'时表示热区往下偏移组件本身高度大小,当y设置为'-100%'时表示热区往上偏移组件本身高度大小。
>
> width和height只能设置正值百分比。width:'100%'表示热区宽度设置为该组件本身的宽度。比如组件本身宽度是100vp,那么'100%'表示热区宽度也为100vp。height:'100%'表示热区高度设置为该组件本身的高度。
>
> 百分比是相对于组件本身来度量的。
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
浏览文件 @
ca942b4c
...
...
@@ -5,26 +5,22 @@
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 事件
| 名称
| 支持冒泡 | 功能描述
|
| ----------------------------------------
| ---- |
--------------------------------- |
| onClick(
callback:
(event?:
ClickEvent)
=
>
void) | 否
| 点击动作触发该方法调用,event参数见ClickEvent介绍。 |
| 名称
| 支持冒泡 | 功能描述
|
| ----------------------------------------
-------------------- | -------- | ------------------
--------------------------------- |
| onClick(
event:
(event?:
ClickEvent)
=
>
void) | 否
| 点击动作触发该方法调用,event参数见ClickEvent介绍。 |
## ClickEvent对象说明
| 属性名称 | 类型 | 描述 |
| ------------------- | -------------------------------- | ------------------- |
| screenX | number | 点击点相对于设备屏幕左边沿的X坐标。 |
| screenY | number | 点击点相对于设备屏幕上边沿的Y坐标。 |
| x | number | 点击点相对于被点击元素左边沿的X坐标。 |
| y | number | 点击点相对于被点击元素上边沿的Y坐标。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
#eventtarget8对象说明
)
| 被点击元素对象。 |
| timestamp | number | 事件时间戳。 |
| 属性名称 | 类型 | 描述 |
| ---------------------- | ------------------------------------ | ------------------------------------- |
| screenX | number | 点击点相对于设备屏幕左边沿的X坐标。 |
| screenY | number | 点击点相对于设备屏幕上边沿的Y坐标。 |
| x | number | 点击点相对于被点击元素左边沿的X坐标。 |
| y | number | 点击点相对于被点击元素上边沿的Y坐标。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
#eventtarget8对象说明
)
| 被点击元素对象。 |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。 |
| source
<sup>
8+
</sup>
|
[
SourceType
](
ts-gesture-settings.md
)
| 事件输入设备。 |
## EventTarget<sup>8+</sup>对象说明
| 名称 | 参数类型 | 描述 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
浏览文件 @
ca942b4c
...
...
@@ -5,16 +5,11 @@
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 事件
| 名称
| 是否冒泡 | 功能描述
|
| ----------------------------------------
| ---- |
---------------------------------------- |
| onTouch(
callback:
(event?:
TouchEvent)
=
>
void) | 是
| 触摸动作触发该方法调用,event参数见
[
TouchEvent
](
#touchevent对象说明
)
介绍。 |
| 名称
| 是否冒泡 | 功能描述
|
| ----------------------------------------
-------------------- | -------- | --------------------
---------------------------------------- |
| onTouch(
event:
(event?:
TouchEvent)
=
>
void) | 是
| 触摸动作触发该方法调用,event参数见
[
TouchEvent
](
#touchevent对象说明
)
介绍。 |
## TouchEvent对象说明
...
...
@@ -23,7 +18,7 @@
| 属性名称 | 类型 | 描述 |
| ------------------- | ------------------------------------------------------------ | ---------------------------------- |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| touches | Array
<
[TouchObject](#touchobject对象说明)
>
| 全部手指信息。 |
| changedTouches | Array
<
[TouchObject](#touchobject对象说明)
>
| 当前发生变化的手指信息。 |
| timestamp | number | 距离开机时间的时间戳,单位为毫秒。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
浏览文件 @
ca942b4c
...
...
@@ -5,17 +5,12 @@
> 从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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录