dotnet · rmarinho · Apr 9, 2025 · Apr 3, 2025 · Apr 3, 2025 · Apr 4, 2025
diff --git a/...ests/TestCases.Android.Tests/snapshots/android/VerifyWebViewBackgroundColor.png b/...ests/TestCases.Android.Tests/snapshots/android/VerifyWebViewBackgroundColor.png
diff --git a/...stCases.Android.Tests/snapshots/android/VerifyWebViewDynamicBackgroundColor.png b/...stCases.Android.Tests/snapshots/android/VerifyWebViewDynamicBackgroundColor.png
diff --git a/src/Controls/tests/TestCases.HostApp/Issues/Issue28714.cs b/src/Controls/tests/TestCases.HostApp/Issues/Issue28714.cs
@@ -0,0 +1,48 @@
+namespace Maui.Controls.Sample.Issues;
+
+[Issue(IssueTracker.Github, 28714, "[iOS] WebView BackgroundColor is not setting correctly", PlatformAffected.iOS)]
+public partial class Issue28714 : ContentPage
+{
+	public Issue28714()
+	{
+		BackgroundColor = Colors.YellowGreen;
+		var verticalStackLayout = new VerticalStackLayout();
+		verticalStackLayout.Spacing = 20;
+
+		var webView = new WebView()
+		{
+			HeightRequest = 300,
+			WidthRequest = 400,
+			BackgroundColor = Colors.Transparent,
+			Source = new HtmlWebViewSource
+			{
+				Html = @"
+    <!DOCTYPE html>
+    <html lang='en'>
+    <body>
+        <h1>Welcome to WebView</h1>
+        <p id='message'></p>
+    </body>
+    </html>"
+			}
+
+		};
+
+		var button = new Button
+		{
+			Text = "Change WebView BackgroundColor",
+			AutomationId = "button"
+		};
+		button.Clicked += (s, e) =>
+		{
+			webView.BackgroundColor = Colors.Red;
+		};
+
+		verticalStackLayout.Add(button);
+		verticalStackLayout.Add(webView);
+
+
+
+		Content = verticalStackLayout;
+	}
+}
diff --git a/...ntrols/tests/TestCases.Mac.Tests/snapshots/mac/VerifyWebViewBackgroundColor.png b/...ntrols/tests/TestCases.Mac.Tests/snapshots/mac/VerifyWebViewBackgroundColor.png
diff --git a/...tests/TestCases.Mac.Tests/snapshots/mac/VerifyWebViewDynamicBackgroundColor.png b/...tests/TestCases.Mac.Tests/snapshots/mac/VerifyWebViewDynamicBackgroundColor.png
diff --git a/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue28714.cs b/src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue28714.cs
@@ -0,0 +1,32 @@
+#if TEST_FAILS_ON_WINDOWS // The transparent background color is not working on Windows, refer to https://github.com/microsoft/microsoft-ui-xaml/issues/6527
+using NUnit.Framework;
+using UITest.Appium;
+using UITest.Core;
+
+namespace Microsoft.Maui.TestCases.Tests.Issues;
+public class Issue28714 : _IssuesUITest
+{
+	public override string Issue => "[iOS] WebView BackgroundColor is not setting correctly";
+
+	public Issue28714(TestDevice device)
+	: base(device)
+	{ }
+
+	[Test, Order(1)]
+	[Category(UITestCategories.WebView)]
+	public void VerifyWebViewBackgroundColor()
+	{
+		App.WaitForElement("button");
+		VerifyScreenshot();
+	}
+
+	[Test, Order(2)]
+	[Category(UITestCategories.WebView)]
+	public void VerifyWebViewDynamicBackgroundColor()
+	{
+		App.WaitForElement("button");
+		App.Tap("button");
+		VerifyScreenshot();
+	}
+}
+#endif
diff --git a/...ntrols/tests/TestCases.iOS.Tests/snapshots/ios/VerifyWebViewBackgroundColor.png b/...ntrols/tests/TestCases.iOS.Tests/snapshots/ios/VerifyWebViewBackgroundColor.png
diff --git a/...tests/TestCases.iOS.Tests/snapshots/ios/VerifyWebViewDynamicBackgroundColor.png b/...tests/TestCases.iOS.Tests/snapshots/ios/VerifyWebViewDynamicBackgroundColor.png
diff --git a/src/Core/src/Handlers/WebView/WebViewHandler.cs b/src/Core/src/Handlers/WebView/WebViewHandler.cs
@@ -30,6 +30,7 @@ public partial class WebViewHandler : IWebViewHandler
 			[nameof(WebView.Settings)] =  MapWebViewSettings
 #elif __IOS__
 			[nameof(WKUIDelegate)] = MapWKUIDelegate,
+			[nameof(IWebView.Background)] = MapBackground,
 #endif
 		};
 

diff --git a/src/Core/src/Handlers/WebView/WebViewHandler.iOS.cs b/src/Core/src/Handlers/WebView/WebViewHandler.iOS.cs
@@ -25,7 +25,15 @@ protected override WKWebView CreatePlatformView() =>
 		public static void MapWKUIDelegate(IWebViewHandler handler, IWebView webView)
 		{
 			if (handler is WebViewHandler platformHandler)
+			{
 				handler.PlatformView.UIDelegate = platformHandler._delegate ??= new MauiWebViewUIDelegate(handler);
+			}
+		}
+
+		static void MapBackground(IWebViewHandler handler, IWebView webView)
+		{
+			handler.PlatformView.Opaque = webView.Background is null;
+			handler.PlatformView.UpdateBackground(webView);
 		}
 
 		public static void MapSource(IWebViewHandler handler, IWebView webView)