SemanticOrderView

화면 SemanticOrderView 읽기 프로그램의 VisualElements 순서를 제어하고 애플리케이션의 접근성을 개선하는 기능을 제공합니다. 이는 사용자 및 화면 읽기 프로그램이 탐색할 순서와 다른 순서로 사용자 인터페이스를 빌드할 때 특히 유용할 수 있습니다.

SemanticOrderView 사용

다음 예제에서는 화면 읽기 프로그램이 사용자 인터페이스에 추가되는 순서에서 벗어나 요소를 알리는 순서를 변경할 수 있는 방법을 SemanticOrderView 보여 줍니다. 아래 XAML은 설명을 렌더링한 후DescriptionLabel 제목을 렌더링하는 것을 보여 TitleLabel 줍니다. 즉, 제목 앞에 설명이 시각적으로 표시됩니다. 누군가가 그것을 볼 때 의미가 있을 수 있지만, 시각 장애가 있고 화면을 완전히 보지 못하는 사람에게는 반드시 의미가 있는 것은 아닙니다.

<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.Views.SemanticOrderViewPage"
    Title="Semantic Order View">
    <ContentPage.Content>
        <toolkit:SemanticOrderView x:Name="SemanticOrderView">
            <Grid RowDefinitions="2*,*">
                
                <Label x:Name="DescriptionLabel" Text="{Binding Description}" />

                <Label x:Name="TitleLabel" Text="{Binding Title}" FontSize="30" />

            </Grid>
        </toolkit:SemanticOrderView>
    </ContentPage.Content>
</ContentPage>

이를 위해 코드 숨김 파일에서 다음과 같이 디바이스의 화면 읽기 프로그램에서 사용할 순서를 변경할 수 있습니다.

using System.Collections.Generic;

namespace CommunityToolkit.Maui.Sample.Pages.Views;

public partial class SemanticOrderViewPage : ContentPage
{
    public SemanticOrderViewPage()
    {
        InitializeComponent();

        this.SemanticOrderView.ViewOrder = new List<View> { TitleLabel, DescriptionLabel };
    }
}

이를 SemanticOrderView 통해 화면 읽기 프로그램 소프트웨어를 통해 액세스할 때 이러한 컨트롤에 대한 "적절한" 순서는 먼저 포커스를 TitleLabel 지정한 다음 DescriptionLabel집중합니다.

예제

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

API

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