GravatarImageSource

Un Gravatar (avatar mondialement reconnu) est une image qui peut être utilisée sur plusieurs sites web en tant qu’avatar, c’est-à-dire en tant qu’image qui vous représente. Par exemple, un Gravatar peut identifier une personne dans un billet de forum, dans un commentaire de blog, et ainsi de suite. (Vous pouvez inscrire votre propre Gravatar sur le site web Gravatar à l’adresse http://www.gravatar.com/.) Si vous souhaitez afficher des images en regard des noms ou adresses e-mail des personnes, vous pouvez utiliser GravatarImageSource.

Syntaxe

Y compris l’espace de noms XAML

Pour utiliser le kit de ressources dans XAML, le xmlns suivant doit être ajouté à votre page ou à votre affichage :

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

Il en résulte ce qui suit :

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

Serait modifié pour inclure le xmlns de la manière suivante :

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

GravatarImageSource

L'exemple suivant montre comment utiliser 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>

Le code C# équivalent est :

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

Propriétés

Ces propriétés sont sauvegardées par des objets BindableProperty, ce qui signifie qu’elles peuvent être des cibles de liaisons de données et de style.

Définir la validité du cache

La propriété CacheValidity, de type TimeSpan, spécifie la durée pendant laquelle l’image sera stockée localement.

L’exemple suivant définit la validité du cache d’un GravatarImageSource :

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

Le code C# équivalent est :

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

Définir la mise en cache activée

La propriété CachingEnabled, de type bool, définit si la mise en cache d’images est activée.

L’exemple suivant définit la mise en cache activée pour un GravatarImageSource :

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

Le code C# équivalent est :

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

Configurer l’adresse e-mail

La propriété Email est de type string nullable. Si la propriété est nulle ou vide, l’image Gravatar par défaut s’affiche. Si l’adresse e-mail n’a pas d’image Gravatar correspondante, l’image de la propriété Image s’affiche.

L’exemple suivant définit une adresse e-mail qui a une image Gravatar correspondante :

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

Le code C# équivalent est :

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

L’exemple suivant ne définit pas d’adresse e-mail et affiche donc l’image Gravatar par défaut.

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

Le code C# équivalent est :

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

L’exemple suivant définit une adresse e-mail qui n’a aucune image Gravatar correspondante et affiche donc l’image par défaut Image.

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

Le code C# équivalent est :

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

Définir l’image par défaut

La propriété Image est une énumération utilisée pour spécifier l’image par défaut si l’adresse email n’a pas d’image Gravatar correspondante. Les options disponibles sont les suivantes :

• MysteryPerson (valeur par défaut) : contour simple et style animé d’une personne (ne varie pas selon le hachage de l’e-mail)
• FileNotFound : ne chargez aucune image si aucune n’est associée au hachage de l’e-mail, renvoyez plutôt une réponse HTTP 404 (fichier introuvable).
• Identicon : un modèle géométrique basé sur le hachage de l’e-mail.
• MonsterId : un « monstre » généré avec différentes couleurs, différents visages, etc.
• Wavatar : des visages générés avec différentes fonctionnalités et arrière-plans.
• Retro : des visages pixelisés géniaux générés dans le style arcade 8 bits.
• Robohash : un robot généré avec différentes couleurs, différents visages, etc.
• Blank : une image PNG transparente.

L’exemple suivant définit l’image par défaut d’un GravatarImageSource :

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

Le code C# équivalent est :

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

Définir la taille de l’image

Par défaut, les images GravatarImageSource sont présentées en 80px par 80px. Les tailles d’image peuvent être comprises entre 1px et 2048px et sont extraites de leurs propriétés de taille de vue parente. Les images Gravatar sont carrées, et la plus grande des propriétés de taille définies sera prise.

L’exemple suivant définit la taille du contrôle d’image et, par conséquent, la taille de l’image Gravatar demandée sera de 73px.

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

Le code C# équivalent est :

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

Exemples

Vous trouverez des exemples de ce contrôle en action dans l’Exemple d’application du kit d’outils de la communauté .NET MAUI.

API

Vous pouvez trouver le code source deGravatarImageSource sur le référentiel du kit de ressources de la communauté .NET MAUI sur GitHub.