当前位置:   article > 正文

【HarmonyOS】掌握布局组件,提升应用体验_harmony的flex和row区别

harmony的flex和row区别

       从今天开始,博主将开设一门新的专栏用来讲解市面上比较热门的技术 “鸿蒙开发”,对于刚接触这项技术的小伙伴在学习鸿蒙开发之前,有必要先了解一下鸿蒙,从你的角度来讲,你认为什么是鸿蒙呢?它出现的意义又是什么?鸿蒙仅仅是一个手机操作系统吗?它的出现能够和Android和IOS三分天下吗?它未来的潜力能否制霸整个手机市场呢?

抱着这样的疑问和对鸿蒙开发的好奇,让我们开始今天对布局组件的掌握吧!

目录

布局组件

Column与Row组件(排列布局)

Stack组件(层叠布局)

Flex组件(弹性布局)

RelativeContainer组件(相对布局)

List组件(创建列表)

Grid组件(创建网格)


布局组件

在 ArkTS 中,布局组件是一种用于管理和布置其他组件的特殊组件。它们用于定义用户界面的结构和排列方式。以下是ArkTS的通用属性:

名称参数说明描述
widthLength设置组件自身的宽度
heightLength设置组件自身的高度
sizeLength设置高宽尺寸
paddingPadding | Length设置内边距属性
marginMargin | Length设置外边距属性
constraintSizeLength设置约束尺寸,组件布局时进行尺寸范围限制

Column与Row组件(排列布局)

Column与Row是鸿蒙开发中最最常用的布局组件,它们分别用于垂直和水平方向上的排列和布局子组件,下面是该两个组件的使用区别:

Column(列)

Column 组件将子组件在垂直方向上依次排列。子组件按照从上到下的顺序布局,每个子组件占据一行。Column 组件会根据子组件的大小自动调整自身的高度以适应内容。

Row(行)

Row 组件将子组件在水平方向上依次排列。子组件按照从左到右的顺序布局,每个子组件占据一列。Row 组件会根据子组件的大小自动调整自身的宽度以适应内容。

因此,Column 和 Row 的主要区别在于排列方向和布局方式。如果你想要在垂直方向上依次排列子组件,可以使用 Column 组件;如果你想要在水平方向上依次排列子组件,可以使用 Row 组件。以下是使用Column和Row的基本用法:

  1. @Entry
  2. @Component
  3. struct TEST {
  4. build() {
  5. Column({ space: 10 }){
  6. Row({ space: 10 }){
  7. Row(){
  8. }
  9. .width('33%')
  10. .height(160)
  11. .backgroundColor('red')
  12. .layoutWeight(1)
  13. Row(){
  14. }
  15. .width('33%')
  16. .height(160)
  17. .backgroundColor('green')
  18. .layoutWeight(1)
  19. Row(){
  20. }
  21. .width(100)
  22. .height(160)
  23. .backgroundColor('blue')
  24. }
  25. .width('100%')
  26. .height(160)
  27. Column({ space: 10 }){
  28. Row().width('100%').backgroundColor(Color.Gray).layoutWeight(1)
  29. Row().width('100%').backgroundColor(Color.Red).layoutWeight(2)
  30. }
  31. .width('100%')
  32. .height(160)
  33. }
  34. .width('100%')
  35. .height('100%')
  36. .justifyContent(FlexAlign.Center)
  37. }
  38. }

呈现的结果如下:

Stack组件(层叠布局)

层叠布局(StackLayout)用于在屏幕上预留一块区域来显示组件中的元素,提供元素可以重叠的布局。层叠布局通过Stack容器组件实现位置的固定定位与层叠,容器中的子元素(子组件)依次入栈,后一个子元素覆盖前一个子元素,子元素可以叠加,也可以设置位置。

层叠布局具有较强的页面层叠、位置定位能力,其使用场景有广告、卡片层叠效果等。如下:

Stack组件通过alignContent参数实现位置的相对移动。如下表所示,支持九种对齐方式:

名称

描述

TopStart

顶部起始端。

Top

顶部横向居中。

TopEnd

顶部尾端。

Start

起始端纵向居中。

Center

横向和纵向居中。

End

尾端纵向居中。

BottomStart

底部起始端。

Bottom

底部横向居中。

BottomEnd

底部尾端。

以下是借助Stack组件进行的案例,代码如下:

  1. @Entry
  2. @Component
  3. struct TEST {
  4. @State list: number[] = [1, 2, 3]
  5. build() {
  6. Column(){
  7. Stack({ alignContent: Alignment.BottomEnd }){
  8. Stack({ alignContent: Alignment.TopStart}){
  9. Column(){
  10. List({ space: 10 }){
  11. ForEach(this.list,(item)=>{
  12. ListItem(){
  13. Text(`${item}`)
  14. .fontSize(30)
  15. .width('100%')
  16. .backgroundColor('#eee').height(50).textAlign(TextAlign.Center)
  17. }
  18. })
  19. }
  20. .margin({ bottom: 70 })
  21. }
  22. .margin({ top: 60 })
  23. .height('100%')
  24. Row(){
  25. Text('HarmonyOS')
  26. .fontSize(30)
  27. .fontColor(Color.White)
  28. .width('100%')
  29. .textAlign(TextAlign.Center)
  30. }
  31. .width('100%')
  32. .backgroundColor(Color.Orange)
  33. .height(50)
  34. }
  35. Button(){
  36. Text('+').fontSize(40).fontColor(Color.White)
  37. }
  38. .width(80)
  39. .height(80)
  40. .onClick( ()=> {
  41. this.list.push(this.list[this.list.length - 1] + 1)
  42. })
  43. .margin({ right: 10, bottom: 10 })
  44. }
  45. }
  46. .width('100%')
  47. .height('100%')
  48. }
  49. }

最终呈现的结果如下:

Flex组件(弹性布局)

弹性布局(Flex)提供更加有效的方式对容器中的子元素进行排列、对齐和分配剩余空间。容器默认存在主轴与交叉轴,子元素默认沿主轴排列,子元素在主轴方向的尺寸称为主轴尺寸,在交叉轴方向的尺寸称为交叉轴尺寸。弹性布局在开发场景中用例特别多,比如页面头部导航栏的均匀分布、页面框架的搭建、多行数据的排列等等。

主轴:Flex组件布局方向的轴线,子元素默认沿着主轴排列。主轴开始的位置称为主轴起始点,结束位置称为主轴结束点。
交叉轴:垂直于主轴方向的轴线。交叉轴开始的位置称为交叉轴起始点,结束位置称为交叉轴结束点。

以下是flex常见的使用参数:

参数名参数类型必填默认值参数描述
directionFlexDirectionFlexDirection.Row主轴方向
wrapFlexWrapFlexWrap.NoWrap确认容器是单行/列还是多行
justifyContentFlexAlignFlexAlign.Start子组件在flex容器主轴上对齐格式
alignItemsItemAlignItemAlign.Start子组件在flex容器交叉轴上对齐格式
alignContentFlexAlignFlexAlign.Start多行内容的对齐格式。wrap多行下生效

以下是通过 FlexDirection 来更改方向的操作:

  1. @Entry
  2. @Component
  3. struct TEST {
  4. build() {
  5. Column({ space: 20 }){
  6. // 主轴为水平方向,子组件从起始端沿着水平方向开始排布。
  7. Flex({ direction: FlexDirection.Row }) {
  8. Text('1').width('33%').height(50).backgroundColor(0xF5DEB3)
  9. Text('2').width('33%').height(50).backgroundColor(0xD2B48C)
  10. Text('3').width('33%').height(50).backgroundColor(0xF5DEB3)
  11. }
  12. .height(70)
  13. .width('90%')
  14. .padding(10)
  15. .backgroundColor(0xAFEEEE)
  16. // 主轴为水平方向,子组件从终点端沿着FlexDirection. Row相反的方向开始排布。
  17. Flex({ direction: FlexDirection.RowReverse }) {
  18. Text('1').width('33%').height(50).backgroundColor(0xF5DEB3)
  19. Text('2').width('33%').height(50).backgroundColor(0xD2B48C)
  20. Text('3').width('33%').height(50).backgroundColor(0xF5DEB3)
  21. }
  22. .height(70)
  23. .width('90%')
  24. .padding(10)
  25. .backgroundColor(0xAFEEEE)
  26. // 主轴为垂直方向,子组件从起始端沿着垂直方向开始排布。
  27. Flex({ direction: FlexDirection.Column }) {
  28. Text('1').width('100%').height(50).backgroundColor(0xF5DEB3)
  29. Text('2').width('100%').height(50).backgroundColor(0xD2B48C)
  30. Text('3').width('100%').height(50).backgroundColor(0xF5DEB3)
  31. }
  32. .height(70)
  33. .width('90%')
  34. .padding(10)
  35. .backgroundColor(0xAFEEEE)
  36. // 主轴为垂直方向,子组件从终点端沿着FlexDirection. Column相反的方向开始排布。
  37. Flex({ direction: FlexDirection.ColumnReverse }) {
  38. Text('1').width('100%').height(50).backgroundColor(0xF5DEB3)
  39. Text('2').width('100%').height(50).backgroundColor(0xD2B48C)
  40. Text('3').width('100%').height(50).backgroundColor(0xF5DEB3)
  41. }
  42. .height(70)
  43. .width('90%')
  44. .padding(10)
  45. .backgroundColor(0xAFEEEE)
  46. }
  47. .width('100%')
  48. .height('100%')
  49. }
  50. }

最终呈现的结果如下:

当然弹性布局方面还有许多其他的操作,这里就不再赘述了,详情请参考 文档  

RelativeContainer组件(相对布局)

相对布局组件用于复杂场景中元素对齐的布局,支持容器内的子元素设置相对位置关系,子元素支持指定兄弟元素作为锚点,也支持指定父容器作为锚点,基于锚点做相对位置布局,下图表示相对布局的概念图,虚线表示位置的依赖关系:

通过以下的案例代码来学习相对布局的形成:

  1. @Entry
  2. @Component
  3. struct TEST {
  4. build() {
  5. Column(){
  6. // RelativeContainer必须包含子元素
  7. // RelativeContainer固定的id就是 __container__
  8. RelativeContainer(){
  9. // RelativeContainer里面的子元素必须配置id属性
  10. Text("1")
  11. .width(100)
  12. .height(100)
  13. .fontSize(30)
  14. .alignRules({ // 当前容器的属性
  15. right: {
  16. anchor: "__container__", // 锚点,传入容器id
  17. align: HorizontalAlign.End // 相对于锚点位置的布局
  18. }
  19. })
  20. .backgroundColor(Color.Blue)
  21. .id('test1')
  22. Text("2")
  23. .width(100)
  24. .height(100)
  25. .fontSize(30)
  26. .alignRules({ // 当前容器的属性
  27. middle: {
  28. anchor: "__container__", // 锚点,传入容器id
  29. align: HorizontalAlign.Center // 相对于锚点位置的布局
  30. }
  31. })
  32. .backgroundColor(Color.Orange)
  33. .id('test2')
  34. Text("3")
  35. .width(100)
  36. .height(100)
  37. .fontSize(30)
  38. .alignRules({ // 当前容器的属性
  39. bottom: {
  40. anchor: "__container__", // 锚点,传入容器id
  41. align: VerticalAlign.Bottom // 相对于锚点位置的布局
  42. },
  43. right: {
  44. anchor: "__container__", // 锚点,传入容器id
  45. align: HorizontalAlign.End // 相对于锚点位置的布局
  46. }
  47. })
  48. .backgroundColor(Color.Red)
  49. .id('test3')
  50. // 相对于 2 进行布局,使其在2的正上方
  51. Text("4")
  52. .width(100)
  53. .height(100)
  54. .fontSize(30)
  55. .alignRules({ // 当前容器的属性
  56. bottom: {
  57. anchor: "test2", // 锚点,传入容器id
  58. align: VerticalAlign.Top // 相对于锚点位置的布局
  59. },
  60. left: {
  61. anchor: "test2", // 锚点,传入容器id
  62. align: HorizontalAlign.Start // 相对于锚点位置的布局
  63. }
  64. })
  65. .backgroundColor(Color.Green)
  66. .id('test4')
  67. .offset({ // 微调位置
  68. y: -20,
  69. x: 0
  70. })
  71. }
  72. .width(300)
  73. .height(300)
  74. .border({
  75. width: 1,
  76. color: Color.Red
  77. })
  78. }
  79. .width('100%')
  80. .height('100%')
  81. .justifyContent(FlexAlign.Center)
  82. }
  83. }

最终呈现的结果如下:

List组件(创建列表)

列表是一种复杂的容器,当列表项达到一定数量,内容超过屏幕大小时,可以自动提供滚动功能。它适合用于呈现同类数据类型或数据类型集,例如图片和文本。在列表中显示数据集合是许多应用程序中的常见要求(如通讯录、音乐列表、购物清单等)。其主要使用的参数如下:

参数名

参数类型

必填

参数描述

space

number | string

子组件主轴方向的间隔。

initialIndex

number

设置当前List初次加载时视口起始位置显示的item的索引值。

scroller

Scroller

可滚动组件的控制器。用于与可滚动组件进行绑定。

以下是使用List组件的案例:

  1. @Entry
  2. @Component
  3. struct TEST {
  4. list: number[] = [1, 2, 3, 4, 5, 6, 7]
  5. build() {
  6. Column(){
  7. List({ space: 20 }){
  8. ForEach(this.list,(item) => {
  9. ListItem(){
  10. Text(`${item}`)
  11. .textAlign(TextAlign.Center)
  12. .width('100%')
  13. .height(100)
  14. .fontSize(30)
  15. }
  16. .backgroundColor(0xffffff)
  17. })
  18. }
  19. .listDirection(Axis.Vertical) // 配置list显示方向
  20. .scrollBar(BarState.Auto) // 显示滚动条
  21. .padding(10)
  22. .divider({
  23. strokeWidth: 5,
  24. color: Color.Red,
  25. startMargin: 20,
  26. endMargin: 20
  27. })
  28. }
  29. .backgroundColor('#cccccc')
  30. .width('100%')
  31. .height('100%')
  32. }
  33. }

最终呈现的效果如下:

Grid组件(创建网格)

网格布局是由“行”和“列”分割的单元格所组成,通过指定“项目”所在的单元格做出各种各样的布局。网格布局具有较强的页面均分能力,子组件占比控制能力,是一种重要自适应布局,其使用场景有九宫格图片展示、日历、计算器等。

名称描述名称描述
columnsTemplate设置当前网格布局列的数量rowsTemplate设置当前网格布局行的数量
columnsGap设置列与列的间距。rowsGap设置行与行的间距。
scrollBar设置滚动条状态。scrollBarColor设置滚动条的颜色。
scrollBarWidth设置滚动条的宽度。cachedCount设置预加载的GridItem的数量,只在LazyForEach中生效。
editMode设置Grid是否进入编辑模式layoutDirection设置布局的主轴方向。
minCount示可显示的最小行/列数。cellLength表示一行的高度/一列的宽度
multiSelectable是否开启鼠标框选。supportAnimation是否支持动画。

基础按钮如下:

  1. @Entry
  2. @Component
  3. struct TEST {
  4. build() {
  5. Column(){
  6. Grid(){
  7. GridItem(){
  8. Text("1")
  9. .fontSize(16).fontColor(Color.White).backgroundColor('red')
  10. .width('100%').height('100%').textAlign(TextAlign.Center)
  11. }
  12. .rowStart(1)
  13. .rowEnd(2)
  14. GridItem(){
  15. Text("2")
  16. .fontSize(16).fontColor(Color.White).backgroundColor('red')
  17. .width('100%').height('100%').textAlign(TextAlign.Center)
  18. }
  19. .columnStart(2)
  20. .columnEnd(3)
  21. GridItem(){
  22. Text("3")
  23. .fontSize(16).fontColor(Color.White).backgroundColor('red')
  24. .width('100%').height('100%').textAlign(TextAlign.Center)
  25. }
  26. GridItem(){
  27. Text("4")
  28. .fontSize(16).fontColor(Color.White).backgroundColor('red')
  29. .width('100%').height('100%').textAlign(TextAlign.Center)
  30. }
  31. GridItem(){
  32. Text("5")
  33. .fontSize(16).fontColor(Color.White).backgroundColor('red')
  34. .width('100%').height('100%').textAlign(TextAlign.Center)
  35. }
  36. GridItem(){
  37. Text("6")
  38. .fontSize(16).fontColor(Color.White).backgroundColor('red')
  39. .width('100%').height('100%').textAlign(TextAlign.Center)
  40. }
  41. .columnStart(2)
  42. .columnEnd(3)
  43. }
  44. .columnsTemplate('1fr 1fr 1fr') // 显示3列
  45. .columnsGap(10)
  46. .rowsTemplate('1fr 2fr 1fr') // 显示3行 ,第二行宽度占总宽度二分之一
  47. .rowsGap(10)
  48. .height(300)
  49. }
  50. }
  51. }

呈现的效果如下所示:

本文内容由网友自发贡献,转载请注明出处:【wpsshop博客】
推荐阅读
相关标签
  

闽ICP备14008679号