鸿蒙UI开发——使用Flex实现自适应折行
蓝亭书序
2026-11-18 14:37:33 发布0 浏览 0 收藏
1、概 述
针对常见的开发场景,ArkUI开发框架提供了非常多的自适应布局能力,这些布局可以独立使用,也可多种布局叠加使用。本文针对ArkUI提供的自动折行能力做简单讨论。
自动折行能力是指:容器组件尺寸发生变化,当布局方向尺寸不足以显示完整内容时自动换行。显示效果示意如下:

2、Flex组件
折行能力通过使用 Flex折行布局 (将wrap属性设置为FlexWrap.Wrap)实现,当横向布局尺寸不足以完整显示内容元素时,通过折行的方式,将元素显示在下方。
Flex的基本定义如下:
Flex(value?: FlexOptions)一个基本使用用例如下(6~13行):
// xxx.ets
@Component
struct AlignContentFlex {
alignContent: number = 0;
build() {
Flex({ wrap: FlexWrap.Wrap, alignContent: this.alignContent }) {
Text('1').width('50%').height(20).backgroundColor(0xF5DEB3)
Text('2').width('50%').height(20).backgroundColor(0xD2B48C)
Text('3').width('50%').height(20).backgroundColor(0xD2B48C)
}
.size({ width: '90%', height: 90 })
.padding(10)
.backgroundColor(0xAFEEEE)
}
}FlexOptions是Flex布局的一些配置参数,定义如下:
| 名称 | 类型 | 说明 |
| direction | FlexDirection | 子组件在Flex容器上排列的方向,即主轴的方向。默认值: FlexDirection.Row |
| wrap | FlexWrap | Flex容器是单行/列还是多行/列排列。默认值: FlexWrap.NoWrap说明:在多行布局时,通过交叉轴方向,确认新行堆叠方向。 |
| justifyContent | FlexAlign | 所有子组件在Flex容器主轴上的对齐格式。默认值: FlexAlign.Start |
| alignItems | ItemAlign | 所有子组件在Flex容器交叉轴上的对齐格式。默认值: ItemAlign.Start |
| alignContent | FlexAlign | 交叉轴中有额外的空间时,多行内容的对齐方式。仅在wrap为Wrap或WrapReverse下生效。默认值: FlexAlign.Start |
| space | FlexSpaceOptions | 所有子组件在Flex容器主轴或交叉轴的间距。默认值: {main:LengthMetrics.px(0), cross:LengthMetrics.px(0)}。space为负数、百分比或者justifyContent设置为FlexAlign.SpaceBetween、FlexAlign.SpaceAround、FlexAlign.SpaceEvenly时不生效。 |
FlexSpaceOptions定义如下:
| 名称 | 类型 | 说明 |
| main | LengthMetrics | Flex容器主轴上的space。space: {main: LengthMetrics.unit(value)} |
| cross | LengthMetrics | Flex容器交叉轴上的space。space: {cross: LengthMetrics.unit(value)} |
3、使用Flex实现自适应折行
父容器中的图片尺寸固定,当父容器尺寸发生变化,其中的内容做自适应换行。示意图如下:

代码如下(23~44行):
@Entry
@Component
struct WrapCapabilitySample {
@State rate: number = 0.9
readonly textList: string [] = ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10'];
// 底部滑块,可以通过拖拽滑块改变容器尺寸
@Builder
slider() {
Slider({
value: this.rate * 100,
min: 30,
max: 80,
style: SliderStyle.OutSet
})
.blockColor(Color.White)
.width('60%')
.onChange((value: number) => {
this.rate = value / 100
})
.position({ x: '20%', y: '87%' })
}
build() {
Flex({ justifyContent: FlexAlign.Center, direction: FlexDirection.Column }) {
Column() {
// 通过Flex组件warp参数实现自适应折行
Flex({
direction: FlexDirection.Row,
alignItems: ItemAlign.Center,
justifyContent: FlexAlign.Center,
wrap: FlexWrap.Wrap
}) {
ForEach(this.textList, (item: Resource) => {
Text(item)
.width(40)
.height(40)
.margin(10)
.borderColor(Color.Gray)
.borderWidth(1)
})
}
.backgroundColor('#FFFFFF')
.width(this.rate * 100 + '%')
.borderRadius(16)
}
.width('100%')
this.slider()
}.width('100%')
.height('100%')
.backgroundColor('#F1F3F5')
}
}
©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
标签
ArkUI
Flex
鸿蒙UI
暂无评论数据
加载中...
发布
相关推荐
鸿蒙开发——基于视觉服务实现文档扫描
蓝亭书序
1
0鸿蒙开发——提取图片中的文字
蓝亭书序
0
0鸿蒙UI开发——attributeModifier动态属性
蓝亭书序
0
0鸿蒙UI开发——aspectRatio实现宽高比约束
蓝亭书序
0
0鸿蒙UI开发——布局优先级
蓝亭书序
0
0
蓝亭书序
我还没有写个人简介......
149
帖子
0
提问
236
粉丝
最新发布
鸿蒙UI开发——布局优先级
2026-11-18 14:32:08 发布鸿蒙UI开发——实现按比例布局
2026-11-18 14:30:54 发布热门推荐
23445 浏览
23030 浏览
20621 浏览
相关问题




京公网安备:11010502051901号