logo
积分中心
鸿蒙UI开发——使用Flex实现自适应折行
头像 蓝亭书序 2026-11-18 14:37:33    发布
0 浏览 0 收藏

1、概 述

针对常见的开发场景,ArkUI开发框架提供了非常多的自适应布局能力,这些布局可以独立使用,也可多种布局叠加使用。本文针对ArkUI提供的自动折行能力做简单讨论。

自动折行能力是指:容器组件尺寸发生变化,当布局方向尺寸不足以显示完整内容时自动换行。显示效果示意如下:

图片

2、Flex组件

折行能力通过使用 Flex折行布局 (将wrap属性设置为FlexWrap.Wrap)实现,当横向布局尺寸不足以完整显示内容元素时,通过折行的方式,将元素显示在下方。

ArkTs布局入门02——弹性布局(Flex)

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布局的一些配置参数,定义如下:

名称类型说明
directionFlexDirection子组件在Flex容器上排列的方向,即主轴的方向。默认值: FlexDirection.Row
wrapFlexWrapFlex容器是单行/列还是多行/列排列。默认值: FlexWrap.NoWrap说明:在多行布局时,通过交叉轴方向,确认新行堆叠方向。
justifyContentFlexAlign所有子组件在Flex容器主轴上的对齐格式。默认值: FlexAlign.Start
alignItemsItemAlign所有子组件在Flex容器交叉轴上的对齐格式。默认值: ItemAlign.Start
alignContentFlexAlign交叉轴中有额外的空间时,多行内容的对齐方式。仅在wrap为Wrap或WrapReverse下生效。默认值: FlexAlign.Start
spaceFlexSpaceOptions所有子组件在Flex容器主轴或交叉轴的间距。默认值: {main:LengthMetrics.px(0), cross:LengthMetrics.px(0)}。space为负数、百分比或者justifyContent设置为FlexAlign.SpaceBetween、FlexAlign.SpaceAround、FlexAlign.SpaceEvenly时不生效。

FlexSpaceOptions定义如下:

名称类型说明
mainLengthMetricsFlex容器主轴上的space。space: {main: LengthMetrics.unit(value)}
crossLengthMetricsFlex容器交叉轴上的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

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255