diff --git a/packages/flutter/lib/src/widgets/basic.dart b/packages/flutter/lib/src/widgets/basic.dart index dafcd12092..a6c55db080 100644 --- a/packages/flutter/lib/src/widgets/basic.dart +++ b/packages/flutter/lib/src/widgets/basic.dart @@ -3914,11 +3914,13 @@ class Stack extends MultiChildRenderObjectWidget { /// {@macro flutter.material.Material.clipBehavior} /// - /// Stacks only clip children whose geometry overflow the stack. A child that - /// paints outside its bounds (e.g. a box with a shadow) will not be clipped, - /// regardless of the value of this property. Similarly, a child that itself - /// has a descendant that overflows the stack will not be clipped, as only the - /// geometry of the stack's direct children are considered. + /// Stacks only clip children whose _geometry_ overflows the stack. A child + /// that paints outside its bounds (e.g. a box with a shadow) will not be + /// clipped, regardless of the value of this property. Similarly, a child that + /// itself has a descendant that overflows the stack will not be clipped, as + /// only the geometry of the stack's direct children are considered. + /// [Transform] is an example of a widget that can cause its children to paint + /// outside its geometry. /// /// To clip children whose geometry does not overflow the stack, consider /// using a [ClipRect] widget.