Extensões SemanticProperties

As extensões SemanticProperties fornecem uma série de métodos de extensão que dão suporte à definição de configurações relacionadas à acessibilidade.

As propriedades semânticas são usadas para definir informações sobre quais controles devem receber o foco de acessibilidade e qual texto deve ser lido em voz alta para o usuário. As propriedades semânticas são propriedades anexadas que podem ser adicionadas a qualquer elemento para definir as APIs de acessibilidade da plataforma subjacente.

Para obter mais informações sobre SemanticProperties e acessibilidade, veja a documentação do .NET MAUI.

Para obter informações sobre outras extensões relacionadas à acessibilidade, veja as extensões AutomationProperties.

SemanticDescription

O método SemanticDescription define uma cadeia de caracteres curta e descritiva que o leitor de tela das plataformas usa para anunciar o BindableObject.

O seguinte exemplo demonstra como definir a descrição em uma nova Entry:

new Entry().SemanticDescription("Enter your username.");

SemanticHeadingLevel

O método SemanticDescription define um nível de título para permitir que o BindableObject seja marcado como um título, a fim de organizar a interface do usuário e facilitar a navegação para o leitor de tela da plataforma.

O seguinte exemplo demonstra como definir o nível de título em uma nova Entry:

new Entry().SemanticHeadingLevel(SemanticHeadingLevel.Level5);

Importante

Nem todas as plataformas dão suporte a todos os valores de SemanticHeadingLevel. Veja a documentação do .NET MAUI para obter mais informações.

SemanticHint

O método SemanticHint define um contexto adicional para aquele definido em SemanticDescription, como a finalidade do BindableObject.

O seguinte exemplo demonstra como definir a dica em uma nova Entry:

new Entry().SemanticHint("The username field used to create a new account. This is a required field.");