From 434d6c3ff845f9885d579a90e00ab81d4755b5f3 Mon Sep 17 00:00:00 2001 From: Adam Barth Date: Tue, 21 Feb 2017 14:14:25 -0800 Subject: [PATCH] Improve Stack docs (#8312) Discuss how to change paint order. --- packages/flutter/lib/src/widgets/basic.dart | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/packages/flutter/lib/src/widgets/basic.dart b/packages/flutter/lib/src/widgets/basic.dart index bbbc71cb45..216fcdc239 100644 --- a/packages/flutter/lib/src/widgets/basic.dart +++ b/packages/flutter/lib/src/widgets/basic.dart @@ -1461,6 +1461,13 @@ class BlockBody extends MultiChildRenderObjectWidget { /// placed relative to the stack according to their top, right, bottom, and left /// properties. /// +/// The stack paints its children in order. If you want to change the order in +/// which the children paint, you can rebuild the stack with the children in +/// the new order. If you reorder the children in this way, consider giving the +/// children non-null keys. These keys will cause the framework to move the +/// underlying objects for the children to their new locations rather than +/// recreate them at their new location. +/// /// For more details about the stack layout algorithm, see [RenderStack]. /// /// If you want to lay a number of children out in a particular pattern, or if