鸿蒙布局概述
一、线性布局(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.避坑提示
- 不能出现循环锚定(A 锚定 B、B 又锚定 A),会渲染错乱;
align参数只能使用AlignRuleDirection,不可混用FlexAlign,否则报类型错误;- 若不写
alignRules,子组件会全部堆叠在容器左上角。
更多推荐




所有评论(0)