firka/flutter
firka/flutter
4
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add troubleshooting doc for MediaQueryData.size (#104828)

Browse Source
This commit is contained in:
Bruno Leroux 2022-05-29 08:43:06 +02:00 committed by GitHub
parent 64b08f3c56
commit c68fd6a31a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
packages/flutter/lib/src/widgets/media_query.dart
View File

@ -159,6 +159,23 @@ class MediaQueryData {
/// pixels are the size of the actual hardware pixels on the device. The /// pixels are the size of the actual hardware pixels on the device. The
/// number of physical pixels per logical pixel is described by the /// number of physical pixels per logical pixel is described by the
/// [devicePixelRatio]. /// [devicePixelRatio].
///
/// ## Troubleshooting
///
/// It is considered bad practice to cache and later use the size returned
/// by `MediaQuery.of(context).size`. It will make the application non responsive
/// and might lead to unexpected behaviors.
/// For instance, during startup, especially in release mode, the first returned
/// size might be (0,0). The size will be updated when the native platform
/// reports the actual resolution.
///
/// See the article on [Creating responsive and adaptive
/// apps](https://docs.flutter.dev/development/ui/layout/adaptive-responsive)
/// for an introduction.
///
/// See also:
///
/// * [FlutterView.physicalSize], which returns the size in physical pixels.
final Size size; final Size size;
/// The number of device pixels for each logical pixel. This number might not /// The number of device pixels for each logical pixel. This number might not