From a111551b24f1d652aa93a997f4335609e06bedba Mon Sep 17 00:00:00 2001 From: Adam Barth Date: Mon, 20 Mar 2017 16:17:27 -0700 Subject: [PATCH] Document that Material clips (#8915) Fixes #8519 --- packages/flutter/lib/src/material/material.dart | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/packages/flutter/lib/src/material/material.dart b/packages/flutter/lib/src/material/material.dart index 91bdaf1b4d..fdd7ab8980 100644 --- a/packages/flutter/lib/src/material/material.dart +++ b/packages/flutter/lib/src/material/material.dart @@ -86,6 +86,10 @@ abstract class MaterialInkController { /// [InkSplash] and [InkHighlight] effects. To trigger a reaction on the /// material, use a [MaterialInkController] obtained via [Material.of]. /// +/// If a material has a non-zero [elevation], then the material will clip its +/// contents because content that is conceptually printing on a separate piece +/// of material cannot be printed beyond the bounds of the material. +/// /// If the layout changes (e.g. because there's a list on the paper, and it's /// been scrolled), a LayoutChangedNotification must be dispatched at the /// relevant subtree. (This in particular means that Transitions should not be