MaskedBehavior

Jest MaskedBehavior to element Behavior , który umożliwia użytkownikowi zdefiniowanie maski wejściowej dla wprowadzania danych. Dodanie tego zachowania do kontrolki InputView (np. Entry) wymusi na użytkowniku tylko wprowadzanie wartości wejściowych pasujących do danej maski. Przykłady użycia obejmują dane wejściowe numeru karty kredytowej lub numeru telefonu.

Ważne

Zachowania zestawu narzędzi .NET MAUI Community Toolkit nie ustawiają BindingContext zachowania, ponieważ zachowania mogą być współużytkowane i stosowane do wielu kontrolek za pomocą stylów. Aby uzyskać więcej informacji, zobacz Zachowania maUI platformy .NET

Składnia

W poniższych przykładach pokazano, jak dodać element MaskedBehavior do elementu Entry , aby ułatwić użytkownikowi wprowadzenie 16-cyfrowego numeru karty kredytowej.

XAML

Dołączanie przestrzeni nazw XAML

Aby można było używać zestawu narzędzi w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:

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

W związku z tym następujące elementy:

<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>

Zostanie zmodyfikowana tak, aby zawierała następujące xmlns elementy:

<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>

Korzystanie z maskowanegobehavioru

Można MaskedBehavior go użyć w następujący sposób w języku 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.MaskedBehaviorPage">

    <Entry Keyboard="Numeric">
        <Entry.Behaviors>
            <toolkit:MaskedBehavior Mask="XXXX XXXX XXXX XXXX" />
        </Entry.Behaviors>
    </Entry>

</ContentPage>

C#

Można MaskedBehavior go użyć w następujący sposób w języku C#:

class MaskedBehaviorPage : ContentPage
{
    public MaskedBehaviorPage()
    {
        var entry = new Entry
        {
            Keyboard = Keyboard.Numeric
        };

        var behavior = new MaskedBehavior
        {
            Mask = "XXXX XXXX XXXX XXXX"
        };

        entry.Behaviors.Add(behavior);

        Content = entry;
    }
}

Znaczniki języka C#

Nasz CommunityToolkit.Maui.Markup pakiet zapewnia znacznie bardziej zwięzły sposób korzystania z niego Behavior w języku C#.

using CommunityToolkit.Maui.Markup;

class MaskedBehaviorPage : ContentPage
{
    public MaskedBehaviorPage()
    {
        Content = new Entry
        {
            Keyboard = Keyboard.Numeric
        }.Behaviors(new MaskedBehavior
        {
            Mask = "XXXX XXXX XXXX XXXX"
        });
    }
}

Poniższy zrzut ekranu przedstawia wynikowy element MaskedBehavior w systemie Android:

Niestandardowy znak monitu

Można zastąpić znak we Mask właściwości, która będzie widoczna dla użytkownika. Można to zmienić, ustawiając właściwość , która jest domyślnie ustawiona UnmaskedCharacter na 'X'. Na przykład jeśli konieczne było wyświetlenie elementu X między każdą grupą 4 cyfr w naszym 16-cyfrowym wpisie karty kredytowej, można użyć następujących elementów:

<Entry Keyboard="Numeric">
    <Entry.Behaviors>
        <toolkit:MaskedBehavior Mask="0000X0000X0000X0000" UnmaskedCharacter="0" />
    </Entry.Behaviors>
</Entry>

Właściwości

Właściwości	Type	Opis
Mask	string	Maska zgodna z wartością wejściową.
UnmaskedCharacter	char	Określa, który znak we Mask właściwości będzie widoczny i wprowadzony przez użytkownika.

Przykłady

Przykład tego zachowania można znaleźć w przykładzie przykładowym aplikacji zestawu narzędzi .NET MAUI Community Toolkit.

interfejs API

Kod źródłowy można MaskedBehavior znaleźć w repozytorium GitHub zestawu narzędzi .NET MAUI Community Toolkit.