Added useOriginalColors flag which allows ImageIcon to bypass IconTheme colorization and use the original colors (#180491)

zawhtetnaing10 · victorsanni · web-flow · commit 238d79aba784 · 2026-04-27T16:42:08.000Z
Added useOriginalColors flag which allows ImageIcon to bypass IconTheme colorization and use the original colors. Issue #180463 ## Pre-launch Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [Tree Hygiene] wiki page, which explains my responsibilities. - [x] I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement]. - [x] I signed the [CLA]. - [x] I listed at least one issue that this PR fixes in the description above. - [x] I updated/added relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or this PR is [test-exempt]. - [x] I followed the [breaking change policy] and added [Data Driven Fixes] where supported. - [x] All existing and new tests are passing.  [Contributor Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview [Tree Hygiene]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md [test-exempt]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests [Flutter Style Guide]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md [Features we expect every widget to implement]: https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement [CLA]: https://cla.developers.google.com/ [flutter/tests]: https://github.com/flutter/tests [breaking change policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes [Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md [Data Driven Fixes]: https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md --------- Co-authored-by: Victor Sanni <victorsanniay@gmail.com>
diff --git a/packages/flutter/lib/src/widgets/image_icon.dart b/packages/flutter/lib/src/widgets/image_icon.dart
@@ -26,7 +26,18 @@ class ImageIcon extends StatelessWidget {
   /// Creates an image icon.
   ///
   /// The [size] and [color] default to the value given by the current [IconTheme].
-  const ImageIcon(this.image, {super.key, this.size, this.color, this.semanticLabel});
+  const ImageIcon(
+    this.image, {
+    super.key,
+    this.size,
+    this.color,
+    this.semanticLabel,
+    this.useOriginalColors = false,
+  }) : assert(
+         !(useOriginalColors && color != null),
+         'Cannot provide a color while useOriginalColors is true. '
+         'To use a specific color, set useOriginalColors to false or omit it.',
+       );
 
   /// The image to display as the icon.
   ///
@@ -61,6 +72,21 @@ class ImageIcon extends StatelessWidget {
   ///    underlying	 [Semantics] widget.
   final String? semanticLabel;
 
+  /// Whether to render the image using its original colors.
+  ///
+  /// If this is false (the default), the image is colorized by merging the
+  /// [color] (or, if that is null, the [IconTheme] color) with the image
+  /// using [BlendMode.srcIn]. This is the standard behavior for icons.
+  ///
+  /// If this is true, the color-blend filter is disabled, and the image is
+  /// rendered with its original colors. This allows multi-colored images,
+  /// such as brand logos, to be displayed accurately.
+  ///
+  /// If this is true, [color] must be null.
+  ///
+  /// Defaults to false.
+  final bool useOriginalColors;
+
   @override
   Widget build(BuildContext context) {
     final IconThemeData iconTheme = IconTheme.of(context);
@@ -86,7 +112,7 @@ class ImageIcon extends StatelessWidget {
         image: image!,
         width: iconSize,
         height: iconSize,
-        color: iconColor,
+        color: useOriginalColors ? null : iconColor,
         fit: BoxFit.scaleDown,
         excludeFromSemantics: true,
       ),
diff --git a/packages/flutter/test/widgets/image_icon_test.dart b/packages/flutter/test/widgets/image_icon_test.dart
@@ -98,6 +98,50 @@ void main() {
     handle.dispose();
   });
 
+  testWidgets('ImageIcon respects IconTheme color by default', (WidgetTester tester) async {
+    await tester.pumpWidget(
+      Directionality(
+        textDirection: TextDirection.ltr,
+        child: IconTheme(
+          data: const IconThemeData(color: Color(0xFF0000FF)),
+          child: ImageIcon(image),
+        ),
+      ),
+    );
+
+    expect(tester.widget<Image>(find.byType(Image)).color, const Color(0xFF0000FF));
+    imageCache.clear();
+  });
+
+  testWidgets('ImageIcon ignores IconTheme color when useOriginalColors is true', (
+    WidgetTester tester,
+  ) async {
+    await tester.pumpWidget(
+      Directionality(
+        textDirection: TextDirection.ltr,
+        child: IconTheme(
+          data: const IconThemeData(color: Color(0xFF0000FF)),
+          child: ImageIcon(image, useOriginalColors: true),
+        ),
+      ),
+    );
+
+    expect(tester.widget<Image>(find.byType(Image)).color, null);
+    imageCache.clear();
+  });
+
+  testWidgets(
+    'ImageIcon throws assertion error if color is provided and useOriginalColors is true',
+    (WidgetTester tester) async {
+      expect(
+        () => ImageIcon(image, color: const Color(0xFF0000FF), useOriginalColors: true),
+        throwsAssertionError,
+      );
+
+      imageCache.clear();
+    },
+  );
+
   testWidgets('ImageIcon does not crash at zero area', (WidgetTester tester) async {
     await tester.pumpWidget(
       Directionality(
