From de6995cfa898ccaf1133a4792dd047fae7e52c42 Mon Sep 17 00:00:00 2001 From: Shi-Hao Hong Date: Wed, 27 Mar 2019 18:17:12 -0700 Subject: [PATCH] Added Hero zero-frame animation documentation (#30048) --- packages/flutter/lib/src/widgets/heroes.dart | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/packages/flutter/lib/src/widgets/heroes.dart b/packages/flutter/lib/src/widgets/heroes.dart index 00fb36f7c3b..31d9f8de8a3 100644 --- a/packages/flutter/lib/src/widgets/heroes.dart +++ b/packages/flutter/lib/src/widgets/heroes.dart @@ -77,11 +77,13 @@ Rect _globalBoundingBoxFor(BuildContext context) { /// same tag, a hero animation is triggered. /// /// If a [Hero] is already in flight when navigation occurs, its -/// flight animation will be redirected to its new destination. - -/// The widget shown in-flight during the transition is, by default, the +/// flight animation will be redirected to its new destination. The +/// widget shown in-flight during the transition is, by default, the /// destination route's [Hero]'s child. /// +/// For a Hero animation to trigger, the Hero has to exist on the very first +/// frame of the new page's animation. +/// /// Routes must not contain more than one [Hero] for each [tag]. /// /// ## Discussion