往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)
基础类型定义
说明
本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
Resource
元服务API: 从API version 11开始,该接口支持在元服务中使用。
资源引用类型,用于设置组件属性的值。
可以通过$r或者$rawfile创建Resource类型对象,不可以修改Resource中的各属性的值。
-
$r('belonging.type.name')
belonging:系统资源或者应用资源,相应的取值为'sys'和'app';
type:资源类型,支持'boolean'、'color'、'float'、'intarray'、'integer'、'pattern'、'plural'、'strarray'、'string'、'media';
name:资源名称,在资源定义时确定。
-
$rawfile('filename')
filename:工程中resources/rawfile目录下的文件名称。
说明: 在引用资源类型时,注意其数据类型要与属性方法本身的类型一致,例如某个属性方法支持设置string | Resource,那么在使用Resource引用类型时,其数据类型也应当为string。
Length
长度类型,用于描述尺寸单位。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
类型 | 说明 |
---|---|
string | 需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。 说明: 不指定像素单位时,默认单位vp,如'10',等同于10。 |
number | 默认单位vp。 |
Resource | 资源引用类型,引入系统资源或者应用资源中的尺寸。 |
ResourceStr
字符串类型,用于描述字符串入参可以使用的类型。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
类型 | 说明 |
---|---|
string | 字符串类型。 |
Resource | 资源引用类型,引入系统资源或者应用资源中的字符串。 |
Padding
内边距类型,用于描述组件不同方向的内边距。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
top | Length | 否 | 上内边距,组件内元素距组件顶部的尺寸。 |
right | Length | 否 | 右内边距,组件内元素距组件右边界的尺寸。 |
bottom | Length | 否 | 下内边距,组件内元素距组件底部的尺寸。 |
left | Length | 否 | 左内边距,组件内元素距组件左边界的尺寸。 |
LocalizedPadding12+
内边距类型,用于描述组件不同方向的内边距。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
top | LengthMetrics12+ | 否 | 上内边距,组件内元素距组件顶部的尺寸。 |
end | LengthMetrics12+ | 否 | 右内边距,组件内元素距组件右边界的尺寸。 从右至左显示语言模式下为 左内边距,组件内元素距组件左边界的尺寸。 |
bottom | LengthMetrics12+ | 否 | 下内边距,组件内元素距组件底部的尺寸。 |
start | LengthMetrics12+ | 否 | 左内边距,组件内元素距组件左边界的尺寸。 从右至左显示语言模式下为 右内边距,组件内元素距组件右边界的尺寸。 |
Margin
外边距类型,用于描述组件不同方向的外边距。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
top | Length | 否 | 上外边距,组件顶部距组件外元素的尺寸。 |
right | Length | 否 | 右外边距,组件右边界距组件外元素的尺寸。 |
bottom | Length | 否 | 下外边距,组件底部距组件外元素的尺寸。 |
left | Length | 否 | 左外边距,组件左边界距组件外元素的尺寸。 |
LocalizedMargin12+
外边距类型,用于描述组件不同方向的外边距。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
top | LengthMetrics12+ | 否 | 上外边距,组件顶部距组件外元素的尺寸。 |
end | LengthMetrics12+ | 否 | 右外边距,组件右边界距组件外元素的尺寸。 从右至左显示语言模式下为 左外边距,组件左边界距组件外元素的尺寸。 |
bottom | LengthMetrics12+ | 否 | 下外边距,组件底部距组件外元素的尺寸。 |
start | LengthMetrics12+ | 否 | 左外边距,组件左边界距组件外元素的尺寸。 从右至左显示语言模式下为 右外边距,组件右边界距组件外元素的尺寸。 |
EdgeWidths9+
边框宽度类型,用于描述组件边框不同方向的宽度。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
top | Length | 否 | 组件上边框宽度。 |
right | Length | 否 | 组件右边框宽度。 |
bottom | Length | 否 | 组件下边框宽度。 |
left | Length | 否 | 组件左边框宽度。 |
LocalizedEdgeWidths12+
边框宽度类型,用于描述组件边框不同方向的宽度。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
top |