0
0

harmonyOS基础（三）- 快速弄懂HarmonyOS ArkTs基础组件、布局容器（前端视角篇）

大家好！我是黑臂麒麟，一位6年的前端；
随着

鸿蒙4.0

的发布。鸿蒙社区不断壮大，且市场对

harmonyOS

应用认可度越来越高。很多公司开始对

鸿蒙应用开发

越来越重视。
之前想入坑鸿蒙，一直犹豫未下定决心学习。这次不再等待，开始系统学习起来。
此系列文章只做

harmonyOS

学习记录，大家如有兴趣，希望文章对您有所帮助；

if you’re change the world, you’re workingon important things. you’re excited to get up in the norning.

一、常用基础组件

1.基础组件

简单列举常用的及含义，掌握了以下按钮可以解决日常简单场景需求。其他在使用时查询

ArkTS

的API文档即可。
组件含义Text()显示一段文本的组件。Image()图片组件，支持本地图片和网络图片的渲染展示TextInput()单行文本输入框组件。Button()按钮Blank空白填充组件，在容器主轴方向上，空白填充组件具有自动填充容器空余部分的能力。仅当父组件为Row/Column时生效。LoadingProgress显示加载进展…

2.文本样式

ArkTS

的样式以驼峰命名方式，这里以

Text

组件为例：
名称参数类型描述fontColorResourceColor设置文本颜色fontSizeLength or Resource设置文本颜色fontStyleFontStyle设置文本的字体样式。默认值：FontStyle.Normal。fontWeightnumbe or FontWeight or string设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。string类型仅支持number类型取值的字符串形式，例如“400”，以及“bold”、“bolder”、“lighter”、“regular”、“medium”，分别对应FontWeight中相应的枚举值。默认值：FontWeight.Normal。
下面代码是两个Text组件，分别是默认样式和设置了文本样式的对比。

@Entry@Component
struct Index {@State message:string='Hello World';@State myText:string='World';build(){Row(){Column(){Text('ArkTs')Text('ArkTs').fontColor(Color.Blue).fontSize(40).fontWeight(FontWeight.Bold).fontFamily('Arial')}}.justifyContent(FlexAlign.Center).backgroundColor(0xF1F3F5).width('100%').height('100%')}}

在这里插入图片描述
以上ArkTs代码的样式使用

驼峰格式

；其他组件的样式也是一样。使用时查阅具体用法。

3.Image

这里着重说一下Image的图片地址的

引入方式

，方式如下：

Image(src: string|PixelMap|Resource)

(1).使用string数据加载网络图片

Image(‘https://www.example.com/xxx.png’)

这里要注意

Image

在使用网络图片的时候，需要要在

module.json5

文件中声明网络访问权限

// module.json5{"module":{"requestPermissions":["name":"ohos.permisssion.INTERNET"]}}

(2).使用

PixelMap

数据加载图片

Image(pixelMapObject)

(3)使用Resource数据加载图片

Image($r('app.media.logo'))

上面的Resource是一种资源引入类型。会在下面详细描述。

4.使用资源引用类型

Resource

是资源引用类型，用于设置组件属性的值。

ArkTs文档推荐优先使用Resource类型

，将资源文件（字符串、图片、音频等）统一存放于

resources

目录下，便于开发者统一维护。同事系统可以根据当前配置加载合适资源，例如，开发者根据屏幕尺寸呈现不同的布局效果，或根据语言提供不同的字符串。
已上面Text组件代码为例：

Text('ArkTs').fontColor(Color.Blue).fontSize(40).fontWeight(FontWeight.Bold).fontFamily('Arial')

(1).对元素内文本字符串的管理；

可以将这些编码写到entry/src/main/resources下的资源文件中。
在这里插入图片描述
在string.json中定义Button显示的文本
在这里插入图片描述
就个人而言，不太喜欢这种方式相对于前端喜欢而言。
在

float.json

中定义

Text

的字体样式。
在这里插入图片描述
在color.json中定义Text的字体颜色。
在这里插入图片描述
然后再Text组件通过

$r('app.type.name)

的形式引用应用资源。app带表应用内resources目录中定义的资源；

type

代表资源类型（或资源的存放位置），可以取“color”，“float”、“string”、“plural”、“media”; 以上几种是固定的，不支持自定义命名文件引用。name代表资源命名，由开发者定义资源时确定的。

Text($r('app.string.Index_Text')).fontColor($r('app.color.Text_color')).fontSize($r('app.float.Text_fontSize')).fontWeight(FontWeight.Bold).fontFamily($r('app.float.Text_fontFamily'))

以上是简单的描述

Resource

引用方式，后面回单独出一期深入研究的

Resource

引入文章。

二、布局组件

前端常用布局方式

header、side、main、footer

等标签，还有布局样式

flex

、

grid

等，在

ArkTs

常用布局组件有一下几种：
组件描述Column垂直方向布局的容器Row水平方向布局的容器List列表容器Grid网格容器Tabs页签容器Swiper滑块视图容器Scroll可滑动的容器
这里说一下

List

，

Grid

，

Tabs

，

Column

、

Row

使用方法，Swiper、Scroll布局组件相对简单详见Api文档。有点类似小程序的类似组件。

1. Column&Row

布局容器概念

线性布局容器表示垂直方向或者水平方向排列子组件的容器，

ArkTs

提供了

Column

和

Row

容器来实现线性布局。

主轴和交叉轴概念

在布局容器中，默认存在两根轴，分别是主轴和交叉轴，这两个轴始终是相互垂直的。不同的容器中主轴的方向不一样的。

  • 主轴：在Column容器中的子组件是按照从上到下的垂直方向布局，其主轴的方向是垂直方向；在Row容器中的组件时按照从左到右的水平方向布局的，其主轴的方向时水平方向。 下图时Column&Row容器交叉轴在这里插入图片描述

属性

Column&Row容器的两个属性justifyContent和alignItems，类似CSS的flex或Grid的justify-content和align-item。这样容易让我们前端快速理解。
这里注意一下它们的属性值都要

首字母大写

。
属性名称描述justifyContent设置子组件在主轴方向上的对齐格式alignItems设置子组件在交叉轴方向上的对齐格式

主轴方向的对其（justifyContent）

子组件在主轴方向上的使用

jusifyContent

属性来设置，其参数类型时

FlexAlign

。它有一下几种类型：
属性值描述Start主轴方向首端对齐，第一个元素与行首对齐，同时后续的元素与前一个对齐Center主轴方向中心对齐，第一个元素与行首的距离以及最后一个元素与行尾距离相同End主轴方向尾部对齐，最后一个元素与行尾对齐，其他元素与后一个对齐SpaceBetween主轴方向均匀分配弹性元素，相邻元素之间距离相同。 第一个元素与行首对齐，最后一个元素与行尾对齐SpaceAround轴方向均匀分配弹性元素，相邻元素之间距离相同。 第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半SpaceEvenly主轴方向等间距布局，无论是相邻元素还是边界元素到容器的间距都一样

  • Start在这里插入图片描述
  • Center在这里插入图片描述
  • End在这里插入图片描述
  • SpaceBetween在这里插入图片描述
  • SpaceAround在这里插入图片描述
  • SpaceEvenly在这里插入图片描述
交叉中方向对齐（alignItems）

Column容器的主轴时垂直方向，交叉轴是水平方向，其参数类型为

HorizontalAlign

（水平对齐），

HorizontalAlign

定义了一下几个类型；
属性值描述Start水平方向上按照起始端对齐Center水平方向上居中对齐End水平方向上按照末端对齐

  • start在这里插入图片描述
  • Centent在这里插入图片描述
  • End在这里插入图片描述 Row容器的主轴是水平方向，交叉轴是垂直方向，其参数类型为VerticalAlign（垂直对其），VerticalAlign定义了一下几种类型： |属性值|描述| |–|–| |Top|垂直方向上居顶部对齐| |Center|竖直方向上居中对齐| |Bottom|竖直方向上居底部对齐|
  • Top在这里插入图片描述
  • Center在这里插入图片描述
  • Bottom在这里插入图片描述

接口介绍

Column&Row都课接收一个参数

space

，表示子组件在主轴上的间距；

@Entry@Component
struct Index {@State TextArr:Array<string>=["Image","Text","TextInput","Button"]build(){Column({space:30}){// 这里设置子元素主轴上的间距ForEach(this.TextArr,(item:string)=>{// 利用ForEach渲染我们的字符串数组Row(){Text(item)}.width('80%').height('100vp').backgroundColor('#99b2df').border({
          width:5,
          color:'#8aa7da',
          style: BorderStyle.Solid
        }).justifyContent(FlexAlign.Center)})}.justifyContent(FlexAlign.Start).backgroundColor('#bdd7ee').width('100%').height('100%')}}

渲染出来的效果：
在这里插入图片描述

3. List使用

简介

使用频率很高的组件，需要配合

ListItem

子组件一起使用，列表每项对应一个

ListItem

组件
在这里插入图片描述

使用ForEach渲染

渲染多时，可以使用ForEach来循环渲染我们的列表项；

@Entry@Component
struct Index {private arr:number[]=[0,1,2,3,4,5,6,7,8,9]build(){Column({space:30}){List({space:10}){ForEach(this.arr,(item:number)=>{ListItem(){Text(`${item}`).width('100%').height(100).fontSize(20).fontColor(Color.White).textAlign(TextAlign.Center).backgroundColor(0x007DFF)}}, item => item)}}.padding(12).height('100%').backgroundColor(0xF1F3F5)}}

在这里插入图片描述

设置分割线

这里如有需求可以给list组件可以使用

divider

属性给

ListItem

设置分割线。有四个参数：

  • strokeWidth: 分割线宽度
  • color: 分割线颜色
  • startMargin: 分割线距离列表起始端的距离
  • endMargin: 分割线距离列表结束端的距离
List({space:50}){ForEach(this.arr,(item:number)=>{ListItem(){Text(`${item}`)}}, item => item)}.divider({
  strokeWidth:5,
  color:'#d8d8d8',
  startMargin:20,
  endMargin:20,})

在这里插入图片描述

列表滚动事件监听

List滚动监听事件和前端监听Scroll监听时间方法很像：

  • onScroll: 滑动触发，返回scrollOffset为滑动偏移量，scrollState为当前滑动状态。
  • onScrollIndex: 滑动时触发，分别返回滑动起始索引值与滑动结束索引值。
  • onReachStart: 列表到达起始位置时触发。
  • onReachEnd: 列表到底末尾位置触发。
  • onScrollStrop: 列表滑动结束时触发。在这里插入图片描述 利用这些时间监听，并可以在log面板中打印出我们想要的滑动数据；

设置List排列方向

List

组件排列可以垂直方向和水平方向排列，默认是垂直方向排列。如果想设置

List

为水平方向，可以使用

listDiretion

属性为Axis.Horizontal即可。

4. Grid

简介

如果前端学过css的grid布局模式，那大家一定不会对

Grid

组件布局陌生，接下来学习如何使用

Grid

网格布局组件。

使用

Grid

组件是由“行”和“列”分割的单元格组成。

Grid

一般和

GridItem

一起使用。

@Entry@Component
struct GridPage {private arr:string[]=newArray(9).fill('').map((_, index)=>`item ${index +1}`)build(){Column(){Grid(){ForEach(this.arr,(item:string)=>{GridItem(){Text(item).fontSize(16).fontColor(Color.White).backgroundColor(0x007DFF).width('100%').height('100%').textAlign(TextAlign.Center)}},(item:string)=> item)}.columnsTemplate('1fr 1fr 1fr').rowsTemplate('1fr 1fr 1fr').columnsGap(10).rowsGap(10).height(300)}.width('100%').padding(12).backgroundColor(0xF1F3F5)}}

在这里插入图片描述
这里我们同样跟List一样使用

ForEach

遍历出的数组，可以看到我们设置

columnsTemplate

属性垂直方向配置3等分个

1fr

，同样纵向

rowsTemplate

也是3等分的

1fr

，

1fr

代表所占Grid等分个数。

columnGap

和

rowGap

分别设置垂直和纵向元素之间的间距。这里分别设置了 

10vp

。

5. Tabs

概述

Tabs

是我们常用的做视图切换的常用布局组件。如“底部页签”，“顶部标签”，平板的“侧边页签”等。

使用

Tabs

组件仅含子组件TabContent，每一个页签对应内容视图即TabContent组件。
结合之前我们写的

List

和

Grid

的组件，我们编写一个简单的

Tabs

布局

import Home from'../view/Home';import GridPage from'../view/GridPage'@Entry@Component
struct Index {private controller: TabsController =newTabsController();build(){Column(){Tabs(){TabContent(){Home()}.tabBar('List')TabContent(){GridPage()}.tabBar('Grid')}.barWidth('100%')// 设置TabBar宽度.barHeight('60')// 设置TabBar高度.width('100%').height('100%').backgroundColor(0xF5F5F5)}.width('100%').height('100%')}}

展示后的效果
在这里插入图片描述
在这里插入图片描述
上面代码，通过属性

width

和

height

设置了

Tabs

组件的宽高，使用

TabWidth

和

BarHeight

设置了

TabBar

的宽度和高度。
在这里插入图片描述

设置TabBar布局属性

Tabs

布局模式默认Fixed的，不支持滑动。如果页签过多会可能导致显示不全，讲布局模式设置为Scrollable的话，可以实现页签的滚动。
布局属性描述属性值barModeTabs的布局模式BarMode.Fixed （默认）:所有TabBar平均分配barWidth宽度。
BarMode.Scrollable: 每个TabBar使用实际宽度，超过总长度后可滑动。barPosition设置TabBar位置和排列方向BarPosition.Start，vertical属性为false（默认值）时，页签在顶部.vertical属性为true时，位于容器左侧。
BarPosition.End， vertical属性为false时，位于容器底部。vertical属性为true时，位于容器右侧。

自定义TabBar样式

如果需要自定义

TabBar

， 需要通过@Builder装饰器的函数。构造一个生成自定义TabBar样式的函数，我们来实现上面底部页签效果：

import Home from'../view/Home';import GridPage from'../view/GridPage'@Entry@Component
struct Index {private tabsController: TabsController =newTabsController();@State currentIndex:number=0;@BuilderTabBuilder(title:string, targetIndex:number, selectedImg: Resource, normalImg: Resource){Column(){Image(this.currentIndex === targetIndex ? selectedImg : normalImg).size({width:25, height:25})Text(title).fontColor(this.currentIndex === targetIndex ?'#1698CE':'#6B6B6B')}.width('100%').height(50).justifyContent(FlexAlign.Center).onClick(()=>{this.currentIndex = targetIndex;this.tabsController.changeIndex(this.currentIndex);})}build(){Column(){Tabs({barPosition: BarPosition.End, controller:this.tabsController}){TabContent(){Home()}.tabBar(this.TabBuilder('List',0,$r('app.media.home_selected'),$r('app.media.home_normal')))TabContent(){GridPage()}.tabBar(this.TabBuilder('List',1,$r('app.media.mine_selected'),$r('app.media.mine_normal')))}.vertical(false).barWidth("100%")// 设置TabBar宽度.barHeight(60)// 设置TabBar高度.width('100%').height('100%').backgroundColor(0xF5F5F5).onChange((index:number)=>{this.currentIndex = index;})}.width('100%').height('100%')}}

渲染后效果：
在这里插入图片描述
将

barPosition

的值设置为

BarPosition.End

，使页签显示在底部。使用@Builder自定义TabBuilder函数，生成由Image和Text组成的页签。同时也给

Tabs

组件设置了

TabsController

控制器，当点击某个页签时，调用

changeIndex

方法进行页签内容切换。
最后在Tabs添加onChange事件。切换时，把当前最近

Index

赋给currentIndex保存起来。

参考

华为开发者联盟官网开发者基础课程

结语

至此，本篇文章的内容结束了。文章有不对或不完整的地方，望多指点；
望更多小伙伴们加入harmonyOS开发大家庭，壮大生态圈，让鸿蒙更强大更好。
如果对你学习有所帮助，还请点赞、评论、收藏、关注、分享；
希望可爱你动动小手关注订阅，一起进步期待你的三连支持；

标签： harmonyos 前端 华为
本文转载自: https://blog.csdn.net/m0_37170006/article/details/134847442
版权归原作者 黑臂麒麟 所有， 如有侵权，请联系我们删除。
登录后发布评论

“harmonyOS基础（三）- 快速弄懂HarmonyOS ArkTs基础组件、布局容器（前端视角篇）”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

机器人技术在安全领域的重要作用

安全学习记录——网络篇（一）

图腾柱PFC：HP1010为您的电动两轮车之旅提供绿色，高效，安全的动力

单元测试数据库回滚问题

这才是单元测试，之前我们都错了

【C语言基础】：字符函数和字符串函数

ChatGPT-Next-Web SSRF漏洞+XSS漏洞复现(CVE-2023-49785)

文章导航