Rename IsNullOrEmptyConverter to IsStringNullOrEmptyConverter

samples/CommunityToolkit.Maui.Sample/AppShell.xaml.cs

@@ -47,8 +47,8 @@ public partial class AppShell : Shell
 		{ typeof(InvertedBoolConverterViewModel), (typeof(ConvertersGalleryPage), typeof(InvertedBoolConverterPage)) },
 		{ typeof(IsListNotNullOrEmptyConverterViewModel), (typeof(ConvertersGalleryPage), typeof(IsListNotNullOrEmptyConverterPage)) },
 		{ typeof(IsListNullOrEmptyConverterViewModel), (typeof(ConvertersGalleryPage), typeof(IsListNullOrEmptyConverterPage)) },
-		{ typeof(IsNotNullOrEmptyConverterViewModel), (typeof(ConvertersGalleryPage), typeof(IsNotNullOrEmptyConverterPage)) },
-		{ typeof(IsNullOrEmptyConverterViewModel), (typeof(ConvertersGalleryPage), typeof(IsNullOrEmptyConverterPage)) },
+		{ typeof(IsStringNotNullOrEmptyConverterViewModel), (typeof(ConvertersGalleryPage), typeof(IsStringNotNullOrEmptyConverterPage)) },
+		{ typeof(IsStringNullOrEmptyConverterViewModel), (typeof(ConvertersGalleryPage), typeof(IsStringNullOrEmptyConverterPage)) },
 		{ typeof(ItemSelectedEventArgsConverterViewModel), (typeof(ConvertersGalleryPage), typeof(ItemSelectedEventArgsConverterPage)) },
 		{ typeof(ItemTappedEventArgsConverterViewModel), (typeof(ConvertersGalleryPage), typeof(ItemTappedEventArgsConverterPage)) },
 		{ typeof(ListToStringConverterViewModel), (typeof(ConvertersGalleryPage), typeof(ListToStringConverterPage)) },

samples/CommunityToolkit.Maui.Sample/MauiProgram.cs

@@ -35,8 +35,8 @@ public static MauiApp CreateMauiApp()
 		builder.Services.AddTransient<EqualConverterViewModel>();
 		builder.Services.AddTransient<IndexToArrayItemConverterViewModel>();
 		builder.Services.AddTransient<IntToBoolConverterViewModel>();
-		builder.Services.AddTransient<IsNotNullOrEmptyConverterViewModel>();
-		builder.Services.AddTransient<IsNullOrEmptyConverterViewModel>();
+		builder.Services.AddTransient<IsStringNotNullOrEmptyConverterViewModel>();
+		builder.Services.AddTransient<IsStringNullOrEmptyConverterViewModel>();
 		builder.Services.AddTransient<ItemSelectedEventArgsConverterViewModel>();
 		builder.Services.AddTransient<ItemTappedEventArgsConverterViewModel>();
 		builder.Services.AddTransient<IsListNotNullOrEmptyConverterViewModel>();

samples/CommunityToolkit.Maui.Sample/Pages/Converters/IsStringNotNullOrEmptyConverterPage.xaml

@@ -0,0 +1,34 @@
+<pages:BasePage 
+    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    xmlns:mct="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
+    xmlns:pages="clr-namespace:CommunityToolkit.Maui.Sample.Pages"
+    xmlns:vm="clr-namespace:CommunityToolkit.Maui.Sample.ViewModels.Converters"
+    x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.IsStringNotNullOrEmptyConverterPage"
+    x:TypeArguments="vm:IsStringNotNullOrEmptyConverterViewModel">
+
+    <pages:BasePage.Resources>
+        <ResourceDictionary>
+            <mct:IsStringNotNullOrEmptyConverter x:Key="IsStringNotNullOrEmptyConverter" />
+        </ResourceDictionary>
+    </pages:BasePage.Resources>
+
+    <pages:BasePage.Content>
+        <VerticalStackLayout
+            Padding="10,10"
+            HorizontalOptions="Fill"
+            Spacing="16"
+            VerticalOptions="Fill">
+
+            <Label Text="The IsStringNotNullOrEmptyConverter is a converter that allows users to convert an incoming string binding to a bool value. This value represents if the incoming string binding value is not null or empty using string.IsNullOrEmpty." TextColor="{StaticResource NormalLabelTextColor}" />
+
+            <Label Text="Enter text into the Entry, below. If the text is not null or empty, the value will be true." TextColor="{StaticResource NormalLabelTextColor}" FontAttributes="Bold"/>
+
+            <Entry VerticalOptions="CenterAndExpand" HorizontalOptions="Fill" Text="{Binding Path=LabelText, Mode=OneWayToSource}" TextColor="{StaticResource NormalLabelTextColor}" />
+
+            <Label VerticalOptions="CenterAndExpand" HorizontalOptions="CenterAndExpand" Text="{Binding Path=LabelText, Mode=OneWay, Converter={StaticResource IsStringNotNullOrEmptyConverter}}" />
+
+        </VerticalStackLayout>
+    </pages:BasePage.Content>
+
+</pages:BasePage>

samples/CommunityToolkit.Maui.Sample/Pages/Converters/IsStringNotNullOrEmptyConverterPage.xaml.cs

@@ -0,0 +1,12 @@
+using CommunityToolkit.Maui.Sample.ViewModels.Converters;
+
+namespace CommunityToolkit.Maui.Sample.Pages.Converters;
+
+public partial class IsStringNotNullOrEmptyConverterPage : BasePage<IsStringNotNullOrEmptyConverterViewModel>
+{
+	public IsStringNotNullOrEmptyConverterPage(IsStringNotNullOrEmptyConverterViewModel isStringNotNullOrEmptyConverterViewModel)
+		: base(isStringNotNullOrEmptyConverterViewModel)
+	{
+		InitializeComponent();
+	}
+}

samples/CommunityToolkit.Maui.Sample/Pages/Converters/IsStringNullOrEmptyConverterPage.xaml

@@ -0,0 +1,34 @@
+<pages:BasePage 
+    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    xmlns:mct="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
+    xmlns:pages="clr-namespace:CommunityToolkit.Maui.Sample.Pages"
+    xmlns:vm="clr-namespace:CommunityToolkit.Maui.Sample.ViewModels.Converters"
+    x:Class="CommunityToolkit.Maui.Sample.Pages.Converters.IsStringNullOrEmptyConverterPage"
+    x:TypeArguments="vm:IsStringNullOrEmptyConverterViewModel">
+
+    <pages:BasePage.Resources>
+        <ResourceDictionary>
+            <mct:IsStringNullOrEmptyConverter x:Key="IsStringNullOrEmptyConverter" />
+        </ResourceDictionary>
+    </pages:BasePage.Resources>
+
+    <pages:BasePage.Content>
+        <VerticalStackLayout
+            Padding="10,10"
+            HorizontalOptions="Fill"
+            Spacing="16"
+            VerticalOptions="Fill">
+
+            <Label Text="The IsStringNullOrEmptyConverter is a converter that allows usersc to convert an incoming string binding to a bool value. This value represents if the incoming string binding value is null or empty using string.IsNullOrEmpty." TextColor="{StaticResource NormalLabelTextColor}" />
+
+            <Label Text="Enter text into the Entry, below. If the text is null or empty, the value will be true." TextColor="{StaticResource NormalLabelTextColor}" FontAttributes="Bold" />
+
+            <Entry VerticalOptions="CenterAndExpand" HorizontalOptions="Fill" Text="{Binding Path=LabelText, Mode=OneWayToSource}" TextColor="{StaticResource NormalLabelTextColor}" />
+
+            <Label VerticalOptions="CenterAndExpand" HorizontalOptions="CenterAndExpand" Text="{Binding Path=LabelText, Mode=OneWay, Converter={StaticResource IsStringNullOrEmptyConverter}}" />
+
+        </VerticalStackLayout>
+    </pages:BasePage.Content>
+
+</pages:BasePage>

samples/CommunityToolkit.Maui.Sample/Pages/Converters/IsStringNullOrEmptyConverterPage.xaml.cs

@@ -0,0 +1,12 @@
+using CommunityToolkit.Maui.Sample.ViewModels.Converters;
+
+namespace CommunityToolkit.Maui.Sample.Pages.Converters;
+
+public partial class IsStringNullOrEmptyConverterPage : BasePage<IsStringNullOrEmptyConverterViewModel>
+{
+	public IsStringNullOrEmptyConverterPage(IsStringNullOrEmptyConverterViewModel isStringNullOrEmptyConverterViewModel)
+		: base(isStringNullOrEmptyConverterViewModel)
+	{
+		InitializeComponent();
+	}
+}

samples/CommunityToolkit.Maui.Sample/ViewModels/Converters/ConvertersGalleryViewModel.cs

@@ -11,10 +11,10 @@ public ConvertersGalleryViewModel()
 			SectionModel.Create<BoolToObjectConverterViewModel>(nameof(BoolToObjectConverter),
 				"A converter that allows users to convert a bool value binding to a specific object."),
 
-			SectionModel.Create<IsNullOrEmptyConverterViewModel>(nameof(IsNullOrEmptyConverter),
+			SectionModel.Create<IsStringNullOrEmptyConverterViewModel>(nameof(IsStringNullOrEmptyConverter),
 				"A converter that allows users to convert an incoming binding to a bool value. This value represents if the incoming binding value is null or empty."),
 
-			SectionModel.Create<IsNotNullOrEmptyConverterViewModel>(nameof(IsNotNullOrEmptyConverter),
+			SectionModel.Create<IsStringNotNullOrEmptyConverterViewModel>(nameof(IsStringNotNullOrEmptyConverter),
 				"A converter that allows users to convert an incoming binding to a bool value. This value represents if the incoming binding value is Not null or empty."),
 
 			SectionModel.Create<InvertedBoolConverterViewModel>(nameof(InvertedBoolConverter),

samples/CommunityToolkit.Maui.Sample/ViewModels/Converters/IsStringNotNullOrEmptyConverterViewModel.cs

@@ -0,0 +1,14 @@
+using System.Windows.Input;
+
+namespace CommunityToolkit.Maui.Sample.ViewModels.Converters;
+
+public class IsStringNotNullOrEmptyConverterViewModel : BaseViewModel
+{
+	string? labelText;
+
+	public string? LabelText
+	{
+		get => labelText;
+		set => SetProperty(ref labelText, value);
+	}
+}

samples/CommunityToolkit.Maui.Sample/ViewModels/Converters/IsStringNullOrEmptyConverterViewModel.cs

@@ -0,0 +1,14 @@
+using System.Windows.Input;
+
+namespace CommunityToolkit.Maui.Sample.ViewModels.Converters;
+
+public class IsStringNullOrEmptyConverterViewModel : BaseViewModel
+{
+	string? labelText;
+
+	public string? LabelText
+	{
+		get => labelText;
+		set => SetProperty(ref labelText, value);
+	}
+}

src/CommunityToolkit.Maui.UnitTests/Converters/IsStringNotNullOrEmptyConverter_Tests.cs

@@ -0,0 +1,33 @@
+using System.Globalization;
+using CommunityToolkit.Maui.Converters;
+using Xunit;
+
+namespace CommunityToolkit.Maui.UnitTests.Converters;
+
+public class IsStringNotNullOrEmptyConverter_Tests : BaseTest
+{
+	[Theory]
+	[InlineData("Test", true)]
+	[InlineData(null, false)]
+	[InlineData("", false)]
+	[InlineData(" ", true)]
+	public void IsNotNullOrEmptyConverter_ValidStringValue(string? value, bool expectedResult)
+	{
+		var isNotNullOrEmptyConverter = new IsStringNotNullOrEmptyConverter();
+
+		var result = (bool)isNotNullOrEmptyConverter.Convert(value, null, null, null);
+
+		Assert.Equal(expectedResult, result);
+	}
+
+	[Theory]
+	[InlineData(17)]
+	[InlineData(true)]
+	[InlineData('c')]
+	public void IsNotNullOrEmptyConverter_InvalidValue(object value)
+	{
+		var isNotNullOrEmptyConverter = new IsStringNotNullOrEmptyConverter();
+
+		Assert.Throws<InvalidCastException>(() => isNotNullOrEmptyConverter.Convert(value, null, null, null));
+	}
+}