Add StatusBarEffect and NavigationBarEffect classes to manage their color and style

samples/XCT.Sample.iOS/Info.plist

@@ -46,5 +46,7 @@
 	<array>
 		<string>audio</string>
 	</array>
+	<key>UIViewControllerBasedStatusBarAppearance</key>
+	<false/>
 </dict>
 </plist>

samples/XCT.Sample/App.xaml

@@ -5,8 +5,10 @@
     xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
     xmlns:custom="clr-namespace:Xamarin.Forms.PancakeView;assembly=Xamarin.Forms.PancakeView"
     xmlns:d="http://xamarin.com/schemas/2014/forms/design"
+    xmlns:droid="clr-namespace:Xamarin.CommunityToolkit.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.CommunityToolkit"
     xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:xct="http://xamarin.com/schemas/2020/toolkit"
     mc:Ignorable="d">
     <Application.Resources>
         <!--  Values  -->
@@ -23,7 +25,8 @@
         <Color x:Key="DarkLabelTextColor">#000000</Color>
         <Color x:Key="DarkLabelPlaceholderColor">#333d47</Color>
         <Color x:Key="SoftFrameBackgroundColor">#ecf0f9</Color>
-
+        <Color x:Key="StatusbarColor">#1976D2</Color>
+        <Color x:Key="NavBarColor">#1976D2</Color>
         <!--  Fonts  -->
         <OnPlatform x:Key="font_bold" x:TypeArguments="x:String">
             <On Platform="iOS" Value=".SFUIText-Bold" />
@@ -56,6 +59,10 @@
             <Setter Property="BackgroundColor" Value="{StaticResource AppBackgroundColor}" />
             <Setter Property="ios:Page.UseSafeArea" Value="False" />
             <Setter Property="NavigationPage.BackButtonTitle" Value="" />
+            <Setter Property="xct:StatusBarEffect.Color" Value="{StaticResource StatusbarColor}" />
+            <Setter Property="xct:StatusBarEffect.Style" Value="DarkContent" />
+            <Setter Property="droid:NavigationBarEffect.Color" Value="{StaticResource NavBarColor}" />
+            <Setter Property="droid:NavigationBarEffect.Style" Value="LightContent" />
         </Style>
 
         <Style TargetType="Button">
@@ -96,7 +103,11 @@
         <!--  Content templates  -->
         <ControlTemplate x:Key="GalleryPageTemplate">
             <StackLayout Spacing="0">
-                <ListView ItemsSource="{TemplateBinding BindingContext.FilteredItems}" SelectionMode="None" HasUnevenRows="True" SeparatorVisibility="None">
+                <ListView
+                    HasUnevenRows="True"
+                    ItemsSource="{TemplateBinding BindingContext.FilteredItems}"
+                    SelectionMode="None"
+                    SeparatorVisibility="None">
                     <ListView.Header>
                         <ContentView Padding="20,12">
                             <Entry
@@ -127,9 +138,9 @@
                                             </Grid.ColumnDefinitions>
                                             <BoxView BackgroundColor="{Binding DetailColor, Source={x:RelativeSource AncestorType={x:Type ContentPage}}}" />
                                             <StackLayout
-                                            Grid.Column="1"
-                                            Padding="0,24,24,24"
-                                            Spacing="8">
+                                                Grid.Column="1"
+                                                Padding="0,24,24,24"
+                                                Spacing="8">
                                                 <Label Style="{StaticResource label_section_header}" Text="{Binding Title}" />
                                                 <Label Text="{Binding Description}" />
                                             </StackLayout>

samples/XCT.Sample/Pages/Effects/StatusBarEffectPage.xaml

@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<pages:BasePage
+    x:Class="Xamarin.CommunityToolkit.Sample.Pages.Effects.StatusBarEffectPage"
+    xmlns="http://xamarin.com/schemas/2014/forms"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    xmlns:droid="clr-namespace:Xamarin.CommunityToolkit.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.CommunityToolkit"
+    xmlns:pages="clr-namespace:Xamarin.CommunityToolkit.Sample.Pages"
+    xmlns:vm="clr-namespace:Xamarin.CommunityToolkit.Sample.ViewModels.Effects"
+    xmlns:xct="http://xamarin.com/schemas/2020/toolkit"
+    droid:NavigationBarEffect.Color="{Binding StatusBarColor}"
+    droid:NavigationBarEffect.Style="{Binding NavigationBarStyle}"
+    xct:StatusBarEffect.Color="{Binding StatusBarColor}"
+    xct:StatusBarEffect.Style="{Binding StatusBarStyle}">
+
+    <pages:BasePage.BindingContext>
+        <vm:StatusBarEffectViewModel />
+    </pages:BasePage.BindingContext>
+
+    <ScrollView Padding="{StaticResource ContentPadding}">
+        <StackLayout Padding="15,0" Spacing="30">
+
+            <Label Text="NavigationBar supported only on Android" />
+            <Label Text="Slide to change StatusBar and NavigationBar color" />
+
+            <Slider
+                Margin="20,10"
+                Maximum="255"
+                MaximumTrackColor="Red"
+                Minimum="0"
+                MinimumTrackColor="Red"
+                ThumbColor="Red"
+                Value="{Binding RedSliderValue}" />
+
+            <Slider
+                Margin="20,10"
+                Maximum="255"
+                MaximumTrackColor="Green"
+                Minimum="0"
+                MinimumTrackColor="Green"
+                ThumbColor="Green"
+                Value="{Binding GreenSliderValue}" />
+
+            <Slider
+                Margin="20,10"
+                Maximum="255"
+                MaximumTrackColor="Blue"
+                Minimum="0"
+                MinimumTrackColor="Blue"
+                ThumbColor="Blue"
+                Value="{Binding BlueSliderValue}" />
+
+            <StackLayout Spacing="15">
+                <Label Text="Select StatusBar and NavigationBar style" />
+                <RadioButton Content="Default" IsChecked="{Binding IsDefaultChecked}" />
+                <RadioButton Content="Light content" IsChecked="{Binding IsLightContentChecked}" />
+                <RadioButton Content="Dark content" IsChecked="{Binding IsDarkContentChecked}" />
+            </StackLayout>
+
+        </StackLayout>
+    </ScrollView>
+</pages:BasePage>

samples/XCT.Sample/Pages/Effects/StatusBarEffectPage.xaml.cs

@@ -0,0 +1,7 @@
+namespace Xamarin.CommunityToolkit.Sample.Pages.Effects
+{
+	public partial class StatusBarEffectPage
+	{
+		public StatusBarEffectPage() => InitializeComponent();
+	}
+}

samples/XCT.Sample/ViewModels/Effects/EffectsGalleryViewModel.cs

@@ -47,7 +47,12 @@ public class EffectsGalleryViewModel : BaseGalleryViewModel
 			new SectionModel(
 				typeof(SemanticEffectPage),
 				nameof(SemanticEffect),
-				"The SemanticEffect allows you to set semantic properties for accessibility.")
+				"The SemanticEffect allows you to set semantic properties for accessibility."),
+
+			new SectionModel(
+				typeof(StatusBarEffectPage),
+				nameof(StatusBarEffect),
+				"The StatusBar allows to change status bar color and style. This page also demonstrates Android only NavigationBar changes.")
 		};
 	}
 }

samples/XCT.Sample/ViewModels/Effects/StatusBarEffectViewModel.cs

@@ -0,0 +1,83 @@
+using System;
+using Xamarin.CommunityToolkit.Effects;
+using Xamarin.CommunityToolkit.PlatformConfiguration.AndroidSpecific;
+using Xamarin.Forms;
+
+namespace Xamarin.CommunityToolkit.Sample.ViewModels.Effects
+{
+	public class StatusBarEffectViewModel : BaseViewModel
+	{
+		int redSliderValue;
+		int greanSliderValue;
+		int blueSliderValue;
+		bool isDefaultChecked = true;
+		bool isLightContentChecked;
+		bool isDarkContentChecked;
+
+		public Color StatusBarColor => Color.FromRgb(RedSliderValue, GreenSliderValue, BlueSliderValue);
+
+		public StatusBarStyle StatusBarStyle
+		{
+			get
+			{
+				if (IsDefaultChecked)
+				{
+					return StatusBarStyle.Default;
+				}
+				if (IsLightContentChecked)
+				{
+					return StatusBarStyle.LightContent;
+				}
+				if (IsDarkContentChecked)
+				{
+					return StatusBarStyle.DarkContent;
+				}
+				throw new InvalidOperationException("Style is not selected");
+			}
+		}
+
+		public NavigationBarStyle NavigationBarStyle => (NavigationBarStyle)(int)StatusBarStyle;
+
+		public int RedSliderValue
+		{
+			get => redSliderValue;
+			set => SetProperty(ref redSliderValue, value, onChanged: () => OnPropertyChanged(nameof(StatusBarColor)));
+		}
+
+		public int GreenSliderValue
+		{
+			get => greanSliderValue;
+			set => SetProperty(ref greanSliderValue, value, onChanged: () => OnPropertyChanged(nameof(StatusBarColor)));
+		}
+
+		public int BlueSliderValue
+		{
+			get => blueSliderValue;
+			set => SetProperty(ref blueSliderValue, value, onChanged: () => OnPropertyChanged(nameof(StatusBarColor)));
+		}
+
+		public bool IsDefaultChecked
+		{
+			get => isDefaultChecked;
+			set => SetProperty(ref isDefaultChecked, value, onChanged: NotifyStyleChanged);
+		}
+
+		public bool IsLightContentChecked
+		{
+			get => isLightContentChecked;
+			set => SetProperty(ref isLightContentChecked, value, onChanged: NotifyStyleChanged);
+		}
+
+		public bool IsDarkContentChecked
+		{
+			get => isDarkContentChecked;
+			set => SetProperty(ref isDarkContentChecked, value, onChanged: NotifyStyleChanged);
+		}
+
+		void NotifyStyleChanged()
+		{
+			OnPropertyChanged(nameof(StatusBarStyle));
+			OnPropertyChanged(nameof(NavigationBarStyle));
+		}
+	}
+}

src/CommunityToolkit/Xamarin.CommunityToolkit.UnitTests/Namespace_Tests.cs

@@ -30,6 +30,9 @@ public void MakeSureEffectsAreInTheRightNamespace()
 		{
 			var allTheTypes = Assembly.GetAssembly(typeof(SafeAreaEffect))?.GetTypes() ?? throw new NullReferenceException();
 
+			// Filter out the platform-specific ones, i.e. AndroidSpecific or iOSSpecific
+			allTheTypes = allTheTypes.Except(allTheTypes.Where(t => t.Namespace.EndsWith("Specific"))).ToArray();
+
 			foreach (var type in allTheTypes.Where(t => t.Name.EndsWith("Effect") && t.IsClass && t.IsSealed && t.IsAbstract))
 			{
 				Assert.IsTrue(type?.Namespace?.Equals("Xamarin.CommunityToolkit.Effects"),

src/CommunityToolkit/Xamarin.CommunityToolkit/Effects/EffectIds.shared.cs

@@ -1,4 +1,5 @@
-using Xamarin.Forms;
+using Xamarin.CommunityToolkit.PlatformConfiguration.AndroidSpecific;
+using Xamarin.Forms;
 
 [assembly: ResolutionGroupName("Xamarin.CommunityToolkit.Effects")]
 
@@ -55,5 +56,14 @@ sealed class EffectIds
 		/// Effect Id for <see cref="SemanticEffect"/>
 		/// </summary>
 		public static string Semantic => $"{effectResolutionGroupName}.{nameof(SemanticEffectRouter)}";
+
+		/// Effect Id for <see cref="StatusBarEffect"/>
+		/// </summary>
+		public static string StatusBar => $"{effectResolutionGroupName}.{nameof(StatusBarEffect)}";
+
+		/// <summary>
+		/// Effect Id for <see cref="NavigationBarEffect"/>
+		/// </summary>
+		public static string NavigationBar => $"{effectResolutionGroupName}.{nameof(NavigationBarEffect)}";
 	}
 }

src/CommunityToolkit/Xamarin.CommunityToolkit/Effects/StatusBar/BarStyle.android.cs

@@ -0,0 +1,44 @@
+using System;
+using Android.App;
+using Android.OS;
+using Android.Views;
+using Xamarin.Forms.Internals;
+
+namespace Xamarin.CommunityToolkit.Effects
+{
+	static class BarStyle
+	{
+		internal static bool IsSupported()
+		{
+			if (Build.VERSION.SdkInt < BuildVersionCodes.M)
+			{
+				Log.Warning(string.Empty, $"This functionality is not available. Minimum supported API is {BuildVersionCodes.M}");
+				return false;
+			}
+
+			return true;
+		}
+
+		internal static void AddBarAppearanceFlag(Activity activity, StatusBarVisibility flag) =>
+			SetBarAppearance(activity, barAppearance => barAppearance |= flag);
+
+		internal static void RemoveBarAppearanceFlag(Activity activity, StatusBarVisibility flag) =>
+			SetBarAppearance(activity, barAppearance => barAppearance &= ~flag);
+
+		static void SetBarAppearance(Activity activity, Func<StatusBarVisibility, StatusBarVisibility> updateAppearance)
+		{
+			var window = GetCurrentWindow(activity);
+			var appearance = window.DecorView.SystemUiVisibility;
+			appearance = updateAppearance(appearance);
+			window.DecorView.SystemUiVisibility = appearance;
+		}
+
+		internal static Window GetCurrentWindow(Activity activity)
+		{
+			var window = activity.Window ?? throw new NullReferenceException();
+			window.ClearFlags(WindowManagerFlags.TranslucentStatus);
+			window.AddFlags(WindowManagerFlags.DrawsSystemBarBackgrounds);
+			return window;
+		}
+	}
+}

src/CommunityToolkit/Xamarin.CommunityToolkit/Effects/StatusBar/Models/StatusBarStyle.shared.cs

@@ -0,0 +1,9 @@
+namespace Xamarin.CommunityToolkit.Effects
+{
+	public enum StatusBarStyle
+	{
+		Default = 0,
+		LightContent = 1,
+		DarkContent = 2
+	}
+}

src/CommunityToolkit/Xamarin.CommunityToolkit/Effects/StatusBar/PlatformStatusBarEffect.android.cs

@@ -0,0 +1,72 @@
+using System.ComponentModel;
+using Android.Views;
+using Xamarin.CommunityToolkit.Android.Effects;
+using Xamarin.CommunityToolkit.Effects;
+using Xamarin.Forms;
+using Xamarin.Forms.Platform.Android;
+
+[assembly: ExportEffect(typeof(PlatformStatusBarEffect), nameof(StatusBarEffect))]
+
+namespace Xamarin.CommunityToolkit.Android.Effects
+{
+	public class PlatformStatusBarEffect : PlatformEffect
+	{
+		protected override void OnAttached()
+		{
+			SetColor(StatusBarEffect.GetColor(Element));
+			SetStyle(StatusBarEffect.GetStyle(Element));
+		}
+
+		protected override void OnDetached()
+		{
+		}
+
+		protected override void OnElementPropertyChanged(PropertyChangedEventArgs args)
+		{
+			base.OnElementPropertyChanged(args);
+			if (args.PropertyName == StatusBarEffect.ColorProperty.PropertyName)
+			{
+				SetColor(StatusBarEffect.GetColor(Element));
+			}
+			else if (args.PropertyName == StatusBarEffect.StyleProperty.PropertyName)
+			{
+				SetStyle(StatusBarEffect.GetStyle(Element));
+			}
+		}
+
+		void SetColor(Color color)
+		{
+			if (!BarStyle.IsSupported())
+				return;
+
+			Activity.SetStatusBarColor(color.ToAndroid());
+		}
+
+		void SetStyle(StatusBarStyle style)
+		{
+			if (!BarStyle.IsSupported())
+				return;
+
+			switch (style)
+			{
+				case StatusBarStyle.DarkContent:
+					BarStyle.AddBarAppearanceFlag(Activity, (StatusBarVisibility)SystemUiFlags.LightStatusBar);
+					break;
+				default:
+					BarStyle.RemoveBarAppearanceFlag(Activity, (StatusBarVisibility)SystemUiFlags.LightStatusBar);
+					break;
+			}
+		}
+
+		FormsAppCompatActivity Activity
+		{
+			get
+			{
+				if (Control != null)
+					return (FormsAppCompatActivity)Control.Context!;
+				else
+					return (FormsAppCompatActivity)Container.Context!;
+			}
+		}
+	}
+}