codecamp

线性布局（Row/Column）

概述

线性布局（LinearLayout）是开发中最常用的布局，通过线性容器Row和Column构建。线性布局是其他布局的基础，其子元素在线性方向上（水平方向和垂直方向）依次排列。线性布局的排列方向由所选容器组件决定，Column容器内子元素按照垂直方向排列，Row容器内子元素按照水平方向排列。根据不同的排列方向，开发者可选择使用Row或Column容器创建线性布局。

图1 Column容器内子元素排列示意图
图2 Row容器内子元素排列示意图

基本概念

  • 布局容器：具有布局能力的容器组件，可以承载其他元素作为其子元素，布局容器会对其子元素进行尺寸计算和布局排列。
  • 布局子元素：布局容器内部的元素。
  • 主轴：线性布局容器在布局方向上的轴线，子元素默认沿主轴排列。Row容器主轴为水平方向，Column容器主轴为垂直方向。
  • 交叉轴：垂直于主轴方向的轴线。Row容器交叉轴为垂直方向，Column容器交叉轴为水平方向。
  • 间距：布局子元素的间距。

布局子元素在排列方向上的间距

在布局容器内，可以通过space属性设置排列方向上子元素的间距，使各子元素在排列方向上有等间距效果。

Column容器内排列方向上的间距

图3 Column容器内排列方向的间距图
  1. Column({ space: 20 }) {
  2.   Text('space: 20').fontSize(15).fontColor(Color.Gray).width('90%')
  3.   Row().width('90%').height(50).backgroundColor(0xF5DEB3)
  4.   Row().width('90%').height(50).backgroundColor(0xD2B48C)
  5.   Row().width('90%').height(50).backgroundColor(0xF5DEB3)
  6. }.width('100%')

Row容器内排列方向上的间距

图4 Row容器内排列方向的间距图
  1. Row({ space: 35 }) {
  2.   Text('space: 35').fontSize(15).fontColor(Color.Gray)
  3.   Row().width('10%').height(150).backgroundColor(0xF5DEB3)
  4.   Row().width('10%').height(150).backgroundColor(0xD2B48C)
  5.   Row().width('10%').height(150).backgroundColor(0xF5DEB3)
  6. }.width('90%')

布局子元素在交叉轴上的对齐方式

在布局容器内，可以通过alignItems属性设置子元素在交叉轴（排列方向的垂直方向）上的对齐方式。且在各类尺寸屏幕中，表现一致。其中，交叉轴为垂直方向时，取值为VerticalAlign类型，水平方向取值为HorizontalAlign。

alignSelf属性用于控制单个子元素在容器交叉轴上的对齐方式，其优先级高于alignItems属性，如果设置了alignSelf属性，则在单个子元素上会覆盖alignItems属性。

Column容器内子元素在水平方向上的排列

图5 Column容器内子元素在水平方向上的排列图
  • HorizontalAlign.Start：子元素在水平方向左对齐。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').alignItems(HorizontalAlign.Start).backgroundColor('rgb(242,242,242)')

  • HorizontalAlign.Center：子元素在水平方向居中对齐。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').alignItems(HorizontalAlign.Center).backgroundColor('rgb(242,242,242)')

  • HorizontalAlign.End：子元素在水平方向右对齐。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').alignItems(HorizontalAlign.End).backgroundColor('rgb(242,242,242)')

Row容器内子元素在垂直方向上的排列

图6 Row容器内子元素在垂直方向上的排列图
  • VerticalAlign.Top：子元素在垂直方向顶部对齐。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).alignItems(VerticalAlign.Top).backgroundColor('rgb(242,242,242)')

  • VerticalAlign.Center：子元素在垂直方向居中对齐。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).alignItems(VerticalAlign.Center).backgroundColor('rgb(242,242,242)')

  • VerticalAlign.Bottom：子元素在垂直方向底部对齐。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).alignItems(VerticalAlign.Bottom).backgroundColor('rgb(242,242,242)')

布局子元素在主轴上的排列方式

在布局容器内，可以通过justifyContent属性设置子元素在容器主轴上的排列方式。可以从主轴起始位置开始排布，也可以从主轴结束位置开始排布，或者均匀分割主轴的空间。

Column容器内子元素在垂直方向上的排列

图7 Column容器内子元素在垂直方向上的排列图
  • justifyContent(FlexAlign.Start)：元素在垂直方向首端对齐，第一个元素与行首对齐，同时后续的元素与前一个对齐。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(300).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.Start)

  • justifyContent(FlexAlign.Center)：元素在垂直方向中心对齐，第一个元素与行首的距离与最后一个元素与行尾距离相同。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(300).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.Center)

  • justifyContent(FlexAlign.End)：元素在垂直方向尾部对齐，最后一个元素与行尾对齐，其他元素与后一个对齐。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(300).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.End)

  • justifyContent(FlexAlign.Spacebetween)：垂直方向均匀分配元素，相邻元素之间距离相同。第一个元素与行首对齐，最后一个元素与行尾对齐。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(300).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.SpaceBetween)

  • justifyContent(FlexAlign.SpaceAround)：垂直方向均匀分配元素，相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(300).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.SpaceAround)

  • justifyContent(FlexAlign.SpaceEvenly)：垂直方向均匀分配元素，相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。
    1. Column({}) {
    2.   Column() {
    3.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('80%').height(50).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('80%').height(50).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(300).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.SpaceEvenly)

Row容器内子元素在水平方向上的排列

图8 Row容器内子元素在水平方向上的排列图
  • justifyContent(FlexAlign.Start)：元素在水平方向方向首端对齐，第一个元素与行首对齐，同时后续的元素与前一个对齐。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.Start)

  • justifyContent(FlexAlign.Center)：元素在水平方向方向中心对齐，第一个元素与行首的距离与最后一个元素与行尾距离相同。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.Center)

  • justifyContent(FlexAlign.End)：元素在水平方向方向尾部对齐，最后一个元素与行尾对齐，其他元素与后一个对齐。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.End)

  • justifyContent(FlexAlign.Spacebetween)：水平方向方向均匀分配元素，相邻元素之间距离相同。第一个元素与行首对齐，最后一个元素与行尾对齐。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.SpaceBetween)

  • justifyContent(FlexAlign.SpaceAround)：水平方向方向均匀分配元素，相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.SpaceAround)

  • justifyContent(FlexAlign.SpaceEvenly)：水平方向方向均匀分配元素，相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。
    1. Row({}) {
    2.   Column() {
    3.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    4. 

    5.   Column() {
    6.   }.width('20%').height(30).backgroundColor(0xD2B48C)
    7. 

    8.   Column() {
    9.   }.width('20%').height(30).backgroundColor(0xF5DEB3)
    10. }.width('100%').height(200).backgroundColor('rgb(242,242,242)').justifyContent(FlexAlign.SpaceEvenly)

自适应拉伸

在线性布局下，常用空白填充组件Blank，在容器主轴方向自动填充空白空间，达到自适应拉伸效果。Row和Column作为容器，只需要添加宽高为百分比，当屏幕宽高发生变化时，会产生自适应效果。

  1. @Entry
  2. @Component
  3. struct BlankExample {
  4.   build() {
  5.     Column() {
  6.       Row() {
  7.         Text('Bluetooth').fontSize(18)
  8.         Blank()
  9.         Toggle({ type: ToggleType.Switch, isOn: true })
  10.       }.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }).width('100%')
  11.     }.backgroundColor(0xEFEFEF).padding(20).width('100%')
  12.   }
  13. }
图9 竖屏
图10 横屏

自适应缩放

自适应缩放是指子组件随容器尺寸的变化而按照预设的比例自动调整尺寸，适应各种不同大小的设备。在线性布局中，可以使用以下两种方法实现自适应缩放。

  • 父容器尺寸确定时，使用layoutWeight属性设置子组件和兄弟元素在主轴上的权重，忽略元素本身尺寸设置，使它们在任意尺寸的设备下自适应占满剩余空间。
    1. @Entry
    2. @Component
    3. struct layoutWeightExample {
    4.   build() {
    5.     Column() {
    6.       Text('1:2:3').width('100%')
    7.       Row() {
    8.         Column() {
    9.           Text('layoutWeight(1)')
    10.             .textAlign(TextAlign.Center)
    11.         }.layoutWeight(1).backgroundColor(0xF5DEB3).height('100%')
    12. 

    13.         Column() {
    14.           Text('layoutWeight(2)')
    15.             .textAlign(TextAlign.Center)
    16.         }.layoutWeight(2).backgroundColor(0xD2B48C).height('100%')
    17. 

    18.         Column() {
    19.           Text('layoutWeight(3)')
    20.             .textAlign(TextAlign.Center)
    21.         }.layoutWeight(3).backgroundColor(0xF5DEB3).height('100%')
    22. 

    23.       }.backgroundColor(0xffd306).height('30%')
    24. 

    25.       Text('2:5:3').width('100%')
    26.       Row() {
    27.         Column() {
    28.           Text('layoutWeight(2)')
    29.             .textAlign(TextAlign.Center)
    30.         }.layoutWeight(2).backgroundColor(0xF5DEB3).height('100%')
    31. 

    32.         Column() {
    33.           Text('layoutWeight(5)')
    34.             .textAlign(TextAlign.Center)
    35.         }.layoutWeight(5).backgroundColor(0xD2B48C).height('100%')
    36. 

    37.         Column() {
    38.           Text('layoutWeight(3)')
    39.             .textAlign(TextAlign.Center)
    40.         }.layoutWeight(3).backgroundColor(0xF5DEB3).height('100%')
    41.       }.backgroundColor(0xffd306).height('30%')
    42.     }
    43.   }
    44. }
    图11 横屏

    图12 竖屏

  • 父容器尺寸确定时，使用百分比设置子组件和兄弟元素的宽度，使他们在任意尺寸的设备下保持固定的自适应占比。
    1. @Entry
    2. @Component
    3. struct WidthExample {
    4.   build() {
    5.     Column() {
    6.       Row() {
    7.         Column() {
    8.           Text('left width 20%')
    9.             .textAlign(TextAlign.Center)
    10.         }.width('20%').backgroundColor(0xF5DEB3).height('100%')
    11. 

    12.         Column() {
    13.           Text('center width 50%')
    14.             .textAlign(TextAlign.Center)
    15.         }.width('50%').backgroundColor(0xD2B48C).height('100%')
    16. 

    17.         Column() {
    18.           Text('right width 30%')
    19.             .textAlign(TextAlign.Center)
    20.         }.width('30%').backgroundColor(0xF5DEB3).height('100%')
    21.       }.backgroundColor(0xffd306).height('30%')
    22.     }
    23.   }
    24. }
    图13 横屏
    图14 竖屏

自适应延伸

自适应延伸是指在不同尺寸设备下，当页面的内容超出屏幕大小而无法完全显示时，可以通过滚动条进行拖动展示。这种方法适用于线性布局中内容无法一屏展示的场景。通常有以下两种实现方式。

  • 在List中添加滚动条：当List子项过多一屏放不下时，可以将每一项子元素放置在不同的组件中，通过滚动条进行拖动展示。可以通过scrollBar属性设置滚动条的常驻状态，edgeEffect属性设置拖动到内容最末端的回弹效果。
  • 使用Scroll组件：在线性布局中，开发者可以进行垂直方向或者水平方向的布局。当一屏无法完全显示时，可以在Column或Row组件的外层包裹一个可滚动的容器组件Scroll来实现可滑动的线性布局。
    垂直方向布局中使用Scroll组件：
    1. @Entry
    2. @Component
    3. struct ScrollExample {
    4.   scroller: Scroller = new Scroller();
    5.   private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
    6. 

    7.   build() {
    8.     Scroll(this.scroller) {
    9.       Column() {
    10.         ForEach(this.arr, (item) => {
    11.           Text(item.toString())
    12.             .width('90%')
    13.             .height(150)
    14.             .backgroundColor(0xFFFFFF)
    15.             .borderRadius(15)
    16.             .fontSize(16)
    17.             .textAlign(TextAlign.Center)
    18.             .margin({ top: 10 })
    19.         }, item => item)
    20.       }.width('100%')
    21.     }
    22.     .backgroundColor(0xDCDCDC)
    23.     .scrollable(ScrollDirection.Vertical) // 滚动方向为垂直方向
    24.     .scrollBar(BarState.On) // 滚动条常驻显示
    25.     .scrollBarColor(Color.Gray) // 滚动条颜色
    26.     .scrollBarWidth(10) // 滚动条宽度
    27.     .edgeEffect(EdgeEffect.Spring) // 滚动到边沿后回弹
    28.   }
    29. }

    水平方向布局中使用Scroll组件：

    1. @Entry
    2. @Component
    3. struct ScrollExample {
    4.   scroller: Scroller = new Scroller();
    5.   private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
    6. 

    7.   build() {
    8.     Scroll(this.scroller) {
    9.       Row() {
    10.         ForEach(this.arr, (item) => {
    11.           Text(item.toString())
    12.             .height('90%')
    13.             .width(150)
    14.             .backgroundColor(0xFFFFFF)
    15.             .borderRadius(15)
    16.             .fontSize(16)
    17.             .textAlign(TextAlign.Center)
    18.             .margin({ left: 10 })
    19.         })
    20.       }.height('100%')
    21.     }
    22.     .backgroundColor(0xDCDCDC)
    23.     .scrollable(ScrollDirection.Horizontal) // 滚动方向为水平方向
    24.     .scrollBar(BarState.On) // 滚动条常驻显示
    25.     .scrollBarColor(Color.Gray) // 滚动条颜色
    26.     .scrollBarWidth(10) // 滚动条宽度
    27.     .edgeEffect(EdgeEffect.Spring) // 滚动到边沿后回弹
    28.   }
    29. }

UI开发（ArkTS声明式开发范式）概述
层叠布局（Stack）
温馨提示
下载编程狮App，免费阅读超1000+编程语言教程
取消
确定
目录
构建第一个ArkTS应用（Stage模型）
Stage模型应用程序包结构
多HAP构建视图
多HAP的开发调试与发布部署流程
多HAP使用规则
多HAP运行机制及数据通信方式
应用程序包安装和卸载流程
应用程序包更新流程
共享包概述
HAR
应用内HSP开发指导
快速修复概述
快速修复命令行调试开发指导
应用配置文件概述（Stage模型）
app.json5配置文件
module.json5配置文件
资源分类与访问

学习ArkTS语言

开发

UI开发

Web

基础类库

通知

媒体

关闭

 MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }