Plugin.SegmentedControl.Maui
1.4.13
dotnet add package Plugin.SegmentedControl.Maui --version 1.4.13
NuGet\Install-Package Plugin.SegmentedControl.Maui -Version 1.4.13
<PackageReference Include="Plugin.SegmentedControl.Maui" Version="1.4.13" />
paket add Plugin.SegmentedControl.Maui --version 1.4.13
#r "nuget: Plugin.SegmentedControl.Maui, 1.4.13"
// Install Plugin.SegmentedControl.Maui as a Cake Addin #addin nuget:?package=Plugin.SegmentedControl.Maui&version=1.4.13 // Install Plugin.SegmentedControl.Maui as a Cake Tool #tool nuget:?package=Plugin.SegmentedControl.Maui&version=1.4.13
SegmentedControl for .NET MAUI
This library provides a segmented control for .NET MAUI apps using native platform APIs.
Download and Install Plugin.SegmentedControl.Maui
This library is available on NuGet: Plugin.SegmentedControl.Maui
Use the following command to install Plugin.SegmentedControl.Maui
using the NuGet package manager console:
PM> Install-Package Plugin.SegmentedControl.Maui
You can use this library in any .NET MAUI project compatible with .NET 8 and higher.
App Setup
This plugin provides an extension method for MauiAppBuilder
called UseSegmentedControl
, which ensures proper startup and initialization.
Call this method within your MauiProgram
just as demonstrated in the SegmentedControlDemoApp:
var builder = MauiApp.CreateBuilder()
.UseMauiApp<App>()
.UseSegmentedControl();
API Usage
The SegmentedControl
class provides several properties to customize its behavior and appearance. Below is a table detailing each property and its purpose.
Properties | Description |
---|---|
AutoDisconnectHandler |
Indicates whether the platform handler disconnects automatically. Default is true . |
Children |
A list of SegmentedControlOption objects representing each segment. |
ItemsSource |
The source of data for generating segments. |
TextPropertyName |
The name of the property to use for the segment's text when using a non-string ItemsSource . |
TextColor |
The color of the segment text. Default is Colors.Black . |
TintColor |
The color used to tint the control. Default is Colors.Blue . |
SelectedTextColor |
The color of the selected segment's text. Default is Colors.White . |
DisabledBackgroundColor |
The background color of the control when disabled. Default is Colors.Gray . |
DisabledTintColor |
The tint color of the control when disabled. Default is Colors.Gray . |
DisabledTextColor |
The text color of the segments when the control is disabled. Default is Colors.Gray . |
DisabledSelectedTextColor |
The text color of the selected segment when the control is disabled. Default is Colors.LightGray . |
BorderColor |
The color of the control's border. Defaults to the value of TintColor . |
BorderWidth |
The width of the control's border. Varies by platform; 1.0 on Android and 0.0 on others. |
SelectedSegment |
The index of the currently selected segment. Default is 0 . |
SelectedItem |
The currently selected item from the ItemsSource . |
SegmentSelectedCommand |
Command that is executed when a segment is selected. |
SegmentSelectedCommandParameter |
Parameter passed to the SegmentSelectedCommand . |
FontSize |
The size of the font used for the segment text. |
FontFamily |
The font family used for the segment text. |
FontAttributes |
Font attributes for the segment text, such as bold or italic. |
Contribution
Contributors welcome! If you find a bug or want to propose a new feature, feel free to do so by opening a new issue on GitHub.
Links
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-android34.0 is compatible. net8.0-browser was computed. net8.0-ios was computed. net8.0-ios17.0 is compatible. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Microsoft.Maui.Controls (>= 8.0.3)
- Microsoft.Maui.Controls.Compatibility (>= 8.0.3)
-
net8.0-android34.0
- Microsoft.Maui.Controls (>= 8.0.3)
- Microsoft.Maui.Controls.Compatibility (>= 8.0.3)
-
net8.0-ios17.0
- Microsoft.Maui.Controls (>= 8.0.3)
- Microsoft.Maui.Controls.Compatibility (>= 8.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.4.13 | 149 | 11/26/2024 |
1.4.9-pre | 77 | 11/20/2024 |
1.4.7-pre | 70 | 11/14/2024 |
1.4.6-pre | 106 | 11/11/2024 |
1.4.4 | 333 | 10/2/2024 |
1.3.25-pre | 91 | 10/1/2024 |
1.3.23-pre | 72 | 10/1/2024 |
1.3.22-pre | 71 | 9/30/2024 |
1.3.18-pre | 79 | 9/26/2024 |
1.3.16 | 169 | 9/14/2024 |
1.3.14-pre | 84 | 9/10/2024 |
1.3.13-pre | 89 | 9/10/2024 |
1.3.10-pre | 96 | 9/5/2024 |
1.3.8-pre | 71 | 9/1/2024 |
1.3.7 | 170 | 8/12/2024 |
1.3.3-pre | 109 | 8/12/2024 |
1.3.2-pre | 114 | 8/8/2024 |
1.3.1-pre | 88 | 8/1/2024 |
1.2.19 | 126 | 7/24/2024 |
1.0.18 | 114 | 7/16/2024 |
1.0.14 | 118 | 7/10/2024 |
1.0.8 | 106 | 7/5/2024 |
1.4
- Improved handling for automatic disconnect handler logic.
- Fix for Android segmented control stroke sizes.
1.3
- Bug fixes.
- Add support for AppShell apps.
1.2
- Children property is no longer public; use ItemsSource instead.
- Improved error handling in SegmentedControlOption.
- Several bug fixes and internal refactorings.
1.1
- Add new properties FontFamily, FontSize, FontAttributes.
1.0
- Initial release.