纯血鸿蒙ArkUI线性布局详解

线性布局说明

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

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

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

基础概念

• 布局容器：具有布局能力的容器组件，可以承载其他元素作为其子元素，布局容器会对其子元素进行尺寸计算和布局排列。

• 布局子元素：布局容器内部的元素。

• 主轴：线性布局容器在布局方向上的轴线，子元素默认沿主轴排列。Row容器主轴为水平方向，Column容器主轴为垂直方向。

• 交叉轴：垂直于主轴方向的轴线。Row容器交叉轴为垂直方向，Column容器交叉轴为水平方向。

• 间距：布局子元素的间距。

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

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

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

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

@Entry
@Component
struct LinearLayout {build() {// Column容器组件默认情况下在垂直方向从上向下对子组件进行布局// space的值设置为20，表示子组件之间的距离为20vpColumn({ space: 20 }) {Text('space: 20').fontSize(15).fontColor(Color.Gray).width('90%')Row().width('90%').height(50).backgroundColor(0xF5DEB3)Row().width('90%').height(50).backgroundColor(0xD2B48C)Row().width('90%').height(50).backgroundColor(0xF5DEB3)}.width('100%')}
}

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

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

@Entry
@Component
struct LinearLayout {build() {// 默认情况下，Row对子组件在水平方向上从左向右布局// space设置为35表示子组件之间在主轴方向上间距为35vpRow({ space: 35 }) {Text('space: 35').fontSize(15).fontColor(Color.Gray)Row().width('10%').height(150).backgroundColor(0xF5DEB3)Row().width('10%').height(150).backgroundColor(0xD2B48C)Row().width('10%').height(150).backgroundColor(0xF5DEB3)}.width('90%')}
}

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

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

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

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

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

1. HorizontalAlign.Start：子元素在水平方向左对齐。

@Entry
@Component
struct LinearLayout03 {build() {// 列容器组件默认情况下对子组件从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%')// 设置列容器组件子元素在水平方向左对齐.alignItems(HorizontalAlign.Start).backgroundColor('rgb(242,242,242)')}
}

2. HorizontalAlign.Center：子元素在水平方向居中对齐。

@Entry
@Component
struct LinearLayout04 {build() {// 列容器组件默认情况下对子组件在垂直方向从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%')// 设置列容器组件子组件在水平方向居中对齐.alignItems(HorizontalAlign.Center).backgroundColor('rgb(242,242,242)')}
}

3. HorizontalAlign.End：子元素在水平方向右对齐。

@Entry
@Component
struct LinearLayout05 {build() {// 列容器组件默认情况下对子组件在垂直方向从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%')// 设置列容器组件的子组件在水平方向右对齐.alignItems(HorizontalAlign.End).backgroundColor('rgb(242,242,242)')}
}

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

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

1. VerticalAlign.Top：子元素在垂直方向顶部对齐。

@Entry
@Component
struct LinearLayout06 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200)// 设置行容器子组件在垂直方向顶部对齐.alignItems(VerticalAlign.Top).backgroundColor('rgb(242,242,242)')}
}

2. VerticalAlign.Center：子元素在垂直方向居中对齐。

@Entry
@Component
struct LinearLayout07 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200)// 设置行容器组件的子组件在垂直方向居中对齐.alignItems(VerticalAlign.Center).backgroundColor('rgb(242,242,242)')}
}

3. VerticalAlign.Bottom：子元素在垂直方向底部对齐。

@Entry
@Component
struct LinearLayout08 {build() {// 行容器组件默认情况下对子组件在水平方向上从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200)// 设置行容器组件的子组件在垂直方向上底部对齐.alignItems(VerticalAlign.Bottom).backgroundColor('rgb(242,242,242)')}
}

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

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

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

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

1. justifyContent(FlexAlign.Start)：元素在垂直方向顶部对齐，第一个元素与顶部对齐，后续元素与前一个对齐。

@Entry
@Component
struct LinearLayout09 {build() {// 列容器组件默认情况下对子组件在垂直方向从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%').height(300).backgroundColor('rgb(242,242,242)')// 设置列容器组件子组件在垂直方向顶部对齐，第一个元素与顶部对齐，后续元素与前一个对齐。.justifyContent(FlexAlign.Start)}
}

2. justifyContent(FlexAlign.Center)：元素在垂直方向中心对齐，第一个元素与顶部的距离与最后一个元素与底部距离相同。

@Entry
@Component
struct LinearLayout10 {build() {// 列容器组件默认情况下对子组件在垂直方向上从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%').height(300).backgroundColor('rgb(242,242,242)')// 设置列容器子组件在垂直方向中心对齐，第一个元素与顶部的距离与最后一个元素与底部距离相同。.justifyContent(FlexAlign.Center)}
}

3. justifyContent(FlexAlign.End)：元素在垂直方向底部对齐，最后一个元素与底部对齐，其他元素与后一个对齐。

@Entry
@Component
struct LinearLayout11 {build() {// 列容器组件默认情况下对子组件在垂直方向上从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%').height(300).backgroundColor('rgb(242,242,242)')// 设置列容器子组件在垂直方向底部对齐，最后一个元素与底部对齐，其他元素与后一个对齐。.justifyContent(FlexAlign.End)}
}

4. justifyContent(FlexAlign.SpaceBetween)：垂直方向均匀分配元素，相邻元素之间距离相同。第一个元素与容器顶部对齐，最后一个元素与容器底部对齐。

@Entry
@Component
struct LinearLayout12 {build() {// 列容器组件默认情况下对子组件在垂直方向从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%').height(300).backgroundColor('rgb(242,242,242)')// 垂直方向均匀分配元素，相邻元素之间距离相同。第一个元素与容器顶部对齐，最后一个元素与容器底部对齐。.justifyContent(FlexAlign.SpaceBetween)}
}

5. justifyContent(FlexAlign.SpaceAround)：垂直方向均匀分配元素，相邻元素之间距离相同。第一个元素到容器顶部的距离和最后一个元素到容器底部的距离是相邻元素之间距离的一半。

@Entry
@Component
struct LinearLayout13 {build() {// 列容器组件默认情况下对子组件在垂直方向从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%').height(300).backgroundColor('rgb(242,242,242)')// 设置列容器组件子组件垂直方向均匀分配元素，相邻元素之间距离相同。// 第一个元素到容器顶部的距离和最后一个元素到容器底部的距离是相邻元素之间距离的一半。.justifyContent(FlexAlign.SpaceAround)}
}

6. justifyContent(FlexAlign.SpaceEvenly)：垂直方向均匀分配元素，相邻元素之间的距离、第一个元素与容器顶部的间距、最后一个元素到容器底部的间距都完全一样。

@Entry
@Component
struct LinearLayout14 {build() {// 列容器组件默认情况下对子组件在垂直方向上并从上向下布局Column({}) {Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)Column() {}.width('80%').height(50).backgroundColor(0xD2B48C)Column() {}.width('80%').height(50).backgroundColor(0xF5DEB3)}.width('100%').height(300).backgroundColor('rgb(242,242,242)')// 设置列容器子组件垂直方向均匀分配元素，// 相邻元素之间的距离、第一个元素与容器顶部的间距、最后一个元素到容器底部的间距都完全一样。.justifyContent(FlexAlign.SpaceEvenly)}
}

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

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

1. ustifyContent(FlexAlign.Start)：元素在水平方向左对齐，第一个元素与容器左侧对齐，同时后续的元素与前一个对齐。

@Entry
@Component
struct LinearLayout15 {build() {// 行容器组件默认情况下对子组件在水平方向上从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200).backgroundColor('rgb(242,242,242)')// 设置行容器组件的子组件在水平方向左对齐，第一个元素与容器左侧对齐，同时后续的元素与前一个对齐。.justifyContent(FlexAlign.Start)}
}

2. justifyContent(FlexAlign.Center)：元素在水平方向居中对齐，第一个元素与容器左侧的距离与最后一个元素与容器右侧距离相同。

@Entry
@Component
struct LinearLayout16 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200).backgroundColor('rgb(242,242,242)')// 设置行容器子组件在水平方向居中对齐，第一个元素与容器左侧的距离与最后一个元素与容器右侧距离相同。.justifyContent(FlexAlign.Center)}
}

3. justifyContent(FlexAlign.End)：元素在水平方向右对齐，最后一个元素与行容器右侧对齐，其他元素与后一个对齐。

@Entry
@Component
struct LinearLayout17 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200).backgroundColor('rgb(242,242,242)')// 设置行容器子组件在水平方向右对齐，最后一个元素与行容器右侧对齐，其他元素与后一个对齐。.justifyContent(FlexAlign.End)}
}

4. justifyContent(FlexAlign.SpaceBetween)：水平方向均匀分配元素，相邻元素之间距离相同。第一个元素与行首对齐，最后一个元素与行尾对齐。

@Entry
@Component
struct LinearLayout18 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200).backgroundColor('rgb(242,242,242)')// 设置行容器子组件水平方向均匀分配元素，// 相邻元素之间距离相同。第一个元素与容器左侧对齐，最后一个元素与容器右侧对齐。.justifyContent(FlexAlign.SpaceBetween)}
}

5. justifyContent(FlexAlign.SpaceAround)：水平方向均匀分配元素，相邻元素之间距离相同。第一个元素到行容器左侧的距离和最后一个元素到行容器右侧的距离是相邻元素之间距离的一半。

@Entry
@Component
struct LinearLayout19 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200).backgroundColor('rgb(242,242,242)')// 设置行容器子组件水平方向均匀分配元素，相邻元素之间距离相同。// 第一个元素到行容器左侧的距离和最后一个元素到行容器右侧的距离是相邻元素之间距离的一半。.justifyContent(FlexAlign.SpaceAround)}
}

6. justifyContent(FlexAlign.SpaceEvenly)：水平方向均匀分配元素，相邻元素之间的距离、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。

@Entry
@Component
struct LinearLayout20 {build() {// 行容器组件默认情况下对子组件在水平方向从左向右布局Row({}) {Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)Column() {}.width('20%').height(30).backgroundColor(0xD2B48C)Column() {}.width('20%').height(30).backgroundColor(0xF5DEB3)}.width('100%').height(200).backgroundColor('rgb(242,242,242)')// 设置行容器子组件在水平方向均匀分配元素，// 相邻元素之间的距离、第一个元素与容器左侧的间距、最后一个元素到容器右侧的间距都完全一样。.justifyContent(FlexAlign.SpaceEvenly)}
}

自适应拉伸

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

@Entry
@Component
struct LinearLayout21 {build() {// 列容器组件默认情况下对子组件在垂直方向从上向下布局Column() {Row() {Text('Bluetooth').fontSize(18)// 空白填充组件Blank，在容器主轴方向自动填充空白空间，达到自适应拉伸效果Blank()Toggle({ type: ToggleType.Switch, isOn: true })}.backgroundColor(0xFFFFFF).borderRadius(15).padding({ left: 12 }).width('100%')}.backgroundColor(0xEFEFEF).padding(20).width('100%')}
}

竖屏

横屏

自适应缩放

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

1. 父容器尺寸确定时，使用layoutWeight属性设置子元素和兄弟元素在主轴上的权重，忽略元素本身尺寸设置，使它们在任意尺寸的设备下自适应占满剩余空间。

• 

横屏

竖屏

2. 父容器尺寸确定时，使用百分比设置子元素和兄弟元素的宽度，使他们在任意尺寸的设备下保持固定的自适应占比。

@Entry
@Component
struct WidthExample {build() {Column() {Row() {Column() {Text('left width 20%').textAlign(TextAlign.Center)}.width('20%').backgroundColor(0xF5DEB3).height('100%')Column() {Text('center width 50%').textAlign(TextAlign.Center)}.width('50%').backgroundColor(0xD2B48C).height('100%')Column() {Text('right width 30%').textAlign(TextAlign.Center)}.width('30%').backgroundColor(0xF5DEB3).height('100%')}.backgroundColor(0xffd306).height('30%')}}
}

横屏

竖屏

自适应延伸

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

• 在List中添加滚动条：当List子项目过多一屏放不下时，可以将每一个子元素放置在不同的组件中，通过滚动条进行拖动展示。可以通过scrollBar属性设置滚动条的常驻状态，edgeEffect属性设置拖动到内容最末端的回弹效果。

• 使用Scroll组件：在线性布局中，开发者可以进行垂直方向或者水平方向的布局。当一屏无法完全显示时，可以在Column或Row组件的外层包裹一个可滚动的容器组件Scroll来实现可滑动的线性布局。

  垂直方向布局中使用Scroll组件：

• @Entry
  @Component
  struct ScrollExample {scroller: Scroller = new Scroller();private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];build() {Scroll(this.scroller) {Column() {ForEach(this.arr, (item?:number|undefined) => {if(item){Text(item.toString()).width('90%').height(150).backgroundColor(0xFFFFFF).borderRadius(15).fontSize(16).textAlign(TextAlign.Center).margin({ top: 10 })}}, (item:number) => item.toString())}.width('100%')}.backgroundColor(0xDCDCDC).scrollable(ScrollDirection.Vertical) // 滚动方向为垂直方向    .scrollBar(BarState.On) // 滚动条常驻显示  .scrollBarColor(Color.Gray) // 滚动条颜色  .scrollBarWidth(10) // 滚动条宽度  .edgeEffect(EdgeEffect.Spring) // 滚动到边沿后回弹 }
  }

  

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

@Entry
@Component
struct ScrollExample {scroller: Scroller = new Scroller();private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];build() {Scroll(this.scroller) {Row() {ForEach(this.arr, (item?:number|undefined) => {if(item){Text(item.toString()).height('90%').width(150).backgroundColor(0xFFFFFF).borderRadius(15).fontSize(100).textAlign(TextAlign.Center).margin({ left: 10 })}})}.height('100%')}.backgroundColor(0xDCDCDC).scrollable(ScrollDirection.Horizontal) // 滚动方向为水平方向   .scrollBar(BarState.On) // 滚动条常驻显示    .scrollBarColor(Color.Gray) // 滚动条颜色   .scrollBarWidth(10) // 滚动条宽度   .edgeEffect(EdgeEffect.Spring) // 滚动到边沿后回弹 }
}