Skip to content

Clarify ListTile error reporting in colored widget #13222

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sfshaza2 merged 3 commits into from
Mar 30, 2026
+9 −9
Merged

Clarify ListTile error reporting in colored widget #13222

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
fc35ecb
Clarify ListTile error reporting in colored widget
Albert221 Mar 26, 2026
91cc156
Update index page title
Albert221 Mar 26, 2026
c24b294
Merge branch 'main' into patch-2
Albert221 Mar 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/content/release/breaking-changes/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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][]

Expand All @@ -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

Expand Down
14 changes: 7 additions & 7 deletions src/content/release/breaking-changes/list-tile-color-warning.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
Expand All @@ -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.

Expand Down
Loading