Share via

GravatarImageSource

  • 아티클

Gravatar("전역적으로 인식되는 아바타")는 여러 웹 사이트에서 아바타로 사용할 수 있는 이미지입니다. 즉, 당신을 나타내는 이미지입니다. 예를 들어 Gravatar는 포럼 게시물, 블로그 댓글 등에서 사람을 식별할 수 있습니다. (.) Gravatar 웹 사이트에서 http://www.gravatar.com/자신의 Gravatar를 등록할 수 있습니다. 사용자의 이름 또는 전자 메일 주소 옆에 이미지를 표시하려면 GravatarImageSource를 사용할 수 있습니다.

구문

XAML 네임스페이스 포함

XAML에서 도구 키트를 사용하려면 페이지 또는 보기에 다음 xmlns 을 추가해야 합니다.

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

따라서 다음을 수행합니다.

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

다음과 같이 포함 xmlns 하도록 수정됩니다.

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

다음 예제에서는 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>

해당하는 C# 코드는 다음과 같습니다.

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

속성

속성 Type 설명
CacheValidity TimeSpan 형식TimeSpan의 속성은 CacheValidity 이미지를 로컬로 저장할 기간을 지정합니다. 이 속성의 기본값은 1일입니다.
CachingEnabled bool 형식bool의 속성은 CachingEnabled 이미지 캐싱을 사용할 수 있는지 여부를 정의합니다. 이 속성의 기본값은 true입니다.
전자 메일 string? 형식string?의 속성은 Email gravatar 계정 전자 메일 주소를 지정합니다. 설정되지 않은 경우 Gravatar 이미지가 렌더링됩니다. Gravatar Image 에서 설정되고 찾을 수 없는 경우 속성 이미지가 렌더링됩니다.
이미지 DefaultImage Image 형식 DefaultImage 의 속성은 Gravatar에서 기본 이미지를 찾을 수 없는 경우 email 기본 이미지를 지정하는 데 사용되는 열거형입니다.

이러한 속성은 개체에 의해 BindableProperty 지원되므로 데이터 바인딩의 대상이 될 수 있으며 스타일이 지정될 수 있습니다.

캐시 유효성 설정

이 속성은 CacheValidity 이미지를 로컬로 TimeSpan 저장할 기간을 지정하는 속성입니다.

다음 예제에서는 캐시 유효성을 설정합니다.GravatarImageSource

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

해당하는 C# 코드는 다음과 같습니다.

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

캐싱 사용 설정

이 CachingEnabled 속성은 bool 이미지 캐싱을 사용할 수 있는지 여부를 정의하는 속성입니다.

다음 예제에서는 캐싱을 사용하도록 설정합니다.GravatarImageSource

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

해당하는 C# 코드는 다음과 같습니다.

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

전자 메일 설정

이 속성은 Email nullable string입니다. 속성이 null이거나 비어 있으면 기본 Gravatar 이미지가 렌더링됩니다. 전자 메일 주소에 일치하는 Gravatar 이미지가 Image 없으면 속성 이미지가 렌더링됩니다.

다음 예제에서는 일치하는 Gravatar 이미지가 있는 전자 메일 주소를 설정합니다.

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

해당하는 C# 코드는 다음과 같습니다.

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

다음 예제에서는 전자 메일 주소를 설정하지 않으므로 기본 Gravatar 이미지를 표시합니다.

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

해당하는 C# 코드는 다음과 같습니다.

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

다음은 일치하는 Gravatar 이미지가 없는 전자 메일 주소를 설정하여 기본 Image 이미지를 표시하는 예제입니다.

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

해당하는 C# 코드는 다음과 같습니다.

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

기본 이미지 설정

이 Image 속성은 주소에 일치하는 Gravatar 이미지가 없는 경우 email 기본 이미지를 지정하는 데 사용되는 열거형입니다. 사용 가능한 옵션은 다음과 같습니다.

  • MysteryPerson (기본값) - 사람의 간단한 만화 스타일의 실루엣 윤곽선 (이메일 해시에 따라 달라지지 않음)
  • FileNotFound - 전자 메일 해시와 연결된 이미지가 없는 경우 이미지를 로드하지 말고 대신 HTTP 404(파일을 찾을 수 없음) 응답을 반환합니다.
  • Identicon - 이메일 해시를 기반으로 하는 기하학적 패턴입니다.
  • MonsterId - 다양한 색상, 얼굴 등을 가진 생성된 '괴물'입니다.
  • Wavatar - 특징과 배경이 다른 생성된 얼굴입니다.
  • Retro - 멋진 생성, 8 비트 아케이드 스타일의 픽실화 얼굴.
  • Robohash - 다양한 색상, 얼굴 등을 가진 생성된 로봇
  • Blank - 투명한 PNG 이미지입니다.

다음 예제에서는 기본 이미지를 설정합니다.GravatarImageSource

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

해당하는 C# 코드는 다음과 같습니다.

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

이미지 크기 설정

기본적으로 GravatarImageSource 이미지는 80px x 80px로 표시됩니다. 이미지 크기는 1px에서 2048px 사이일 수 있으며 부모 보기 크기 속성에서 가져옵니다. Gravatar 이미지는 정사각형이며 정의된 크기 속성의 큰 크기가 촬영됩니다.

다음 예제에서는 이미지 컨트롤의 크기를 설정하므로 요청된 Gravatar 이미지의 크기는 73px입니다.

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

해당하는 C# 코드는 다음과 같습니다.

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

예제

.NET MAUI 커뮤니티 도구 키트 샘플 애플리케이션에서 작동 중인 이 컨트롤의 예제를 찾을 수 있습니다.

API

.NET MAUI 커뮤니티 도구 키트 GitHub 리포지토리에서 오버에 대한 GravatarImageSource 소스 코드를 찾을 수 있습니다.