跨平台开发 / 系统课时

用 AspectRatio 保持内容比例

用 AspectRatio 保持内容比例

图片、视频封面和商品卡片常常要在不同屏幕宽度下保持稳定形状。AspectRatio 的作用不是指定一个固定尺寸,而是在父级约束允许的范围内,为子组件选择一个满足宽高比的尺寸,从而避免内容随着可用宽度变化而被拉成长条或压成窄块。

学习目标

  • 理解 AspectRatio 如何在父级约束内计算尺寸
  • 能用 aspectRatio 为媒体区域保持稳定宽高比
  • 知道在紧约束下为什么比例可能无法生效

AspectRatio 解决的核心问题

AspectRatio 接收一个 double 类型的 aspectRatio,计算规则是“宽度 ÷ 高度”。例如 16:9 应写成 16 / 9,1:1 写成 1。它会先查看父组件给出的约束,再尝试选出一个既合法又尽量符合该比例的尺寸。

这意味着它和固定 width、height 的思路不同:固定尺寸强调“我要这么大”,而 AspectRatio 强调“无论最终多大,都尽量保持这个形状”。

AspectRatio 在不同父级宽度下保持同一宽高比

用 16:9 比例创建媒体区域

下面的完整 Flutter 示例让卡片宽度随页面变化,但图片区域始终保持 16:9。AspectRatio 负责尺寸关系,内部的 Container 只负责内容和视觉样式。

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const AspectRatioDemo());
}

class AspectRatioDemo extends StatelessWidget {
  const AspectRatioDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('AspectRatio Demo')),
        body: Padding(
          padding: const EdgeInsets.all(16),
          child: Center(
            child: SizedBox(
              width: 360,
              child: AspectRatio(
                aspectRatio: 16 / 9,
                child: Container(
                  color: Colors.blue.shade100,
                  alignment: Alignment.center,
                  child: const Text('16:9 media area'),
                ),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

预期结果:

text
页面中央出现一个宽 360 logical pixels 的浅蓝色矩形区域,高度约为 202.5 logical pixels;改变外层可用宽度后,区域高度会随之变化,但宽高比保持 16:9。

这里不需要手工计算并写死高度,因为 AspectRatio 会根据实际宽度推导高度。对于响应式页面,这种写法比同时维护两个尺寸值更稳定。

理解父级约束的优先级

AspectRatio 仍然必须服从 Flutter 的约束传递规则。如果父级已经把宽度和高度都固定死,例如外层 SizedBox(width: 200, height: 200),那么子级没有重新选择尺寸的空间。即使内部写了 aspectRatio: 16 / 9,最终外部占用区域仍可能是 200×200。

因此排查“比例为什么没生效”时,先看父级是否给出了紧约束,而不是先怀疑 aspectRatio 数值。只固定一边通常更适合 AspectRatio 发挥作用,例如只限制最大宽度,让另一边由比例推导。

什么时候适合使用

图片缩略图、视频播放器占位、相机预览壳、商品封面和固定比例卡片都适合用 AspectRatio。这些场景的共同点是:尺寸可以响应父级变化,但内容形状必须稳定。

如果业务要求的是绝对固定尺寸,直接用 SizedBox 更清楚;如果需要根据父级实时尺寸执行更复杂的分支布局,则应考虑 LayoutBuilder。AspectRatio 最适合“只需要保持比例,不需要自己管理完整尺寸计算”的场景。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 AspectRatio 保持内容比例

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通