You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add loadingWidget support for backgroundImage #2349
The Image widget supports loadingWidget, but backgroundImage does not support it consistently across all rendering paths. The decoration-based rendering path ignores loadingWidget, so no shimmer/placeholder can be shown while a remote background image loads. This behavior is also undocumented.
Describe the solution you'd like
Support loadingWidget on backgroundImage consistently across all rendering paths:
Also document the supported properties for backgroundImage.loadingWidget.
Describe alternatives you've considered
Replacing backgroundImage with a separate Image widget or a manual Stack — both work but require extra layout logic and duplicate framework functionality.
Additional context
Image.loadingWidget is already supported and used for shimmer placeholders. The framework's getImageAsWidget() path handles backgroundImage.loadingWidget, but getImageAsDecorated() does not. The behavior should be consistent or explicitly documented as limited to specific rendering paths.
Activity