Minor documentation fixes (#126609)
Fixes for grammar, tone, and clarity.
This commit is contained in:
parent
6b6c4bdb6b
commit
2919572fb3
@ -304,7 +304,7 @@ class BoxConstraints extends Constraints {
|
|||||||
/// * The size must satisfy these constraints.
|
/// * The size must satisfy these constraints.
|
||||||
/// * The aspect ratio of the returned size matches the aspect ratio of the
|
/// * The aspect ratio of the returned size matches the aspect ratio of the
|
||||||
/// given size.
|
/// given size.
|
||||||
/// * The returned size as big as possible while still being equal to or
|
/// * The returned size is as big as possible while still being equal to or
|
||||||
/// smaller than the given size.
|
/// smaller than the given size.
|
||||||
Size constrainSizeAndAttemptToPreserveAspectRatio(Size size) {
|
Size constrainSizeAndAttemptToPreserveAspectRatio(Size size) {
|
||||||
if (isTight) {
|
if (isTight) {
|
||||||
@ -1486,10 +1486,10 @@ abstract class RenderBox extends RenderObject {
|
|||||||
///
|
///
|
||||||
/// ### Text
|
/// ### Text
|
||||||
///
|
///
|
||||||
/// Text is the canonical example of a width-in-height-out algorithm. The
|
/// English text is the canonical example of a width-in-height-out algorithm.
|
||||||
/// `height` argument is therefore ignored.
|
/// The `height` argument is therefore ignored.
|
||||||
///
|
///
|
||||||
/// Consider the string "Hello World" The _maximum_ intrinsic width (as
|
/// Consider the string "Hello World". The _maximum_ intrinsic width (as
|
||||||
/// returned from [computeMaxIntrinsicWidth]) would be the width of the string
|
/// returned from [computeMaxIntrinsicWidth]) would be the width of the string
|
||||||
/// with no line breaks.
|
/// with no line breaks.
|
||||||
///
|
///
|
||||||
@ -1498,12 +1498,12 @@ abstract class RenderBox extends RenderObject {
|
|||||||
/// might still not overflow. For example, maybe the rendering would put a
|
/// might still not overflow. For example, maybe the rendering would put a
|
||||||
/// line-break half-way through the words, as in "Hel⁞lo⁞Wor⁞ld". However,
|
/// line-break half-way through the words, as in "Hel⁞lo⁞Wor⁞ld". However,
|
||||||
/// this wouldn't be a _correct_ rendering, and [computeMinIntrinsicWidth] is
|
/// this wouldn't be a _correct_ rendering, and [computeMinIntrinsicWidth] is
|
||||||
/// supposed to render the minimum width that the box could be without failing
|
/// defined as returning the minimum width that the box could be without
|
||||||
/// to _correctly_ paint the contents within itself.
|
/// failing to _correctly_ paint the contents within itself.
|
||||||
///
|
///
|
||||||
/// The minimum intrinsic _height_ for a given width smaller than the minimum
|
/// The minimum intrinsic _height_ for a given width _smaller_ than the
|
||||||
/// intrinsic width could therefore be greater than the minimum intrinsic
|
/// minimum intrinsic width could therefore be greater than the minimum
|
||||||
/// height for the minimum intrinsic width.
|
/// intrinsic height for the minimum intrinsic width.
|
||||||
///
|
///
|
||||||
/// ### Viewports (e.g. scrolling lists)
|
/// ### Viewports (e.g. scrolling lists)
|
||||||
///
|
///
|
||||||
|
Loading…
x
Reference in New Issue
Block a user