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）