Udostępnij za pośrednictwem

GravatarImageSource

Gravatar ("globalnie rozpoznawany awatar") to obraz, który może być używany na wielu stronach internetowych jako awatar — czyli obraz reprezentujący Ciebie. Na przykład Gravatar może zidentyfikować osobę we wpisie na forum, w komentarzu w blogu itd. (Możesz zarejestrować własny Gravatar na stronie Gravatar pod adresem http://www.gravatar.com/.) Jeśli chcesz wyświetlić obrazy obok nazwisk lub adresów e-mail osób, możesz użyć gravatarImageSource.

Składnia

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

W poniższym przykładzie pokazano, jak używać polecenia GravatarImageSource:

<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">
    <VerticalStackLayout>
        <Image>
            <Image.Source>
                <toolkit:GravatarImageSource
                    CacheValidity="1"
                    CachingEnabled="True"
                    Email="youremail@here.com"
                    Image="MysteryPerson" />
            </Image.Source>
        </Image>
    </VerticalStackLayout>
</ContentPage>

Równoważny kod języka C# to:

using CommunityToolkit.Maui.ImageSources;

partial class MyPage : ContentPage
{
	public MyPage()
	{
        Image myImage = new()
        {
            Source = new GravatarImageSource()
            {
                CacheValidity = TimeSpan.FromDays(1),
                CachingEnabled = true,
                Email = "youremail@here.com",
                Image= DefaultImage.MysteryPerson
            },
        };
		Content = myImage;
	}
}

Właściwości

Właściwości Type Opis
CacheValidity TimeSpan Właściwość CacheValidity typu TimeSpanokreśla, jak długo obraz będzie przechowywany lokalnie. Wartość domyślna tej właściwości to 1 dzień.
Buforowanie Enabled bool Właściwość CachingEnabled typu boolokreśla, czy buforowanie obrazów jest włączone. Wartość domyślna tej właściwości to true.
Email string? Właściwość Email typu string?określa adres e-mail konta gravatar. Jeśli obraz Gravatar nie jest zdenerwowany, jest renderowany. Jeśli ustawienie i nie zostanie znalezione w aplikacji Gravatar, Image obraz właściwości zostanie renderowany.
Obraz DefaultImage Właściwość Image typu DefaultImage to wyliczenie, które służy do określania obrazu domyślnego, jeśli email nie zostanie znaleziony na Gravatar.

Te właściwości są wspierane przez BindableProperty obiekty, co oznacza, że mogą być obiektami docelowymi powiązań danych i stylizowanymi.

Ustawianie ważności pamięci podręcznej

Właściwość CacheValidity jest właściwością określającą TimeSpan , jak długo obraz będzie przechowywany lokalnie.

W poniższym przykładzie ustawiono ważność pamięci podręcznej elementu GravatarImageSource:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource CacheValidity="1" />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        CacheValidity = TimeSpan.FromDays(1),
    },
};

Ustawianie włączonego buforowania

Właściwość CachingEnabled jest właściwością bool , która określa, czy buforowanie obrazów jest włączone.

Poniższy przykład ustawia buforowanie w celu włączenia dla elementu GravatarImageSource:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource CachingEnabled="True" />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        CachingEnabled = true,
    },
};

Ustawianie wiadomości e-mail

Właściwość Email jest dopuszczana stringdo wartości null. Jeśli właściwość ma wartość null lub jest pusta, domyślny obraz Gravatar jest renderowany. Jeśli adres e-mail nie ma pasującego obrazu Gravatar, Image obraz właściwości jest renderowany.

W poniższym przykładzie ustawiono adres e-mail z pasującym obrazem Gravatar:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource Email="dsiegel@avantipoint.com" />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "dsiegel@avantipoint.com",
    },
};

Poniższy przykład nie ustawia adresu e-mail i w ten sposób wyświetli domyślny obraz Gravatar.

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource(),
};

W poniższym przykładzie ustawiono adres e-mail, który nie ma pasującego obrazu Gravatar, a tym samym wyświetli obraz domyślny Image .

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource Email="notregistered@emailongravitar.com" />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "notregistered@emailongravitar.com",
    },
};

Ustaw obraz domyślny

Właściwość Image to wyliczenie, które służy do określania obrazu domyślnego, jeśli email adres nie ma pasującego obrazu Gravatar. Dostępne opcje:

  • MysteryPerson (ustawienie domyślne) — prosty, rysowany kontur osoby w stylu kreskówek (nie różni się skrótem wiadomości e-mail)
  • FileNotFound — Nie ładuj żadnego obrazu, jeśli żaden nie jest skojarzony z skrótem wiadomości e-mail, zamiast tego zwraca odpowiedź HTTP 404 (Nie znaleziono pliku).
  • Identicon - Wzór geometryczny na podstawie skrótu wiadomości e-mail.
  • MonsterId - Wygenerowany "potwór" o różnych kolorach, twarzach itp.
  • Wavatar — Generowane twarze z różnymi funkcjami i tłami.
  • Retro - Niesamowite wygenerowane, 8-bitowe pixilated twarze.
  • Robohash - Wygenerowany robot o różnych kolorach, twarzach itp.
  • Blank - Przezroczysty obraz PNG.

W poniższym przykładzie ustawiono domyślny obraz elementu GravatarImageSource:

<Image>
    <Image.Source>
        <toolkit:GravatarImageSource Email="notregistered@emailongravitar.com" Image="Retro" />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "notregistered@emailongravitar.com",
        Image = DefaultImage.Retro
    },
};

Ustawianie rozmiaru obrazu

Domyślnie GravatarImageSource obrazy są prezentowane na poziomie 80 pikseli przez 80 pikseli. Rozmiary obrazów mogą należeć do zakresu od 1px do 2048px i pochodzą z właściwości rozmiaru widoku nadrzędnego. Obrazy Gravatar są kwadratowe, a większe właściwości rozmiaru zdefiniowane zostaną wykonane.

W poniższym przykładzie ustawiono rozmiar kontrolki obrazu, a tym samym rozmiar żądanego obrazu Gravatar będzie wynosić 73 pikseli.

<Image WidthRequest="72" HeightRequest="73">
    <Image.Source>
        <toolkit:GravatarImageSource Email="dsiegel@avantipoint.com" />
    </Image.Source>
</Image>

Równoważny kod języka C# to:

Image myImage = new()
{
    Source = new GravatarImageSource()
    {
        Email = "dsiegel@avantipoint.com",
    },
    HeightRequest = 72,
    HeightRequest = 73,
};

Przykłady

Przykłady tej kontrolki można znaleźć w akcji w przykładowej aplikacji zestawu narzędzi .NET MAUI Community Toolkit.

interfejs API

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