logo
积分中心
鸿蒙UI开发——aspectRatio实现宽高比约束
头像 蓝亭书序 2026-11-18 14:40:15    发布
0 浏览 0 收藏

1、概 述

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

自动折行能力是指:子组件的宽高按照预设的比例,随容器组件发生变化,且变化过程中子组件的宽高比不变。

缩放能力通过使用百分比布局配合固定宽高比(aspectRatio属性)实现当容器尺寸发生变化时,内容自适应调整。

显示效果示意如下:

图片

2、aspectRatio

缩放能力通过布局约束的aspectRatio属性实现。定义如下:


// 指定当前组件的宽高比,aspectRatio=width/height。
aspectRatio(value: number)


设置aspectRatio属性后,组件宽高会受父组件内容区大小限制。

有几点需要注意:

  1. 仅设置width、aspectRatio时,height=width/aspectRatio。
  2. 仅设置height、aspectRatio时,width=height*aspectRatio。
  3. 同时设置width、height和aspectRatio时,height不生效,height=width/aspectRatio。

其中属性值value表示指定当前组件的宽高比。API version 10及以后无默认值。

该属性在不设置值或者设置非法值时不生效。

例如,Row只设置宽度且没有子组件,aspectRatio不设置值或者设置成负数时,此时Row高度为0。

3、案 例

为方便查看效果,示例中特意给Text组件加了背景色。可以看到Text组件随着其Column父组件尺寸变化而缩放的过程中,始终保持预设的宽高比。效果如下:

图片

代码如下(28行):


@Entry
@Component
struct ScaleCapabilitySample {
  @State sliderWidth: number = 300
  // 底部滑块,可以通过拖拽滑块改变容器尺寸
  @Builder
  slider() {
    Column(){
      Text('改变宽度').fontSize(12).width('60%')
      Slider({
        value: this.sliderWidth,
        min: 100,
        max: 300,
        style: SliderStyle.OutSet
      })
        .blockColor(Color.White)
        .width('60%')
        .onChange((value: number) => {
          this.sliderWidth = value;
        })
    }.margin({top:20})
  }
  build() {
    Column() {
      Column() {
        Text('欢迎加入【Harmony自习室】').textAlign(TextAlign.Center).width('100%')
          .backgroundColor(Color.Pink)
          .aspectRatio(1.5)// 固定宽高比 1: 1.5
      }
      .backgroundColor("#FFFFFF")
      .height(300)
      .width(this.sliderWidth)
      .justifyContent(FlexAlign.Center)
      .alignItems(HorizontalAlign.Center)
      this.slider()
    }
    .width('100%')
    .height('100%')
    .backgroundColor("#F1F3F5")
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}


如果将上述代码中28行代码注释,将会失去等比效果,显示将是如下:

图片


📢注意上述案例中,我们设置了width为100%,因此aspectRatio属性将按照width来计算height。所以,父容器height发生变化时,不会引起Text组件的尺寸发生变化(因为高度由宽度确定)。



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

暂无评论数据

加载中...

发布

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

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255