Prepared sample and read me for the MAUI Tab View

README.md

@@ -1,2 +1,48 @@
 # Modify-the-header-image-color-in-the-MAUI-Tab-View
+
 This sample demonstrates how to modify the header image color in the MAUI Tab View control within a .NET MAUI application.
+
+## Sample
+
+```xaml
+    <tabView:SfTabView ItemsSource="{Binding TabItems}" SelectionChanged="OnSelectionChanged">
+        <tabView:SfTabView.HeaderItemTemplate>
+            <DataTemplate>
+                <HorizontalStackLayout Margin="20,10,20,0">
+                    <Image Source="{Binding ImageName}" Aspect="AspectFit" HorizontalOptions="Center"
+                HeightRequest="30" WidthRequest="30">
+                        <Image.Behaviors>
+                            <toolkit:IconTintColorBehavior TintColor="{Binding SelectedColor}" />
+                        </Image.Behaviors>
+                    </Image>
+                </HorizontalStackLayout>
+            </DataTemplate>
+        </tabView:SfTabView.HeaderItemTemplate>
+
+        <tabView:SfTabView.ContentItemTemplate>
+            <DataTemplate>
+                <ListView RowHeight="60">
+                    <ListView.ItemsSource>
+                        <x:Array Type="{x:Type x:String}">
+                            <x:String>James</x:String>
+                            <x:String>Richard</x:String>
+                            <x:String>Michael</x:String>
+                            <x:String>Alex</x:String>
+                            <x:String>Clara</x:String>
+                        </x:Array>
+                    </ListView.ItemsSource>
+                </ListView>
+            </DataTemplate>
+        </tabView:SfTabView.ContentItemTemplate>
+    </tabView:SfTabView>
+```
+
+## Requirements to run the demo
+
+To run the demo, refer to [System Requirements for .NET MAUI](https://help.syncfusion.com/maui/system-requirements)
+
+## Troubleshooting:
+
+### Path too long exception
+
+If you are facing path too long exception when building this example project, close Visual Studio and rename the repository to short and build the project.

TabViewSample/TabViewSample.sln

@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.14.36414.22 d17.14
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TabViewSample", "TabViewSample\TabViewSample.csproj", "{66FF6784-A21A-4372-AEC6-86020745A9C5}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{66FF6784-A21A-4372-AEC6-86020745A9C5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{66FF6784-A21A-4372-AEC6-86020745A9C5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{66FF6784-A21A-4372-AEC6-86020745A9C5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{66FF6784-A21A-4372-AEC6-86020745A9C5}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {0AC4B5AC-EFFC-4B11-BA6E-C432569B9749}
+	EndGlobalSection
+EndGlobal

TabViewSample/TabViewSample/App.xaml

@@ -0,0 +1,14 @@
+<?xml version = "1.0" encoding = "UTF-8" ?>
+<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             xmlns:local="clr-namespace:TabViewSample"
+             x:Class="TabViewSample.App">
+    <Application.Resources>
+        <ResourceDictionary>
+            <ResourceDictionary.MergedDictionaries>
+                <ResourceDictionary Source="Resources/Styles/Colors.xaml" />
+                <ResourceDictionary Source="Resources/Styles/Styles.xaml" />
+            </ResourceDictionary.MergedDictionaries>
+        </ResourceDictionary>
+    </Application.Resources>
+</Application>

TabViewSample/TabViewSample/App.xaml.cs

@@ -0,0 +1,15 @@
+namespace TabViewSample
+{
+    public partial class App : Application
+    {
+        public App()
+        {
+            InitializeComponent();
+        }
+
+        protected override Window CreateWindow(IActivationState? activationState)
+        {
+            return new Window(new AppShell());
+        }
+    }
+}

TabViewSample/TabViewSample/AppShell.xaml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<Shell
+    x:Class="TabViewSample.AppShell"
+    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    xmlns:local="clr-namespace:TabViewSample"
+    Title="TabViewSample">
+
+    <ShellContent
+        ContentTemplate="{DataTemplate local:MainPage}"
+        Route="MainPage" />
+
+</Shell>

TabViewSample/TabViewSample/AppShell.xaml.cs

@@ -0,0 +1,10 @@
+namespace TabViewSample
+{
+    public partial class AppShell : Shell
+    {
+        public AppShell()
+        {
+            InitializeComponent();
+        }
+    }
+}

TabViewSample/TabViewSample/GlobalXmlns.cs

@@ -0,0 +1,2 @@
+[assembly: XmlnsDefinition("http://schemas.microsoft.com/dotnet/maui/global", "TabViewSample")]
+[assembly: XmlnsDefinition("http://schemas.microsoft.com/dotnet/maui/global", "TabViewSample.Pages")]

TabViewSample/TabViewSample/MainPage.xaml

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             xmlns:tabView="clr-namespace:Syncfusion.Maui.Toolkit.TabView;assembly=Syncfusion.Maui.Toolkit"
+             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
+             xmlns:local="clr-namespace:TabViewSample"
+             x:Class="TabViewSample.MainPage">
+
+    <ContentPage.BindingContext>
+        <local:TabItemsSourceViewModel x:Name="viewModel"/>
+    </ContentPage.BindingContext>
+
+    <tabView:SfTabView ItemsSource="{Binding TabItems}" SelectionChanged="OnSelectionChanged">
+        <tabView:SfTabView.HeaderItemTemplate>
+            <DataTemplate>
+                <HorizontalStackLayout Margin="20,10,20,0">
+                    <Image Source="{Binding ImageName}" Aspect="AspectFit" HorizontalOptions="Center"
+                   HeightRequest="30" WidthRequest="30">
+                        <Image.Behaviors>
+                            <toolkit:IconTintColorBehavior TintColor="{Binding SelectedColor}" />
+                        </Image.Behaviors>
+                    </Image>
+                </HorizontalStackLayout>
+            </DataTemplate>
+        </tabView:SfTabView.HeaderItemTemplate>
+
+        <tabView:SfTabView.ContentItemTemplate>
+            <DataTemplate>
+                <ListView RowHeight="60">
+                    <ListView.ItemsSource>
+                        <x:Array Type="{x:Type x:String}">
+                            <x:String>James</x:String>
+                            <x:String>Richard</x:String>
+                            <x:String>Michael</x:String>
+                            <x:String>Alex</x:String>
+                            <x:String>Clara</x:String>
+                        </x:Array>
+                    </ListView.ItemsSource>
+                </ListView>
+            </DataTemplate>
+        </tabView:SfTabView.ContentItemTemplate>
+
+    </tabView:SfTabView>
+
+</ContentPage>

TabViewSample/TabViewSample/MainPage.xaml.cs

@@ -0,0 +1,21 @@
+using Syncfusion.Maui.Toolkit.TabView;
+
+namespace TabViewSample
+{
+    public partial class MainPage : ContentPage
+    {
+        public MainPage()
+        {
+            InitializeComponent();
+        }
+
+        private void OnSelectionChanged(object sender, TabSelectionChangedEventArgs e)
+        {
+            if (e.NewIndex >= 0 && e.OldIndex >= 0)
+            {
+                viewModel.TabItems[e.OldIndex].SelectedColor = Colors.Gray;
+                viewModel.TabItems[e.NewIndex].SelectedColor = Colors.Red;
+            }
+        }
+    }
+}

TabViewSample/TabViewSample/MauiProgram.cs

@@ -0,0 +1,29 @@
+using CommunityToolkit.Maui;
+using Microsoft.Extensions.Logging;
+using Syncfusion.Maui.Toolkit.Hosting;
+
+namespace TabViewSample
+{
+    public static class MauiProgram
+    {
+        public static MauiApp CreateMauiApp()
+        {
+            var builder = MauiApp.CreateBuilder();
+            builder
+                .UseMauiApp<App>()
+                .UseMauiCommunityToolkit()
+                .ConfigureSyncfusionToolkit()
+                .ConfigureFonts(fonts =>
+                {
+                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
+                    fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
+                });
+
+#if DEBUG
+    		builder.Logging.AddDebug();
+#endif
+
+            return builder.Build();
+        }
+    }
+}

TabViewSample/TabViewSample/Model.cs

@@ -0,0 +1,42 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace TabViewSample
+{
+    public class Model : INotifyPropertyChanged
+    {
+        public event PropertyChangedEventHandler? PropertyChanged;
+
+        protected void OnPropertyChanged(string propertyName)
+        {
+            var handler = PropertyChanged;
+            if (handler != null)
+                handler(this, new PropertyChangedEventArgs(propertyName));
+        }
+
+        private string? image;
+        public string? ImageName
+        {
+            get { return image; }
+            set
+            {
+                image = value;
+                OnPropertyChanged("ImageName");
+            }
+        }
+        private Color? selectedColor;
+        public Color? SelectedColor
+        {
+            get => selectedColor;
+            set
+            {
+                selectedColor = value;
+                OnPropertyChanged(nameof(SelectedColor));
+            }
+        }
+    }
+}

TabViewSample/TabViewSample/Platforms/Android/AndroidManifest.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+	<application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true"></application>
+	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+	<uses-permission android:name="android.permission.INTERNET" />
+</manifest>

TabViewSample/TabViewSample/Platforms/Android/MainActivity.cs

@@ -0,0 +1,11 @@
+using Android.App;
+using Android.Content.PM;
+using Android.OS;
+
+namespace TabViewSample
+{
+    [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, LaunchMode = LaunchMode.SingleTop, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
+    public class MainActivity : MauiAppCompatActivity
+    {
+    }
+}

TabViewSample/TabViewSample/Platforms/Android/MainApplication.cs

@@ -0,0 +1,16 @@
+using Android.App;
+using Android.Runtime;
+
+namespace TabViewSample
+{
+    [Application]
+    public class MainApplication : MauiApplication
+    {
+        public MainApplication(IntPtr handle, JniHandleOwnership ownership)
+            : base(handle, ownership)
+        {
+        }
+
+        protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+    }
+}

TabViewSample/TabViewSample/Platforms/Android/Resources/values/colors.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#512BD4</color>
+    <color name="colorPrimaryDark">#2B0B98</color>
+    <color name="colorAccent">#2B0B98</color>
+</resources>

TabViewSample/TabViewSample/Platforms/MacCatalyst/AppDelegate.cs

@@ -0,0 +1,10 @@
+using Foundation;
+
+namespace TabViewSample
+{
+    [Register("AppDelegate")]
+    public class AppDelegate : MauiUIApplicationDelegate
+    {
+        protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+    }
+}

TabViewSample/TabViewSample/Platforms/MacCatalyst/Entitlements.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+    <!-- See https://aka.ms/maui-publish-app-store#add-entitlements for more information about adding entitlements.-->
+    <dict>
+        <!-- App Sandbox must be enabled to distribute a MacCatalyst app through the Mac App Store. -->
+        <key>com.apple.security.app-sandbox</key>
+        <true/>
+        <!-- When App Sandbox is enabled, this value is required to open outgoing network connections. -->
+        <key>com.apple.security.network.client</key>
+        <true/>
+    </dict>
+</plist>
+

TabViewSample/TabViewSample/Platforms/MacCatalyst/Info.plist

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <!-- The Mac App Store requires you specify if the app uses encryption. -->
+    <!-- Please consult https://developer.apple.com/documentation/bundleresources/information_property_list/itsappusesnonexemptencryption -->
+    <!-- <key>ITSAppUsesNonExemptEncryption</key> -->
+    <!-- Please indicate <true/> or <false/> here. -->
+
+    <!-- Specify the category for your app here. -->
+    <!-- Please consult https://developer.apple.com/documentation/bundleresources/information_property_list/lsapplicationcategorytype -->
+    <!-- <key>LSApplicationCategoryType</key> -->
+    <!-- <string>public.app-category.YOUR-CATEGORY-HERE</string> -->
+	<key>UIDeviceFamily</key>
+	<array>
+		<integer>2</integer>
+	</array>
+	<key>UIRequiredDeviceCapabilities</key>
+	<array>
+		<string>arm64</string>
+	</array>
+	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationPortraitUpsideDown</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>XSAppIconAssets</key>
+	<string>Assets.xcassets/appicon.appiconset</string>
+</dict>
+</plist>