鸿蒙5.0开发进阶:ArkTS组件-基础类型定义

往期鸿蒙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
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值