diff --git a/src/content/release/breaking-changes/index.md b/src/content/release/breaking-changes/index.md index 9cf53079d3..e137d6087a 100644 --- a/src/content/release/breaking-changes/index.md +++ b/src/content/release/breaking-changes/index.md @@ -41,7 +41,7 @@ They're sorted by release and listed in alphabetical order: * [Deprecated `cacheExtent` and `cacheExtentStyle`][] * [Deprecate `TextInputConnection.setStyle`][] * [`IconData` class marked as `final`][] -* [ListTile throws exception when wrapped in a colored widget][] +* [ListTile reports error in debug when wrapped in a colored widget][] * [Migrating Flutter Android app to Android Gradle Plugin 9.0.0][] * [Page transition builders reorganization][] @@ -50,7 +50,7 @@ They're sorted by release and listed in alphabetical order: [Deprecated `cacheExtent` and `cacheExtentStyle`]: /release/breaking-changes/scroll-cache-extent [Deprecate `TextInputConnection.setStyle`]: /release/breaking-changes/deprecate-text-input-connection-set-style [`IconData` class marked as `final`]: /release/breaking-changes/icondata-class-marked-final -[ListTile throws exception when wrapped in a colored widget]: /release/breaking-changes/list-tile-color-warning +[ListTile reports error in debug when wrapped in a colored widget]: /release/breaking-changes/list-tile-color-warning [Migrating Flutter Android app to Android Gradle Plugin 9.0.0]: /release/breaking-changes/migrate-to-agp-9 [Page transition builders reorganization]: /release/breaking-changes/decouple-page-transition-builders diff --git a/src/content/release/breaking-changes/list-tile-color-warning.md b/src/content/release/breaking-changes/list-tile-color-warning.md index 16e3b8cbc2..fb16431886 100644 --- a/src/content/release/breaking-changes/list-tile-color-warning.md +++ b/src/content/release/breaking-changes/list-tile-color-warning.md @@ -1,16 +1,16 @@ --- -title: ListTile throws exception when wrapped in a colored widget +title: ListTile reports error in debug when wrapped in a colored widget description: >- - ListTile throws an exception when it is wrapped in an intermediate - widget with a non-transparent background color. + ListTile reports an error in debug mode when it is wrapped in + an intermediate widget with a non-transparent background color. --- ## Summary When a `ListTile` is wrapped in a widget with a non-transparent background color (such as a `Container` or `ColoredBox` with a color specified) that sits between -the `ListTile` and its nearest `Material` ancestor, the framework now throws an -exception. +the `ListTile` and its nearest `Material` ancestor, the framework now reports an +error. ## Background @@ -21,7 +21,7 @@ them invisible to the user. To prevent developers from accidentally introducing this bug and wondering why the background or ink splash effects on the `ListTile` are not displaying, an -assert was introduced. This exception explicitly points out the issue during +assert was introduced. This error explicitly points out the issue during development. If your code has an intermediate colored widget between a `ListTile` and a @@ -38,7 +38,7 @@ Container. ## Migration guide -To fix the exception, follow the exception's hint and either remove the +To fix the error, follow the error's hint and either remove the background color from the intermediate widget, or wrap the `ListTile` in its own `Material` widget.