ca.whittaker.Maui.Controls 1.0.7

Additional Details

This initial 1.0 version should have been labelled as "beta" however this was my first Nuget package I have ever published, and was unfamiliar with how quickly and easily new packages are made available.   Please use 2.0 onwards version 1.0 is considered beta/alpha.

There is a newer version of this package available.
See the version list below for details.
dotnet add package ca.whittaker.Maui.Controls --version 1.0.7                
NuGet\Install-Package ca.whittaker.Maui.Controls -Version 1.0.7                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ca.whittaker.Maui.Controls" Version="1.0.7" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ca.whittaker.Maui.Controls --version 1.0.7                
#r "nuget: ca.whittaker.Maui.Controls, 1.0.7"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install ca.whittaker.Maui.Controls as a Cake Addin
#addin nuget:?package=ca.whittaker.Maui.Controls&version=1.0.7

// Install ca.whittaker.Maui.Controls as a Cake Tool
#tool nuget:?package=ca.whittaker.Maui.Controls&version=1.0.7                

MAUI Controls

Form

  • Incorporates TextBox and CheckBox.
  • Integrates Save and Cancel buttons automatically.

TextBox

  • Types:
    • Text
    • Email
    • Url
    • Chat
    • Username
  • Filtering Options:
    • AllLowerCase
    • AllowWhiteSpace
    • Mandatory
  • Built-in Functionalities:
    • "Undo" button for reverting text entries.
    • Label for descriptions or titles.
    • Notification message area for displaying input-related messages.
CheckBox (Planned)

A future addition to enhance the Form control collection.

Button embedded graphics by class

Button Class enabled disabled
CancelButton alt text alt text
UndoButton alt text alt text
SaveButton alt text alt text
SigninButton alt text alt text
SignoutButton alt text alt text

SigninButton class specialized types

SigninButtonType enabled disabled
Tiktok alt text alt text
Facebook alt text alt text
Google alt text alt text
Microsoft alt text alt text
Apple alt text alt text

Note: Buttons include embedded graphic icons for specific purposes, with "enabled" and "disabled" state graphics to reflect the button's active state in relation to its environment.

This comprehensive structure offers a detailed view of the enhanced functionalities and user interaction mechanisms in the custom MAUI application, focusing on form management and control interactions.

Usage

To integrate the Form class into your .NET MAUI application, follow these steps:

Step 1. Adding the Form to Your View

Incorporate the Form class in your XAML where you need a form. Make sure to reference the namespace ca.whittaker.Maui.Controls.Forms.

XAML Example:

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:forms="ca.whittaker.Maui.Controls.Forms"
             x:Class="YourNamespace.YourPage">
    <forms:Form x:Name="myForm"/>
</ContentPage>

Step 2. Configuring the Form

You can configure various aspects of the form directly in XAML. Set properties such as FormName, FormSaveButtonText, and FormCancelButtonText to customize the form's appearance and behavior.

Example of Setting Properties:

<forms:Form x:Name="myForm"
            FormName="User Details"
            FormSaveButtonText="Submit"
            FormCancelButtonText="Reset" />

Step 3. Binding Commands and Parameters

Bind commands and parameters to handle actions like saving data or canceling the form operation. Use the Command and CommandParameter properties for this purpose.

Example of Command Binding:

<forms:Form x:Name="myForm"
            Command="{Binding SaveCommand}"
            CommandParameter="" />

Step 4. Customizing Appearance

Customize the appearance of the form by setting properties like FormNameTextColor and FormSize.

Example of Customizing Appearance:

<forms:Form x:Name="myForm"
            FormNameTextColor="Blue"
            FormSize="Large" />

By following these steps, you can effectively incorporate and customize the Form class in your .NET MAUI application using XAML.

Step 5. Adding the Form to Your View

Incorporate the Form class in your XAML where you need a form. Make sure to reference the namespace ca.whittaker.Maui.Controls.Forms.

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:forms="ca.whittaker.Maui.Controls.Forms"
             x:Class="YourNamespace.YourPage">
    <forms:Form x:Name="myForm"/>
</ContentPage>

Author

Brett Whittaker - brett@whittaker.ca

Product Compatible and additional computed target framework versions.
.NET net8.0-android34.0 is compatible.  net8.0-ios17.0 is compatible.  net8.0-maccatalyst17.0 is compatible.  net8.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
2.0.2 188 12/27/2023
2.0.1 148 12/9/2023
2.0.0 115 12/6/2023
1.0.8 136 12/1/2023 1.0.8 is deprecated.
1.0.7 140 11/30/2023 1.0.7 is deprecated.
1.0.6 123 11/29/2023 1.0.6 is deprecated.
1.0.5 139 11/29/2023 1.0.5 is deprecated.
1.0.4 126 11/28/2023 1.0.4 is deprecated.
1.0.3 108 11/28/2023 1.0.3 is deprecated.