Commit fb25257f authored by Ian Hickson's avatar Ian Hickson Committed by GitHub

Point people to Block from some likely places. (#6444)

This is loosely based on the experience of usability study participant P1.
parent 605a636e
...@@ -1979,6 +1979,11 @@ class Row extends Flex { ...@@ -1979,6 +1979,11 @@ class Row extends Flex {
/// ///
/// For details about the flex layout algorithm, see [RenderFlex]. To control /// For details about the flex layout algorithm, see [RenderFlex]. To control
/// the flex of child widgets, see the [Flexible] widget. /// the flex of child widgets, see the [Flexible] widget.
///
/// The Column widget does not scroll (and in general it is considered an error
/// to have more children in a Column than will fit in the available room). If
/// you have a list of widgets and want them to be able to scroll if there is
/// insufficient room, consider using a [Block].
class Column extends Flex { class Column extends Flex {
/// Creates a vertical array of children. /// Creates a vertical array of children.
/// ///
......
...@@ -66,6 +66,9 @@ typedef double SnapOffsetCallback(double scrollOffset, Size containerSize); ...@@ -66,6 +66,9 @@ typedef double SnapOffsetCallback(double scrollOffset, Size containerSize);
/// ///
/// Widgets that subclass [Scrollable] typically use state objects that subclass /// Widgets that subclass [Scrollable] typically use state objects that subclass
/// [ScrollableState]. /// [ScrollableState].
///
/// If you have a list of widgets and want them to be able to scroll if there is
/// insufficient room, consider using [Block].
class Scrollable extends StatefulWidget { class Scrollable extends StatefulWidget {
/// Initializes fields for subclasses. /// Initializes fields for subclasses.
/// ///
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment