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

Fix AppBar doc to keep diagram next to its description (#151937)

Browse Source 
Also swap two paragraphs to keep related content together.
This commit is contained in:
Greg Price 2024-07-18 09:22:18 -07:00 committed by GitHub
parent caaff4b9b7
commit af0e01c370
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
packages/flutter/lib/src/material/app_bar.dart
View File

@ -92,13 +92,6 @@ class _PreferredAppBarSize extends Size {
/// appears in the toolbar when the writing language is left-to-right (e.g. /// appears in the toolbar when the writing language is left-to-right (e.g.
/// English): /// English):
/// ///
/// The [AppBar] insets its content based on the ambient [MediaQuery]'s padding,
/// to avoid system UI intrusions. It's taken care of by [Scaffold] when used in
/// the [Scaffold.appBar] property. When animating an [AppBar], unexpected
/// [MediaQuery] changes (as is common in [Hero] animations) may cause the content
/// to suddenly jump. Wrap the [AppBar] in a [MediaQuery] widget, and adjust its
/// padding such that the animation is smooth.
///
/// ![The leading widget is in the top left, the actions are in the top right, /// ![The leading widget is in the top left, the actions are in the top right,
/// the title is between them. The bottom is, naturally, at the bottom, and the /// the title is between them. The bottom is, naturally, at the bottom, and the
/// flexibleSpace is behind all of them.](https://flutter.github.io/assets-for-api-docs/assets/material/app_bar.png) /// flexibleSpace is behind all of them.](https://flutter.github.io/assets-for-api-docs/assets/material/app_bar.png)
@ -110,6 +103,13 @@ class _PreferredAppBarSize extends Size {
/// to false. In that case a null leading widget will result in the middle/title widget /// to false. In that case a null leading widget will result in the middle/title widget
/// stretching to start. /// stretching to start.
/// ///
/// The [AppBar] insets its content based on the ambient [MediaQuery]'s padding,
/// to avoid system UI intrusions. It's taken care of by [Scaffold] when used in
/// the [Scaffold.appBar] property. When animating an [AppBar], unexpected
/// [MediaQuery] changes (as is common in [Hero] animations) may cause the content
/// to suddenly jump. Wrap the [AppBar] in a [MediaQuery] widget, and adjust its
/// padding such that the animation is smooth.
///
/// {@tool dartpad} /// {@tool dartpad}
/// This sample shows an [AppBar] with two simple actions. The first action /// This sample shows an [AppBar] with two simple actions. The first action
/// opens a [SnackBar], while the second action navigates to a new page. /// opens a [SnackBar], while the second action navigates to a new page.