3.1 ArkUI简介
ArkUI(方舟UI框架)为应用的UI开发提供了完整的基础设施,包括简洁的UI语法、丰富的UI功能(组件、布局、动画以及交互事件),以及实时界面预览工具等,可以支持开发者进行可视化界面开发。
ArkUI官方文档:developer.huawei.com/consumer/cn…
ArkUI里面包含了很多种组件类型,其中最常用的一个是基础组件,它充当着页面元素的角色;另一个是容器组件,因为任何一个页面都离不开布局样式。
3.2 ArkUI基础组件
3.2.1 Image组件
Image组件文档:developer.huawei.com/consumer/cn…
1、声明Image组件并设置图片源
Image组件里定义了3种图片源模式,分别是:网络图片、像素图、本地图片。其中我们最常用的是网络图片和本地图片。
(1)src网络图片
Image('https://res.vmallres.com/pimages//uomcdn/CN/pms/202309/gbom/6942103109546/800_800_D8C79AD546E4A12920F05B427036ED8Bmp.png')
加载网络图片,如果在PC端开发是没有问题的,但现在是开发手机应用,手机请求网络是需要手机系统设备许可的,因此它需要先去申请网络访问权限。
关于权限设置,可以参考HarmonyOS4+NEXT—第二章 安装真机模拟器。
(2)本地图片
对比网络图片而言,加载本地图片更加方便,它既不需要设置访问权限,也避免了外部原因的干扰,是比较推荐使用的方式。
它有两种语法分别是
r
和
r和
r和rawfile,这两种方式加载应用内部的目录是不一样的。
1.$r
r
读取的是
r
e
s
o
u
r
c
e
s
/
b
a
s
e
/
m
e
d
i
a
这个目录下的资源,使用的方法是
r读取的是resources/base/media这个目录下的资源,使用的方法是
r读取的是resources/base/media这个目录下的资源,使用的方法是r(‘app.media.资源名’),这是固定的格式。
注意:这里是不需要带上文件后缀名的,例如这里加载startIcon.png,只需要写成app.media.startIcon即可,不要写成startIcon.png。
2.$rawfile
r
a
w
f
i
l
e
读取的是
r
e
s
o
u
r
c
e
s
/
r
a
w
f
i
l
e
目录下的资源,使用的方法是
rawfile读取的是resources/rawfile目录下的资源,使用的方法是
rawfile读取的是resources/rawfile目录下的资源,使用的方法是rawfile(‘资源名.后缀名’)。它跟
r
的区别是
r的区别是
r的区别是rawfile直接写文件即可,不过它需要带上文件后缀名。
2、图片属性
图片的属性也是非常的多,既有通用属性也有自带属性,这里介绍width属性。
使用width指定宽度的时候,可以使用字符串格式,例如width(‘100%’);也可以使用数字格式,例如width(250)。字符串格式比较好理解,而数字格式的需要说明一下,比如250并不是指250px,它有一个默认的单位叫vp虚拟像素,它不是屏幕像素,它会根据屏幕像素密度进行换算,确保同一个元素在不同设备上的视觉大小是统一的。
3.2.2 Text组件
Text组件文档:developer.huawei.com/consumer/cn…
1、限定词目录
限定词其实就是设备信息,例如设备所属的国家、系统语言、型号等等,把这些信息拿过来拼在一起作为目录名就是限定词目录。这里的en_US和zh_CN使用的是语言和国家,en_US就是英语英国,zh_CN就是中文中国。
我们在使用$r读取本地资源的时候,它会优先根据当前设备的信息,找到与之匹配的限定词目录去寻找资源,如果找不到才会去找base目录。Text读的文本内容其实读的是element目录下的string.json定义好的文本,app是固定前缀,string指的是string.json。这样我们可以根据不同的语言设置不同的文本。
注意:如果在限定词目录下定义了变量,那么一定要在base目录也定义相同的变量,否则会报错。
只在限定词目录下定义而没有在base目录下定义,它会弹出提示"该变量在默认配置没有找到"。
2、切换语言
在编辑器预览区里提供了一个切换语言的功能,便于我们测试在不同语言情况下的显示情况。
3.2.3 TextInput组件
TextInput组件文档:developer.huawei.com/consumer/cn…
这个TextInput组件其实就是我们常用UI组件里的Input输入框组件,不过一般UI库的Input组件只提供password类型,而TextInput还提供了Email、Number等其它类型,对于常用类型不需要我们去校验。
1、声明TextInput
TextInput({placeholder: '请输入图片宽度', text: '123'})
2、设置TextInput属性方法
TextInput({placeholder: '请输入图片宽度', text: '123'})
.width(150)
.backgroundColor('#ccc')
.type(InputType.Password)
.onChange(value => {
console.log(value)
})
注意:这里绑定onChange方法之后,如果在声明组件的时候传入了text属性,它第一次加载的时候会立即触发onChange方法。
3.2.4 Button组件
Button组件文档:developer.huawei.com/consumer/cn…
Button组件的使用比较简单,没有太多需要注意的点,只需要参考上述案例使用即可。
3.2.5 Slider组件
Slider组件文档:developer.huawei.com/consumer/cn…
3.3 ArkUI容器组件
在ArkUI里,最常用的容器组件当属Row与Column,顾名思义就是行和列的布局。熟悉前端的很容易会联想到它其实就是CSS3的flex布局。
主轴代表容器元素的排列方式,主轴与交叉轴共同影响着元素的对齐方式。
1、justifyContent:子元素在主轴的对齐方式
2、alignItems:子元素在交叉轴的对齐方式
注意:在设置justifyContent主轴对齐方式的时候,Row和Column用的都是FlexAlign的属性。而在设置alignItem交叉轴对齐方式的时候,两者是不同的,Row用的是VerticalAlign,而Column用的是HorizontalAlign。
其实这也比较好理解,对于Row行布局而言,交叉轴对它来说就是纵向对齐方式,所以它用VerticalAlign(vertical是垂直的意思);同理,Column的交叉轴就是横向对齐方式,所以它用HorizontalAlign(Horizontal是水平的意思)
3.4 ArkUI实现简单布局
这里做一个简单的案例,熟悉一下基础组件和容器组件在实战的使用。
1、基础组件的使用
这个案例中涉及到Image、Text、TextInput、Button和Slider这5个基础组件,我们先不考虑容器组件,把这些基础组件放上去看看整体效果。
@Entry
@Component
struct Index {
build() {
Column() {
Image($r('app.media.startIcon')).width(150)
Text($r('app.string.width_label'))
.fontSize(20)
.fontWeight(FontWeight.Bold)
TextInput({placeholder: '请输入图片宽度'})
.width(150)
.backgroundColor('#ccc')
.type(InputType.Number)
Button('缩小')
.width(80)
.fontSize(20)
Button('放大')
.width(80)
.fontSize(20)
Slider({
min: 100,
max: 300,
value: 150,
step: 10
})
.width('90%')
.blockColor('#36D')
.trackThickness(7)
.showTips(true)
}
.width('100%')
}
}
2、运用容器组件
(1)Image组件布局
目前这个图片是没有固定的高度,它的缩放直接影响其它元素的位置。我们可以给Image组件外部包裹一个Row组件,给它设置一个高度。
Column() {
Row() {
Image($r('app.media.startIcon')).width(150)
}.height(400)
......
}
这样无论图片是放大还是缩小,它的占位是固定的,不会影响其它元素的位置了。
(2)Text与TextInput组件布局
这两个组件应该是在同一行显示的,那就给它们俩套上Row组件,并且设置它的宽度、padding内边距以及对齐方式。
注意:这个padding和margin的用法,其实跟css是完全一致的,只是它用了方法去调用,传一个对象进去,用left、right、top、bottom键值对的方式来使用。
Column() {
Row() {
Image($r('app.media.startIcon')).width(this.imageWidth)
}
.height(400)
Row() {
Text($r('app.string.width_label'))
.fontSize(20)
.fontWeight(FontWeight.Bold)
TextInput({placeholder: '请输入图片宽度', text: this.imageWidth.toString()})
.width(150)
.backgroundColor('#fff')
.type(InputType.Number)
.onChange(value => {
this.imageWidth = parseInt(value)
})
}
.width('100%')
.padding({left: 14, right: 14})
.justifyContent(FlexAlign.SpaceBetween)
}
(3)Button组件布局
同理,这两个按钮是同一行的,也是套一个Row组件,不过它们俩是在一行之中均分的位置,设置justifyContent属性为FlexAlign.SpaceEvenly即可。
Column() {
Row() {
Image($r('app.media.startIcon')).width(this.imageWidth)
}
.height(400)
Row() {
Text($r('app.string.width_label'))
.fontSize(20)
.fontWeight(FontWeight.Bold)
TextInput({placeholder: '请输入图片宽度', text: this.imageWidth.toString()})
.width(150)
.backgroundColor('#fff')
.type(InputType.Number)
.onChange(value => {
this.imageWidth = parseInt(value)
})
}
.width('100%')
.padding({left: 14, right: 14})
.justifyContent(FlexAlign.SpaceBetween)
Row() {
Button('缩小')
.width(80)
.fontSize(20)
.onClick(() => {
if (this.imageWidth >= 10) {
this.imageWidth -= 10
}
})
Button('放大')
.width(80)
.fontSize(20)
.onClick(() => {
if (this.imageWidth <= 300) {
this.imageWidth += 10
}
})
}
.width('100%')
.justifyContent(FlexAlign.SpaceEvenly)
}
(4)样式优化
这里每个Row组件之间没有间距,可以通过设置Column组件的Space进行设置,当然也可以使用我们比较属性的margin属性进行边距设置。例如在Button组的Row组件设置margin外边距:
Row() {
Button('缩小')
.width(80)
.fontSize(20)
.onClick(() => {
if (this.imageWidth >= 10) {
this.imageWidth -= 10
}
})
Button('放大')
.width(80)
.fontSize(20)
.onClick(() => {
if (this.imageWidth <= 300) {
this.imageWidth += 10
}
})
}
.width('100%')
.margin({top: 35, bottom: 35})
.justifyContent(FlexAlign.SpaceEvenly)
写在最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)文档用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)文档包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习文档能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习文档
鸿蒙(HarmonyOS NEXT)5.0最新学习路线
有了路线图,怎么能没有学习文档呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习文档
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V3.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……
《鸿蒙开发进阶》
●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……
《鸿蒙进阶实战》
●ArkTS实践
●UIAbility应用
●网络案例
……