EmailValidationBehavior

EmailValidationBehavior è un oggetto Behavior che consente agli utenti di determinare se l'input di testo è un indirizzo di posta elettronica valido. Ad esempio, è Entry possibile applicare uno stile diverso a un controllo a seconda che venga specificato un indirizzo di posta elettronica valido o non valido. La convalida viene eseguita tramite un'espressione regolare utilizzata per verificare se l'input di testo è un indirizzo di posta elettronica valido.

Quando è associato a un oggetto InputView (ad esempio Entry, Editor, ecc.), EmailValidationBehavior cambierà la Tastiera predefinita, Keyboard.Default, in Keyboard.Email. Se per il InputView è stato specificato un Keyboard non predefinito, EmailValidationBehavior non modificherà il Keyboard.

Quando viene scollegato da un InputView, EmailValidationBehavior riporterà Keyboard.Email a Keyboard.Default. Se per InputView è stato specificato un Keyboard diverso da Keyboard.Email, EmailValidationBehavior non cambierà Keyboard durante il distacco.

Syntax

Gli esempi seguenti mostrano come aggiungere EmailValidationBehavior a un Entry e modificare TextColor a seconda che il testo immesso sia un indirizzo e-mail valido.

XAML

Inclusione del namespace XAML

Per usare il toolkit in XAML, è necessario aggiungere le informazioni seguenti xmlns nella pagina o nella visualizzazione:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

Di conseguenza:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Verrà modificato in modo da includere il xmlns come indicato di seguito:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Utilizzo di EmailValidationBehavior

Il EmailValidationBehavior può essere usato come segue in XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="CommunityToolkit.Maui.Sample.Pages.Behaviors.EmailValidationBehaviorPage">

    <ContentPage.Resources>
        <Style x:Key="InvalidEntryStyle" TargetType="Entry">
            <Setter Property="TextColor" Value="Red" />
        </Style>
        <Style x:Key="ValidEntryStyle" TargetType="Entry">
            <Setter Property="TextColor" Value="Green" />
        </Style>
    </ContentPage.Resources>

    <Entry>
        <Entry.Behaviors>
            <toolkit:EmailValidationBehavior 
                InvalidStyle="{StaticResource InvalidEntryStyle}"
                ValidStyle="{StaticResource ValidEntryStyle}"
                Flags="ValidateOnValueChanged" />
        </Entry.Behaviors>
    </Entry>

</ContentPage>

C#

Il EmailValidationBehavior può essere usato come indicato di seguito in C#:

class EmailValidationBehaviorPage : ContentPage
{
    public EmailValidationBehaviorPage()
    {
        var entry = new Entry();

        var validStyle = new Style(typeof(Entry));
        validStyle.Setters.Add(new Setter
        {
            Property = Entry.TextColorProperty,
            Value = Colors.Green
        });

        var invalidStyle = new Style(typeof(Entry));
        invalidStyle.Setters.Add(new Setter
        {
            Property = Entry.TextColorProperty,
            Value = Colors.Red
        });

        var emailValidationBehavior = new EmailValidationBehavior
        {
            InvalidStyle = invalidStyle,
            ValidStyle = validStyle,
            Flags = ValidationFlags.ValidateOnValueChanged
        };

        entry.Behaviors.Add(emailValidationBehavior);

        Content = entry;
    }
}

Linguaggio di markup C#

Il pacchetto CommunityToolkit.Maui.Markup offre un modo molto più conciso per usare questa Behavior in C#.

using CommunityToolkit.Maui.Markup;

class EmailValidationBehaviorPage : ContentPage
{
    public EmailValidationBehaviorPage()
    {
        Content = new Entry()
            .Behaviors(new EmailValidationBehavior
            {
                InvalidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Red),
                ValidStyle = new Style<Entry>(Entry.TextColorProperty, Colors.Green),
                Flags = ValidationFlags.ValidateOnValueChanged
            });
    }
}

La schermata seguente mostra il comportamento EmailValidationBehavior risultante su Android:

Proprietà

Proprietà di ValidationBehavior

Le proprietà seguenti vengono implementate nella classe base public abstract class ValidationBehavior:

Methods

Esempi

È possibile trovare un esempio di questo comportamento in azione nell'applicazione di esempio .NET MAUI Community Toolkit.

API

È possibile trovare il codice sorgente per EmailValidationBehavior nel repository .NET MAUI Community Toolkit GitHub.