HarmonyOS-UIAbitity-类型定义——【坚果派-红目香薰】
摘要
作者:红目香薰
团队:坚果派
团队介绍:坚果派由坚果创建,团队拥有12个华为HDE以及若干其他领域的三十余位万粉博主运营。
目录
摘要
HarmonyOS-UIAbitity-类型定义
Resource
Length
ResourceStr8+
Padding
Margin
Offset
ResourceColor8+
Font
Area8+
Position8+
ConstraintSizeOptions
SizeOptions
BorderOptions
CustomBuilder8+
HarmonyOS-UIAbitity-类型定义
Resource
资源引用类型,用于设置组件属性的值。
可以通过$r或者$rawfile创建Resource类型对象,不可以修改Resource中的各属性的值。
•
$r('belonging.type.name')
•
belonging:系统资源或者应用资源,相应的取值为'sys'和'app';
•
type:资源类型,支持'color'、'float'、'string'、'media'等;
•
name:资源名称,在资源定义时确定。
•
•
$rawfile('filename')
•
filename:工程中resources/rawfile目录下的文件名称。
•
Length
长度类型,用于描述尺寸单位。
类型 |
说明 |
string |
需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。 |
number |
默认单位vp。 |
Resource |
使用引入资源的方式,引入系统资源或者应用资源中的尺寸。 |
ResourceStr8+
字符串类型,用于描述字符串入参可以使用的类型。
类型 |
说明 |
string |
字符串类型。 |
Resource |
使用引入资源的方式,引入系统资源或者应用资源中的字符串。 |
Padding
内边距类型,用于描述组件不同方向的内边距。
名称 |
类型 |
必填 |
说明 |
|
top |
Length |
否 |
组件内元素距组件顶部的尺寸。 |
|
right |
Length |
否 |
组件内元素距组件右边界的尺寸。 |
|
bottom |
Length |
否 |
组件内元素距组件底部的尺寸。 |
|
left |
Length |
否 |
组件内元素距组件左边界的尺寸。 |
Margin
外边距类型,用于描述组件不同方向的外边距。
名称 |
类型 |
必填 |
说明 |
|
top |
Length |
否 |
组件外元素距组件顶部的尺寸。 |
|
right |
Length |
否 |
组件外元素距组件右边界的尺寸。 |
|
bottom |
Length |
否 |
组件外元素距组件底部的尺寸。 |
|
left |
Length |
否 |
组件外元素距组件左边界的尺寸。 |
Offset
相对布局完成位置坐标偏移量。
名称 |
类型 |
必填 |
说明 |
|
dx |
Length |
是 |
水平方向偏移量。 |
|
dy |
Length |
是 |
竖直方向偏移量。 |
ResourceColor8+
颜色类型,用于描述资源颜色类型。
类型 |
说明 |
Color |
颜色枚举值。 |
number |
HEX格式颜色。 |
string |
rgb或者rgba格式颜色。 |
Resource |
使用引入资源的方式,引入系统资源或者应用资源中的颜色。 |
Font
设置文本样式。
名称 |
类型 |
必填 |
说明 |
|
size |
Length |
否 |
设置文本尺寸,Length为number类型时,使用fp单位。 |
|
weight |
FontWeight| number | string |
否 |
设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。 |
|
family |
string | Resource |
否 |
设置文本的字体列表。使用多个字体,使用','进行分割,优先级按顺序生效。例如:'Arial, sans-serif'。 |
|
style |
FontStyle |
否 |
设置文本的字体样式。 |
Area8+
区域类型,用于存储元素所占区域信息
名称 |
类型 |
必填 |
说明 |
|
width |
Length |
是 |
目标元素的宽度,作为返回值时,类型为number,单位vp。 |
|
height |
Length |
是 |
目标元素的高度,作为返回值时,类型为number,单位vp。 |
|
position |
Position |
是 |
目标元素左上角相对父元素左上角的位置。 |
|
globalPosition |
Position |
是 |
目标元素左上角相对页面左上角的位置。 |
Position8+
位置类型,用于表示一个坐标点。
名称 |
类型 |
必填 |
说明 |
|
x |
Length |
否 |
x轴坐标,作为返回值时,类型为number,单位vp。 |
|
y |
Length |
否 |
y轴坐标,作为返回值时,类型为number,单位vp。 |
ConstraintSizeOptions
设置约束尺寸,组件布局时,进行尺寸范围限制。
名称 |
类型 |
必填 |
说明 |
|
minWidth |
Length |
否 |
元素最小宽度。 |
|
maxWidth |
Length |
否 |
元素最大宽度。 |
|
minHeight |
Length |
否 |
元素最小高度。 |
|
maxHeight |
Length |
否 |
元素最大高度。 |
SizeOptions
设置宽高尺寸。
名称 |
类型 |
必填 |
说明 |
|
width |
Length |
否 |
元素宽度。 |
|
height |
Length |
否 |
元素高度。 |
BorderOptions
边框属性集合,用于描述边框相关信息。
名称 |
类型 |
必填 |
说明 |
|
width |
Length |
否 |
边框宽度。 |
|
color |
ResourceColor |
否 |
边框颜色。 |
|
radius |
Length |
否 |
边框圆角半径。 |
|
style |
BorderStyle |
否 |
边框样式。 |
CustomBuilder8+
组件属性方法参数可使用CustomBuilder类型来自定义UI描述。
名称 |
类型定义 |
描述 |
|
CustomBuilder |
() => any |
这种方法类型必须使用@Builder装饰器修饰。具体用法见@Builder。 |
- 点赞
- 收藏
- 关注作者
评论(0)