Testo Focalizzabile

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Assicurati che gli elementi di testo siano raggiungibili da TalkBack

Not for use with personal data

WCAG 2.0 - 1.3.2 A Impact - Critical

Scopri come stiamo utilizzando l'intelligenza artificiale per questa regola!

Cosa Controlliamo

Tutti gli elementi che contengono testo dovrebbero essere focalizzabili per tecnologie assistive come TalkBack. Gli elementi di testo non devono essere nascosti alla tecnologia assistiva, in modo che gli utenti possano navigare e leggere il testo sullo schermo.

Esempio di Errore ❌

An Android product page where TalkBack only reaches two elements — 'Premium Headphones' and 'Add to Cart' — while the '$299.99' price and description text are outlined in red dashes, indicating TalkBack skips them

Il price and description text are hidden from assistive technology

TalkBack salta da „Cuffie Premium“ direttamente a „Aggiungi al Carrello“ — il prezzo e la descrizione non vengono mai annunciati

Gli utenti di lettori di schermo mancano informazioni critiche sul prodotto visualizzate sullo schermo

Esempio di Successo ✅

An Android product page where all four elements are numbered and outlined in blue: 'Premium Headphones' (1), '$299.99' (2), the description text (3), and 'Add to Cart' (4), indicating all are reachable by TalkBack

Tutti gli elementi di testo sono available to assistive technology e raggiungibili da TalkBack

TalkBack naviga attraverso tutti e quattro gli elementi in sequenza: intestazione, prezzo, descrizione e pulsante

Gli utenti di lettori di schermo ricevono tutte le informazioni sul prodotto in un ordine di lettura logico

A Colpo d'Occhio

  • Questa regola ha un impatto critico per gli utenti
  • Gli elementi di testo non devono essere nascosti alle tecnologie assistive affinché TalkBack possa leggerli
  • In XML, non impostare importantForAccessibility="no" sugli elementi di testo
  • In Compose, non contrassegnare gli elementi di testo come invisibleToUser()
  • In React Native, gli elementi di testo sono accessibili di default; quindi non nasconderli alle tecnologie assistive

Impatto sugli Utenti

Le persone con cecità o ipovisione sono le più colpite. Quando un elemento di testo è nascosto dall'accessibilità, TalkBack non può focalizzarsi su di esso. Di conseguenza, gli utenti di lettori di schermo perderanno completamente le informazioni visualizzate sullo schermo, il che può causare confusione o impedire agli utenti di accedere a contenuti importanti.

Confermare il Problema del Testo Focalizzabile

  1. Attiva TalkBack
  2. Prova a focalizzarti sull'elemento di testo
  3. Si verificherà una delle seguenti situazioni:
    • Inaccessibile: L'elemento di testo non sarà focalizzabile da TalkBack
    • Accessibile: L'elemento di testo è focalizzato e letto da TalkBack

Risolvere i Problemi

Per risolvere un problema di Testo Focalizzabile, assicurati che l'elemento di testo non sia esplicitamente nascosto alla tecnologia assistiva. Se il testo fa parte di un elemento padre focalizzabile (come un pulsante o un controllo etichettato), il nome accessibile del padre dovrebbe includere il testo. In tal caso, l'elemento di testo stesso non ha bisogno di essere individualmente focalizzabile.

XML

Non impostare la proprietà importantForAccessibility su "no" sugli elementi di testo. Se questo attributo è presente, rimuovilo o impostalo su "yes" o "auto".

Compose

Non contrassegnare gli elementi di testo di Compose come invisibleToUser(). Rimuovi questo modificatore per assicurarti che l'elemento sia disponibile a TalkBack.

Text("Digital equality for all.", modifier = Modifier.semantics {
    // Remove invisibleToUser() to make this element accessible to TalkBack
    invisibleToUser()
})

React Native

In React Native, gli elementi di testo sono accessibili per impostazione predefinita. Conferma che il testo sia significativo e fornisca un contesto. Non disattivare l'accessibilità utilizzando la proprietà accessible={false} direttamente sull'elemento Text, o la proprietà importantForAccessibility='no-hide-descendants' su un elemento genitore.

Flutter

In Flutter, Text gli elementi sono inclusi nell'albero di accessibilità per impostazione predefinita. Conferma che il testo sia significativo e fornisca un contesto. Non escludere il testo visibile dall'albero di accessibilità racchiudendolo in ExcludeSemantics o Semantics(excludeSemantics: true).

Posso Ignorare Questa Regola?

Testo Focalizzabile ha un Impatto critico per gli utenti, e raccomandiamo fortemente di risolvere questi problemi. Nei casi in cui il testo è contenuto all'interno di un elemento padre già focalizzabile da TalkBack e già incluso nel nome accessibile dell'elemento — come un'etichetta di pulsante o un testo descrittivo di controllo — potrebbe essere accettabile lasciare l'elemento di testo stesso non focalizzabile. Scopri di più su ignorare le regole.

Risorse

Pagine del Corso Deque University

Nota: L'accesso completo alle risorse di Deque University richiede un abbonamento.

Altre Risorse