鸿蒙Harmony应用开发—ArkTS-类型定义
说明：
本模块首批接口从API version 7开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。
Resource
资源引用类型，用于设置组件属性的值。
可以通过$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
长度类型，用于描述尺寸单位。
| 类型 | 说明 |
|---|---|
| string | 需要显式指定像素单位，如'10px'，也可设置百分比字符串，如'100%'。 |
| number | 默认单位vp。 |
| Resource | 资源引用类型，引入系统资源或者应用资源中的尺寸。 |
ResourceStr
字符串类型，用于描述字符串入参可以使用的类型。
| 类型 | 说明 |
|---|---|
| string | 字符串类型。 |
| Resource | 资源引用类型，引入系统资源或者应用资源中的字符串。 |
Padding
内边距类型，用于描述组件不同方向的内边距。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | Length | 否 | 上内边距，组件内元素距组件顶部的尺寸。 |
| right | Length | 否 | 右内边距，组件内元素距组件右边界的尺寸。 |
| bottom | Length | 否 | 下内边距，组件内元素距组件底部的尺寸。 |
| left | Length | 否 | 左内边距，组件内元素距组件左边界的尺寸。 |
Margin
外边距类型，用于描述组件不同方向的外边距。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | Length | 否 | 上外边距，组件顶部距组件外元素的尺寸。 |
| right | Length | 否 | 右外边距，组件右边界距组件外元素的尺寸。 |
| bottom | Length | 否 | 下外边距，组件底部距组件外元素的尺寸。 |
| left | Length | 否 | 左外边距，组件左边界距组件外元素的尺寸。 |
EdgeWidths9+
边框宽度类型，用于描述组件边框不同方向的宽度。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | Length | 否 | 组件上边框宽度。 |
| right | Length | 否 | 组件右边框宽度。 |
| bottom | Length | 否 | 组件下边框宽度。 |
| left | Length | 否 | 组件左边框宽度。 |
BorderRadiuses9+
圆角类型，用于描述组件边框圆角半径。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| topLeft | Length | 否 | 组件左上角圆角半径。 |
| topRight | Length | 否 | 组件右上角圆角半径。 |
| bottomLeft | Length | 否 | 组件左下角圆角半径。 |
| bottomRight | Length | 否 | 组件右下角圆角半径。 |
EdgeColors9+
边框颜色，用于描述组件边框四条边的颜色。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | ResourceColor | 否 | 组件上边框颜色。 |
| right | ResourceColor | 否 | 组件右边框颜色。 |
| bottom | ResourceColor | 否 | 组件下边框颜色。 |
| left | ResourceColor | 否 | 组件左边框颜色。 |
EdgeStyles9+
边框样式，用于描述组件边框四条边的样式。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| top | BorderStyle | 否 | 组件上边框样式。 |
| right | BorderStyle | 否 | 组件右边框样式。 |
| bottom | BorderStyle | 否 | 组件下边框样式。 |
| left | BorderStyle | 否 | 组件左边框样式。 |
Offset
相对布局完成位置坐标偏移量。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| dx | Length | 是 | 水平方向偏移量。 |
| dy | Length | 是 | 竖直方向偏移量。 |
RectResult10+
位置和尺寸类型，用于描述组件的位置和宽高。
| 参数 | 类型 | 描述 |
|---|---|---|
| x | number | 水平方向横坐标。 |
| y | number | 竖直方向纵坐标。 |
| width | number | 内容宽度大小。 |
| height | number | 内容高度大小。 |
ResourceColor
颜色类型，用于描述资源颜色类型。
| 类型 | 说明 |
|---|---|
| Color | 颜色枚举值。 |
| number | HEX格式颜色，支持rgb。示例：0xffffff。 |
| string | rgb或者argb格式颜色。示例：'#ffffff', '#ff000000', 'rgb(255, 100, 255)', 'rgba(255, 100, 255, 0.5)'。 |
| Resource | 使用引入资源的方式，引入系统资源或者应用资源中的颜色。 |
ColoringStrategy
智能取色枚举类型，用于设置前景色。
| 名称 | 描述 |
|---|---|
| INVERT | 设置前景色为控件背景色的反色。 |
LengthConstrain
长度约束，用于对组件最大、最小长度做限制。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| minLength | Length | 是 | 组件最小长度。 |
| maxLength | Length | 是 | 组件最大长度。 |
Font
设置文本样式。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| size | Length | 否 | 设置文本尺寸，Length为number类型时，使用fp单位。不支持设置百分比字符串。 默认值：16.0 |
| weight | FontWeight | number | string | 否 | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，取值越大，字体越粗。 默认值：400 | FontWeight.Normal |
| family | string | Resource | 否 | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, HarmonyOS Sans'。当前支持'HarmonyOS Sans'字体和注册自定义字体。 |
| style | FontStyle | 否 | 设置文本的字体样式。 默认值：FontStyle.Normal |
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 | EdgeWidths9+ | 否 | 边框宽度。 |
| color | ResourceColor | EdgeColors9+ | 否 | 边框颜色。 |
| radius | Length | BorderRadiuses9+ | 否 | 边框圆角半径。 |
| style | BorderStyle | EdgeStyles9+ | 否 | 边框样式。 |
ColorFilter9+
创建具有4*5矩阵的颜色过滤器。
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| constructor | number[] | 是 | 创建具有4*5矩阵的颜色过滤器, 入参为[m*n]位于m行和n列中矩阵值, 每个值的有效范围是[0, 1], 矩阵是行优先的。 |
CustomBuilder8+
组件属性方法参数可使用CustomBuilder类型来自定义UI描述。
| 名称 | 类型定义 | 描述 |
|---|---|---|
| CustomBuilder | () => any | 生成用户自定义组件，在使用时结合@Builder使用。具体用法见@Builder。 |
PixelStretchEffectOptions10+
像素扩展属性集合,用于描述像素扩展的信息。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| left | Length | 否 | 组件图像左边沿扩展距离。 |
| right | Length | 否 | 组件图像右边沿像素扩展距离。 |
| top | Length | 否 | 组件图像上边沿像素扩展距离。 |
| bottom | Length | 否 | 组件图像下边沿像素扩展距离。 |
ModalTransition10+
全屏模态转场方式枚举类型，用于设置全屏模态转场类型。
| 名称 | 描述 |
|---|---|
| NONE | 全屏模态无转场动画。 |
| DEFAULT | 全屏模态上下切换动画。 |
| ALPHA | 全屏模态透明度渐变动画。 |
Dimension10+
长度类型，用于描述尺寸单位。
| 类型 | 说明 |
|---|---|
| PX | 需要指定以px像素单位，如'10px'。 |
| VP | 需要指定数字或vp像素单位，如10或'10vp'。 |
| FP | 需要指定以fp像素单位，如'10fp'。 |
| LPX | 需要指定以lpx像素单位，如'10lpx'。 |
| Percentage | 需要指定以%像素单位，如'10%'。 |
| Resource | 资源引用类型，引入系统资源或者应用资源中的尺寸。 |
PX10+
长度类型，用于描述以px像素单位为单位的长度。
| 类型 | 说明 |
|---|---|
| {number}px | 需要指定以px像素单位，如'10px'。 |
VP10+
长度类型，用于描述以vp像素单位为单位的长度。
| 类型 | 说明 |
|---|---|
| {number}vp|number | 需要指定数字或vp像素单位，如10或'10vp'。 |
FP10+
长度类型，用于描述以fp像素单位为单位的长度。
| 类型 | 说明 |
|---|---|
| {number}fp | 需要指定以fp像素单位，如'10fp'。 |
LPX10+
长度类型，用于描述以lpx像素单位为单位的长度。
| 类型 | 说明 |
|---|---|
| {number}lpx | 需要指定以lpx像素单位，如'10lpx'。 |
Percentage10+
长度类型，用于描述以%像素单位为单位的长度。
| 类型 | 说明 |
|---|---|
| {number}% | 需要指定以%像素单位，如'10%'。 |
Degree10+
角度类型，用于描述以deg像素单位为单位的长度。
| 类型 | 说明 |
|---|---|
| {number}deg | 需要指定以deg像素单位，如'10deg'。 |
SwiperAnimationEvent10+
Swiper组件动画相关信息集合。
| 名称 | 类型定义 | 描述 |
|---|---|---|
| currentOffset | number | Swiper当前显示元素在主轴方向上，相对于Swiper起始位置的位移。单位VP，默认值为0. |
| targetOffset | number | Swiper动画目标元素在主轴方向上，相对于Swiper起始位置的位移。单位VP，默认值为0. |
| velocity | number | Swiper离手动画开始时的离手速度。单位VP/S，默认值为0. |
SafeAreaType10+
扩展安全区域的枚举类型。
| 名称 | 描述 |
|---|---|
| SYSTEM | 系统默认非安全区域，包括状态栏、导航栏。 |
| CUTOUT | 设备的非安全区域，例如刘海屏或挖孔屏区域。 |
| KEYBOARD | 软键盘区域。 |
SafeAreaEdge10+
扩展安全区域的方向。
| 名称 | 描述 |
|---|---|
| TOP | 上方区域。 |
| BOTTOM | 下方区域。 |
| START | 前部区域。 |
| END | 尾部区域。 |
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。
这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！
获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙（HarmonyOS NEXT）最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。
原文地址：https://blog.csdn.net/m0_64420071/article/details/136997153
免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！