一、线性布局(Row/Column)

在鸿蒙 HarmonyOS ArkTS 开发中,线性布局是最基础、使用频率最高的布局容器,分为两种:

  • Column:垂直线性布局,子组件从上到下纵向排列
  • Row:水平线性布局,子组件从左到右横向排列

线性布局承担页面 90% 以上的排版需求,文本、按钮、表单、导航栏等场景都依赖它。本文从零讲解基础语法、对齐、间距、实战踩坑,配套完整可运行代码。

1. Column 垂直布局(纵向排列)

所有子组件沿 Y 轴垂直摆放,基础结构:

space: 10:子组件之间固定间距,单位 vp

容器支持链式调用宽高、内边距、对齐等样式

2. Row 水平布局(横向排列)

所有子组件沿 X 轴水平摆放:

3.线性布局核心属性

(1)space:子组件间距

(2)justifyContent:主轴对齐方式

枚举值效果说明
FlexAlign.Start子组件靠起始边对齐(Column 顶部、Row 左侧)
FlexAlign.Center子组件居中排布
FlexAlign.End子组件靠结束边对齐(Column 底部、Row 右侧)
FlexAlign.SpaceBetween两端贴边,中间剩余空间均分
FlexAlign.SpaceAround每个子组件两侧均分空白
FlexAlign.SpaceEvenly所有间隔完全相等

示例:垂直布局整体居中

(3)alignItems:交叉轴对齐

交叉轴与主轴垂直:Column 交叉轴是水平方向,Row 交叉轴是垂直方向,同样使用FlexAlign。

4.实战示例

Column:

Row:

5.高频踩坑与解决方案

坑 1:build 内多个根布局,代码标红报错

错误代码:

原因:build() 只能存在一个根组件,多个容器必须外层再套一层 Row/Column 包裹。

坑 2:子组件无法撑满父容器宽度

解决:给子组件添加 .width("100%"),或使用 .layoutWeight(1) 自动占满剩余空间。

坑 3:布局高度无法铺满全屏

父容器设置 .height("100%"),同时外层必须是页面根组件@Entry。

坑 4:space 间距失效

space 仅作用于直接子组件,嵌套内部组件不受外层 space 控制,需要单独给内层容器设置 space。

6.总结

  • Column垂直、Row水平,是鸿蒙最基础线性布局;
  • space控制子组件间距,justifyContent主轴对齐,alignItems交叉轴对齐;
  • 复杂页面采用「Row 嵌套 Column / Column 嵌套 Row」的组合方式排版;
  • build 函数只能有一个根 UI 节点,多容器必须外层包裹;
  • 搭配.width()、.height()、.padding()、.layoutWeight()完成自适应页面。

二、层叠布局 (Stack)

1. 布局特性

Stack是层叠容器,所有子组件默认居中重叠渲染,核心规则:代码后书写的组件层级更高,会覆盖先定义的底层组件。 和线性布局核心区别:

  • Row/Column:子组件横向 / 纵向平铺,无重叠;支持space设置子元素间距
  • Stack:子组件重叠覆盖,不存在间距概念,不支持space参数

2. 基础语法结构

3. 核心对齐属性 alignContent

统一控制所有子组件在容器内的对齐位置,仅支持Align枚举,不可使用 FlexAlign,常用枚举值:

枚举对齐效果
Align.Center默认,全部居中
Align.TopStart左上角
Align.TopEnd右上角
Align.BottomStart左下角
Align.BottomEnd右下角

4.实战示例

三、弹性布局(Flex)

1. 核心特性

Flex 全称弹性布局,分为主轴、交叉轴:

Flex({ direction: FlexDirection.Row }):主轴水平(从左到右),等价增强版 Row

Flex({ direction: FlexDirection.Column }):主轴垂直(从上到下),等价增强版 Column

和 Row/Column 最大区别:

Flex 支持 wrap 换行属性,元素超出容器自动换行;Row/Column 不会换行,内容会溢出屏幕 Flex 支持 flexShrink / flexGrow 弹性伸缩,自动瓜分剩余空间 对齐能力更丰富,流式换行后可统一控制多行整体排布

2. 基础创建语法

3.Flex 核心配置参数

direction 主轴方向(FlexDirection 枚举)

枚举值效果
FlexDirection.Row默认,主轴水平从左到右
FlexDirection.Column主轴垂直从上到下
FlexDirection.RowReverse水平反向,从右到左
FlexDirection.ColumnReverse垂直反向,从下到上

2. wrap 换行规则(FlexWrap 枚举)

枚举值效果
FlexWrap.NoWrap默认不换行,元素溢出容器
FlexWrap.Wrap空间不足自动换行(最常用)
FlexWrap.WrapReverse

换行且反向排布

space 统一间距

同线性布局,space: vp数值 控制相邻子组件横向、纵向间距。

4.Flex 三大对齐

(1)justifyContent:主轴对齐(FlexAlign)

控制单行内子组件在主轴的排布,和 Row/Column 用法完全一致,常用:Center 居中、SpaceBetween 两端贴边、SpaceEvenly 间隔均等。

(2)alignltems:单行交叉轴对齐

  • 水平 Flex(Row 方向):交叉轴垂直,使用VerticalAlign
  • 垂直 Flex(Column 方向):交叉轴水平,使用HorizontalAlign

(3)alignContent:多行整体对齐

仅开启 wrap:Wrap 换行后生效,控制所有多行整体在容器内上下 / 左右排布,参数为FlexAlign。 如果只有一行,alignContent 不会生效。

5.实战示例

四、相对布局 (RelativeContainer)

开发中会遇到这类需求:一个按钮固定在右下角、文本贴住图片左侧、标签紧贴控件顶部,线性 / 层叠 / 弹性布局很难精准控制元素相对位置,鸿蒙专门提供 RelativeContainer 相对布局。

核心优势:子组件不按轴平铺,通过ID 锚定规则,以其他组件、容器四边为参照物自由摆放,适合弹窗内部控件、表单浮动标签、自由悬浮按钮等场景。

1.相对布局核心概念

容器:RelativeContainer(),所有子组件必须设置唯一 id("xxx"); 参照物:子组件通过alignRules() 绑定锚定规则,参照物可以是容器边界、其他组件 ID; 无默认排布:不写alignRules规则时,子组件全部堆叠在左上角,不会自动排版。

2. 锚定对齐枚举(AlignRuleDirection)

控制当前组件哪一条边对齐参照物的哪一条边:3. 对齐规则对象 AlignRule

枚举含义
AlignRuleDirection.Left左边
AlignRuleDirection.Right右边
AlignRuleDirection.Top顶部
AlignRuleDirection.Bottom底部

3.实战示例

5.避坑提示

  1. 不能出现循环锚定(A 锚定 B、B 又锚定 A),会渲染错乱;
  2. align 参数只能使用 AlignRuleDirection,不可混用 FlexAlign,否则报类型错误;
  3. 若不写 alignRules,子组件会全部堆叠在容器左上角。
Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐