Princípios para melhorar a acessibilidade do app

Para ajudar os usuários com necessidades de acessibilidade, o framework do Android permite que você criar um serviço de acessibilidade que possa apresentar conteúdo de aplicativos aos usuários e também operar apps em nome deles.

O Android fornece vários serviços de acessibilidade do sistema, incluindo:

• TalkBack: ajuda pessoas com baixa visão ou cegas. Ela anuncia o conteúdo por meio de uma voz sintetizada e realiza ações em um aplicativo em resposta a gestos do usuário.
• Acesso com interruptor: ajuda pessoas com deficiência motora. Ele destaca elementos interativos e realiza ações em resposta quando o usuário pressiona um botão. Ela permite o dispositivo usando apenas um ou dois botões.

Para ajudar pessoas com necessidades de acessibilidade a usar seu app, o deve seguir as práticas recomendadas descritas nesta página, que se baseiam em as diretrizes descritas em Tornar os apps mais acessíveis.

Cada uma dessas práticas recomendadas, descritas nas seções a seguir, pode melhorar ainda mais a acessibilidade do seu app:

Elementos de etiqueta

Os usuários precisam ser capazes de entender o conteúdo e o propósito de cada interação. e significativo dentro do seu app.

Adicionar ações de acessibilidade

Ao adicionar ações de acessibilidade, você pode capacitar os usuários da acessibilidade para concluir fluxos de usuários essenciais no seu app.

Estender widgets do sistema

Crie com base nos elementos de visualização que o framework inclui, em vez de criar visualizações personalizadas. As classes de visualização e widget do framework já oferecem a maioria dos recursos de acessibilidade necessários para seu app.

Usar outras indicações além da cor

Os usuários precisam conseguir distinguir claramente as categorias de elementos uma interface. Para fazer isso, use padrões e posicionamento junto à cor para expressar essas diferenças.

Tornar o conteúdo de mídia mais acessível

Adicione descrições ao conteúdo de vídeo ou áudio do seu app para que os usuários que consomem esse conteúdo não precisam depender de pistas totalmente visuais ou auditivas.

Elementos de etiqueta

É importante fornecer aos usuários marcadores úteis e descritivos para cada elemento de interface interativo do seu app. Cada rótulo deve explicar o significado e a finalidade de um elemento específico. Leitores de tela como o TalkBack podem anunciar esses rótulos aos usuários.

Na maioria dos casos, a descrição de um elemento da interface é especificada no layout arquivo de recurso que contém o elemento. Normalmente, você adiciona rótulos usando o atributo contentDescription, conforme explicado no guia para criar apps mais acessíveis. há várias outras técnicas de rotulagem descritas nas seções a seguir.

Elementos editáveis

Ao rotular elementos editáveis, como objetos EditText, é útil mostrar texto que dê um exemplo de entrada válida no próprio elemento, além de disponibilizando esse texto de exemplo para leitores de tela. Nessas situações, é possível usar o atributo android:hint, como mostrado no snippet a seguir:

<!-- The hint text for en-US locale would be
     "Apartment, suite, or building". -->
<EditText
   android:id="@+id/addressLine2"
   android:hint="@string/aptSuiteBuilding" ... />

Nessa situação, o objeto View precisa ter o atributo android:labelFor. Defina como o ID do elemento EditText. Para mais detalhes, consulte as nesta seção.

Pares de elementos em que um descreve o outro

É comum que um elemento EditText tenha um Objeto View que descreve o que os usuários precisam insira no elemento EditText. Você pode indicar essa relação definindo o atributo android:labelFor do objeto View.

Um exemplo de classificação desses pares de elementos aparece no snippet a seguir:

<!-- Label text for en-US locale would be "Username:" -->
<TextView
   android:id="@+id/usernameLabel" ...
   android:text="@string/username"
   android:labelFor="@+id/usernameEntry" />

<EditText
   android:id="@+id/usernameEntry" ... />

<!-- Label text for en-US locale would be "Password:" -->
<TextView
   android:id="@+id/passwordLabel" ...
   android:text="@string/password
   android:labelFor="@+id/passwordEntry" />

<EditText
   android:id="@+id/passwordEntry"
   android:inputType="textPassword" ... />

Elementos em uma coleção

Ao adicionar rótulos aos elementos de uma coleção, cada rótulo precisa ser exclusivo. Dessa forma, os serviços de acessibilidade do sistema podem se referir a apenas um ao anunciar um rótulo. Essa correspondência permite que os usuários saibam quando eles alternam pela IU ou quando movem o foco para um elemento que que eles já descobriram.

Especificamente, inclua texto adicional ou informações contextuais na elementos em layouts reutilizados, como RecyclerView para que cada elemento filho seja identificado de forma exclusiva.

Para fazer isso, defina a descrição do conteúdo como parte da implementação do adaptador, conforme mostrado no snippet de código a seguir:

data class MovieRating(val title: String, val starRating: Integer)

class MyMovieRatingsAdapter(private val myData: Array<MovieRating>):
        RecyclerView.Adapter<MyMovieRatingsAdapter.MyRatingViewHolder>() {

    class MyRatingViewHolder(val ratingView: ImageView) :
            RecyclerView.ViewHolder(ratingView)

    override fun onBindViewHolder(holder: MyRatingViewHolder, position: Int) {
        val ratingData = myData[position]
        holder.ratingView.contentDescription = "Movie ${position}: " +
                "${ratingData.title}, ${ratingData.starRating} stars"
    }
}

public class MovieRating {
    private String title;
    private int starRating;
    // ...
    public String getTitle() { return title; }
    public int getStarRating() { return starRating; }
}

public class MyMovieRatingsAdapter
        extends RecyclerView.Adapter<MyAdapter.MyRatingViewHolder> {
    private MovieRating[] myData;


    public static class MyRatingViewHolder extends RecyclerView.ViewHolder {
        public ImageView ratingView;
        public MyRatingViewHolder(ImageView iv) {
            super(iv);
            ratingView = iv;
        }
    }

    @Override
    public void onBindViewHolder(MyRatingViewHolder holder, int position) {
        MovieRating ratingData = myData[position];
        holder.ratingView.setContentDescription("Movie " + position + ": " +
                ratingData.getTitle() + ", " + ratingData.getStarRating() +
                " stars")
    }
}

Grupos de conteúdo relacionado

Caso seu app exiba vários elementos de IU que formam um grupo natural, como detalhes de uma música ou atributos de uma mensagem, organize esses elementos em um contêiner, que geralmente é uma subclasse de ViewGroup. Defina o atributo android:screenReaderFocusable do objeto de contêiner como true e o atributo android:focusable de cada objeto interno como false. Dessa forma, os serviços de acessibilidade podem apresentar elementos descrições de conteúdo, uma após a outra, em um único anúncio. Essa consolidação de elementos relacionados ajuda os usuários de tecnologia assistiva a descobrir as informações na tela de forma mais eficiente.

O snippet a seguir contém partes de conteúdo relacionadas a um outro, de modo que o elemento de contêiner, uma instância de ConstraintLayout, tenha o O atributo android:screenReaderFocusable foi definido como true, e o Cada elemento TextView tem o atributo android:focusable definido como false:

<!-- In response to a single user interaction, accessibility services announce
     both the title and the artist of the song. -->
<ConstraintLayout
    android:id="@+id/song_data_container" ...
    android:screenReaderFocusable="true">

    <TextView
        android:id="@+id/song_title" ...
        android:focusable="false"
        android:text="@string/my_song_title" />
    <TextView
        android:id="@+id/song_artist"
        android:focusable="false"
        android:text="@string/my_songwriter" />
</ConstraintLayout>

Como os serviços de acessibilidade anunciam as descrições dos elementos internos em uma única expressão, é importante manter cada descrição o mais curta possível, sem deixar de transmitir o significado do elemento.

Grupos aninhados

Se a interface do seu app apresentar informações multidimensionais, como uma lista diária de eventos do festival, use o android:screenReaderFocusable nos contêineres do grupo interno. Esse esquema de rotulagem oferece uma boa equilibrar o número de anúncios necessários para descobrir o conteúdo e a duração de cada anúncio.

O snippet de código a seguir mostra um método para classificar grupos dentro de outros maiores:

<!-- In response to a single user interaction, accessibility services
     announce the events for a single stage only. -->
<ConstraintLayout
    android:id="@+id/festival_event_table" ... >
    <ConstraintLayout
        android:id="@+id/stage_a_event_column"
        android:screenReaderFocusable="true">

        <!-- UI elements that describe the events on Stage A. -->

    </ConstraintLayout>
    <ConstraintLayout
        android:id="@+id/stage_b_event_column"
        android:screenReaderFocusable="true">

        <!-- UI elements that describe the events on Stage B. -->

    </ConstraintLayout>
</ConstraintLayout>

Títulos no texto

Alguns apps usam títulos para resumir grupos de texto que aparecem na tela. Se determinado elemento View representa um título, você pode indicar a finalidade dele para os serviços de acessibilidade definindo o atributo android:accessibilityHeading do elemento como true.

Os usuários de serviços de acessibilidade podem optar por navegar entre títulos em vez de entre parágrafos ou palavras. Essa flexibilidade melhora a experiência de navegação de texto.

Títulos do painel de acessibilidade

No Android 9 (API nível 28) ou versões mais recentes, você pode fornecer títulos de fácil acessibilidade para os painéis de uma tela. Para fins de acessibilidade, um painel é uma parte visualmente distinta de uma janela, como o conteúdo de um fragmento. Para que os serviços de acessibilidade entendam semelhante a janelas, dê títulos descritivos painéis. Os serviços de acessibilidade podem oferecer informações mais detalhadas aos usuários quando a aparência ou o conteúdo de um painel muda.

Para especificar o título de um painel, use o atributo android:accessibilityPaneTitle, conforme mostrado no snippet a seguir:

<!-- Accessibility services receive announcements about content changes
     that are scoped to either the "shopping cart view" section (top) or
     "browse items" section (bottom) -->
<MyShoppingCartView
     android:id="@+id/shoppingCartContainer"
     android:accessibilityPaneTitle="@string/shoppingCart" ... />

<MyShoppingBrowseView
     android:id="@+id/browseItemsContainer"
     android:accessibilityPaneTitle="@string/browseProducts" ... />

Elementos decorativos

Se um elemento na sua IU existir apenas para fins de espaçamento visual ou aparência, defina o atributo android:importantForAccessibility como "no".

Adicionar ações de acessibilidade

É importante permitir que os usuários dos serviços de acessibilidade realizem facilmente todas os fluxos de usuários no seu app. Por exemplo, se um usuário puder deslizar sobre um item de uma essa ação também pode ser exposta a serviços de acessibilidade para que os usuários tenham uma maneira alternativa de completar o mesmo fluxo de usuário.

Tornar todas as ações acessíveis

Um usuário do TalkBack, do Acesso por voz, ou o acesso com interruptor pode precisar de formas alternativas para concluir determinados fluxos de usuários dentro o app. Para ações associadas a gestos, como arrastar e soltar ou deslizar, seu aplicativo pode expor as ações de uma forma acessível aos usuários de serviços de acessibilidade.

Com as ações de acessibilidade, o app pode oferecer maneiras alternativas para os usuários concluírem uma ação.

Por exemplo, se o app permite que os usuários deslizem em um item, você também pode expor a funcionalidade com uma ação de acessibilidade personalizada, como esta:

ViewCompat.addAccessibilityAction(
    // View to add accessibility action
    itemView,
    // Label surfaced to user by an accessibility service
    getText(R.id.archive)
) { _, _ ->
    // Same method executed when swiping on itemView
    archiveItem()
    true
}

ViewCompat.addAccessibilityAction(
    // View to add accessibility action
    itemView,
    // Label surfaced to user by an accessibility service
    getText(R.id.archive),
    (view, arguments) -> {
        // Same method executed when swiping on itemView
        archiveItem();
        return true;
    }
);

With the custom accessibility action implemented, users can access the action through the actions menu.

Make available actions understandable

When a view supports actions such as touch & hold, an accessibility service such as TalkBack announces it as "Double tap and hold to long press."

This generic announcement doesn't give the user any context about what a touch & hold action does.

To make this announcement more descriptive, you can replace the accessibility action’s announcement like so:

ViewCompat.replaceAccessibilityAction(
    // View that contains touch & hold action
    itemView,
    AccessibilityNodeInfoCompat.AccessibilityActionCompat.ACTION_LONG_CLICK,
    // Announcement read by TalkBack to surface this action
    getText(R.string.favorite),
    null
)

ViewCompat.replaceAccessibilityAction(
    // View that contains touch & hold action
    itemView,
    AccessibilityNodeInfoCompat.AccessibilityActionCompat.ACTION_LONG_CLICK,
    // Announcement read by TalkBack to surface this action
    getText(R.string.favorite),
    null
);

This results in TalkBack announcing "Double tap and hold to favorite," helping users understand the purpose of the action.

Extend system widgets

This section uses the example of implementing a special type of Switch called TriSwitch while following best practices around extending system widgets. A TriSwitch object works similarly to a Switch object, except that each instance of TriSwitch allows the user to toggle among three possible states.

Extend from far down the class hierarchy

The Switch object inherits from several framework UI classes in its hierarchy:

View
↳ TextView
  ↳ Button
    ↳ CompoundButton
      ↳ Switch

É melhor que a nova classe TriSwitch seja estendida diretamente da classe Switch. Dessa forma, a acessibilidade do Android modelo oferece a maioria dos recursos de acessibilidade da classe TriSwitch necessidades:

• Ações de acessibilidade:informações para o sistema sobre como a acessibilidade podem emular cada entrada possível do usuário realizada em um TriSwitch objeto. Configuração herdada de View.
• Eventos de acessibilidade:informações dos serviços de acessibilidade sobre cada forma como a aparência de um objeto TriSwitch pode mudar quando a tela atualizações ou atualizações. Configuração herdada de View.
• Características:detalhes sobre cada objeto TriSwitch, como conteúdo de qualquer texto exibido. Configuração herdada de TextView.
• Informações de estado:descrição do estado atual de um objeto TriSwitch. como "marcado" ou "desmarcada". Configuração herdada de CompoundButton.
• Descrição em texto do estado:explicação em texto sobre cada estado. representa. Configuração herdada de Switch.

Esse comportamento de Switch e suas superclasses é quase o mesmo comportamento para objetos TriSwitch. Portanto, sua implementação pode expandir o número de estados possíveis de dois para três.

Definir eventos personalizados

Ao estender um widget do sistema, você provavelmente muda um aspecto de como os usuários interagem com esse widget. É importante definir essas mudanças de interação para que os serviços de acessibilidade possam atualizar o widget do app como se o usuário interage diretamente com o widget.

Uma diretriz geral é que, para cada callback baseado em visualização que você substituir, você também precisa redefinir a ação de acessibilidade correspondente substituindo ViewCompat.replaceAccessibilityAction() Nos testes do app, você pode validar o comportamento dessas ações redefinidas chamando ViewCompat.performAccessibilityAction().

Como esse princípio funciona para objetos TriSwitch

Ao contrário de um objeto Switch comum, tocar em um objeto TriSwitch percorre três estados possíveis. Portanto, a ação de acessibilidade ACTION_CLICK correspondente precisa ser atualizada:

class TriSwitch(context: Context) : Switch(context) {
    // 0, 1, or 2
    var currentState: Int = 0
        private set

    init {
        updateAccessibilityActions()
    }

    private fun updateAccessibilityActions() {
        ViewCompat.replaceAccessibilityAction(this, ACTION_CLICK,
            action-label) {
            view, args -> moveToNextState()
        })
    }

    private fun moveToNextState() {
        currentState = (currentState + 1) % 3
    }
}

public class TriSwitch extends Switch {
    // 0, 1, or 2
    private int currentState;

    public int getCurrentState() {
        return currentState;
    }

    public TriSwitch() {
        updateAccessibilityActions();
    }

    private void updateAccessibilityActions() {
        ViewCompat.replaceAccessibilityAction(this, ACTION_CLICK,
            action-label, (view, args) -> moveToNextState());
    }

    private void moveToNextState() {
        currentState = (currentState + 1) % 3;
    }
}

Usar outras indicações além da cor

Para ajudar os usuários com deficiências visuais relacionadas a cores, use outros tipos de indicador para distinguir os elementos da IU nas telas do seu app. Essas técnicas podem incluem usar diferentes formas ou tamanhos, fornecer texto ou padrões visuais, ou adicionar retorno tátil com base em áudio ou toque para marcar os elementos diferenças.

A Figura 1 mostra duas versões de uma atividade. Uma versão usa somente cores para diferenciar duas ações possíveis em um fluxo de trabalho. A outra versão usa a prática recomendada de incluir formas e texto, além de cores, para destacar as diferenças entre as duas opções:

Tornar o conteúdo de mídia mais acessível

Se você estiver desenvolvendo um app que inclui conteúdo de mídia, como um trecho de vídeo ou gravação de áudio, faça o possível para ajudar os usuários com diferentes tipos de necessidades de acessibilidade a entender esse material. Em particular, recomendamos que você faça o seguinte:

• Inclua controles que permitam aos usuários pausar ou interromper a mídia, mudar o volume e alternar as legendas.
• Se um vídeo apresentar informações essenciais para a conclusão de um fluxo de trabalho, fornecer o mesmo conteúdo em um formato alternativo, como uma transcrição.

Outros recursos

Para saber mais sobre como tornar seu app mais acessível, consulte estes recursos extras:

Codelabs

• Como iniciar o Android acessibilidade

Postagens do blog

• Acessibilidade: você está atendendo todos os seus usuários? (em inglês)