logo
积分中心
鸿蒙UI开发——实现按比例布局
头像 蓝亭书序 2026-11-18 14:30:54    发布
0 浏览 0 收藏

1、概 述

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

子组件的宽或高按照预设的比例,随容器组件发生变化,效果如下。

图片

占比能力通常有两种实现方式:

  1. 将子组件的宽高设置为父组件宽高的百分比。
  2. 通过layoutWeight属性配置互为兄弟关系的组件在父容器主轴方向的布局权重。
    • 当父容器尺寸确定时,其子组件按照开发者配置的权重比例分配父容器中主轴方向的空间。
    • 仅当父容器是Row、Column或者Flex时,layoutWeight属性才会生效。
    • 设置layoutWeight属性后,组件本身的尺寸会失效。比如同时设置了.width('40%')和.layoutWeight(1),那么只有.layoutWeight(1)会生效。
占比能力在实际开发中使用的非常广泛,可以通过很多不同的方式实现占比能力,如还可以通过Grid组件的columnsTemplate属性设置网格容器中列的数量及其宽度比例,或通过配置子组件在栅格中占据不同的列数来实现占比能力。


2、案 例

交互效果如下:

图片


👉🏻 通过layoutWeight实现比例分配能力

简单的控制栏,其中“首页”、“会话”、“设置”的layoutWeight属性都设置为1,因此它们按照“1:1:1”的比例均分父容器主轴方向的空间。

代码如下(26、33、41行):


@Entry
@Component
struct ProportionCapabilitySample {
  @State rate: number = 0.5
  // 底部滑块,可以通过拖拽滑块改变容器尺寸
  @Builder slider() {
    Slider({ value: 100, min: 25, max: 50, style: SliderStyle.OutSet })
      .blockColor(Color.White)
      .width('60%')
      .height(50)
      .onChange((value: number) => {
        this.rate = value / 100
      })
      .position({ x: '20%', y: '80%' })
  }
  build() {
    Column() {
      Column() {
        Row() {
          Column() {
            Text('首 页')
          }
          .height(40)
          .backgroundColor(Color.Pink)
          .borderRadius({topLeft: 16, bottomLeft: 16})
          .layoutWeight(1)  // 设置子组件在父容器主轴方向的布局权重
          .justifyContent(FlexAlign.Center)
          .alignItems(HorizontalAlign.Center)
          Column() {
            Text('会 话')
          }
          .height(40)
          .layoutWeight(1)  // 设置子组件在父容器主轴方向的布局权重
          .justifyContent(FlexAlign.Center)
          .alignItems(HorizontalAlign.Center)
          Column() {
            Text('设 置')
          }
          .height(40)
          .backgroundColor(Color.Orange)
          .layoutWeight(1)  // 设置子组件在父容器主轴方向的布局权重
          .justifyContent(FlexAlign.Center)
          .alignItems(HorizontalAlign.Center)
          .borderRadius({topRight: 16, bottomRight: 16})
        }
        .border({width: 1, color: Color.Gray})
        .width(this.rate * 100 + '%')
        .height(40)
        .borderRadius(16)
        .backgroundColor('#FFFFFF')
      }
      this.slider()
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F1F3F5')
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}


👉🏻 通过设置父组件宽高占比实现比例分配能力

我们可以将上述的.layoutWeight(1)分别替换为.width('33%')、 .width('34%')、 .width('33%'),也可以实现与当前同样的显示效果。

代码如下(26、33、41行):


@Entry
@Component
struct ProportionCapabilitySample {
  @State rate: number = 0.5
  // 底部滑块,可以通过拖拽滑块改变容器尺寸
  @Builder slider() {
    Slider({ value: 100, min: 25, max: 50, style: SliderStyle.OutSet })
      .blockColor(Color.White)
      .width('60%')
      .height(50)
      .onChange((value: number) => {
        this.rate = value / 100
      })
      .position({ x: '20%', y: '80%' })
  }
  build() {
    Column() {
      Column() {
        Row() {
          Column() {
            Text('首 页')
          }
          .height(40)
          .backgroundColor(Color.Pink)
          .borderRadius({topLeft: 16, bottomLeft: 16})
          .width('33%')  // 设置子组件在父容器中所占的宽度
          .justifyContent(FlexAlign.Center)
          .alignItems(HorizontalAlign.Center)
          Column() {
            Text('会 话')
          }
          .height(40)
          .width('34%')  // 设置子组件在父容器中所占的宽度
          .justifyContent(FlexAlign.Center)
          .alignItems(HorizontalAlign.Center)
          Column() {
            Text('设置')
          }
          .height(40)
          .backgroundColor(Color.Orange)
          .width('33%')  // 设置子组件在父容器中所占的宽度
          .justifyContent(FlexAlign.Center)
          .alignItems(HorizontalAlign.Center)
          .borderRadius({topRight: 16, bottomRight: 16})
        }
        .border({width: 1, color: Color.Gray})
        .width(this.rate * 100 + '%')
        .height(40)
        .borderRadius(16)
        .backgroundColor('#FFFFFF')
      }
      this.slider()
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F1F3F5')
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}




©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

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

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255