鸿蒙UI开发——aspectRatio实现宽高比约束
蓝亭书序
2026-11-18 14:40:15 发布0 浏览 0 收藏
1、概 述
针对常见的开发场景,ArkUI开发框架提供了非常多的自适应布局能力,这些布局可以独立使用,也可多种布局叠加使用。本文针对ArkUI提供的缩放能力做简单讨论。
自动折行能力是指:子组件的宽高按照预设的比例,随容器组件发生变化,且变化过程中子组件的宽高比不变。
缩放能力通过使用百分比布局配合固定宽高比(aspectRatio属性)实现当容器尺寸发生变化时,内容自适应调整。
显示效果示意如下:

2、aspectRatio
缩放能力通过布局约束的aspectRatio属性实现。定义如下:
// 指定当前组件的宽高比,aspectRatio=width/height。
aspectRatio(value: number)设置aspectRatio属性后,组件宽高会受父组件内容区大小限制。
有几点需要注意:
- 仅设置width、aspectRatio时,height=width/aspectRatio。
- 仅设置height、aspectRatio时,width=height*aspectRatio。
- 同时设置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
标签
ArkUI
鸿蒙UI
aspectRatio
暂无评论数据
加载中...
发布
相关推荐
鸿蒙开发——基于视觉服务实现文档扫描
蓝亭书序
1
0鸿蒙开发——提取图片中的文字
蓝亭书序
0
0鸿蒙UI开发——attributeModifier动态属性
蓝亭书序
0
0鸿蒙UI开发——使用Flex实现自适应折行
蓝亭书序
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号