Testo Focalizzabile
Assicurati che gli elementi di testo siano raggiungibili da VoiceOver
Scopri come stiamo utilizzando l'intelligenza artificiale per questa regola!
Cosa Controlliamo
Tutti gli elementi contenenti testo dovrebbero essere focalizzabili per tecnologie assistive come VoiceOver. Gli elementi di testo dovrebbero essere contrassegnati come elementi di accessibilità, in modo che gli utenti di VoiceOver possano navigare e leggere il testo sullo schermo.
Esempio di Fallimento ❌
Il price and description text are not marked as accessibility elements
VoiceOver salta da "Cuffie Premium" direttamente a "Aggiungi al carrello" -
il prezzo e la descrizione non vengono mai annunciati
Gli utenti del lettore di schermo perdono informazioni critiche sul prodotto visualizzate sullo schermo
Esempio di Successo ✅
Tutti gli elementi di testo sono marked as accessibility elements e raggiungibili da VoiceOver
VoiceOver naviga attraverso tutti e quattro gli elementi in sequenza: intestazione, prezzo, descrizione e pulsante
Gli utenti del lettore di schermo ricevono tutte le informazioni sul prodotto in un ordine di lettura logico
In Sintesi
- Questa regola ha un impatto critico per gli utenti
- Gli elementi di testo devono essere contrassegnati come elementi di accessibilità affinché VoiceOver li legga
- In UIKit, imposta
isAccessibilityElement = truesull'elemento di testo per renderlo focalizzabile - In SwiftUI e React Native, gli elementi di testo sono accessibili per impostazione predefinita — non nasconderli dalla tecnologia assistiva
Impatto sugli Utenti
Le persone con cecità o ipovisione sono le più colpite. Quando un elemento di testo non è contrassegnato come elemento di accessibilità, VoiceOver non può focalizzarlo. Di conseguenza, gli utenti del lettore di schermo perderanno totalmente le informazioni visualizzate sullo schermo, il che può causare confusione o impedire agli utenti di accedere a contenuti importanti.
Conferma Problema di Testo Focalizzabile
- Attiva VoiceOver
- Cerca di focalizzare l'elemento di testo
- Si verificherà uno dei seguenti:
- Inaccessibile: L'elemento di testo non sarà focalizzabile da VoiceOver
- Accessibile: L'elemento di testo viene focalizzato e letto da VoiceOver
Risolvi Problemi
Per risolvere un problema di Testo Focalizzabile, assicurati che l'elemento di testo sia contrassegnato come elemento di accessibilità affinché VoiceOver possa raggiungerlo e annunciarlo. 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 necessita di essere focalizzabile singolarmente.
UIKit
Per correggere in Storyboard:
- Naviga verso l'elemento di testo.
- Conferma che il Pannello Ispezione sia visibile.
- Seleziona il Ispettore di Identità.
- Sotto Accessibilità, seleziona la casella "Abilitato".
Per correggere nel codice, rendi l'elemento di testo focalizzabile da VoiceOver:
label.isAccessibilityElement = trueSwiftUI
In SwiftUI, gli elementi di testo sono accessibili per impostazione predefinita. Conferma che il testo sia significativo e fornisca contesto, e non nasconderlo utilizzando il modificatore di visualizzazione nascosta per l'accessibilità.
React Native
In React Native, gli elementi di testo sono accessibili per impostazione predefinita. Conferma che il testo sia significativo e fornisca contesto. Non disattivare l'accessibilità usando la proprietà accessible={false} direttamente sull'elemento Text, o la proprietà accessibilityElementsHidden=true su un elemento padre.
Flutter
In Flutter, gli elementi Text sono inclusi nell'albero di accessibilità per impostazione predefinita. Conferma che il testo sia significativo e fornisca contesto. Non escludere il testo visibile dall'albero di accessibilità incapsulandolo in ExcludeSemantics o Semantics(excludeSemantics: true).
Posso Ignorare Questa Regola?
Il Testo Focalizzabile ha un impatto critico per gli utenti, e raccomandiamo fortemente di risolvere questi problemi. In casi in cui il testo sia contenuto all'interno di un elemento padre già focalizzabile da VoiceOver e includa già il testo nel suo nome accessibile - come etichetta di un pulsante o testo descrittivo di un controllo - può 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
- Linee Guida per l'Accessibilità dei Contenuti Web (WCAG) 2.0, Raccomandazione W3C
- Documenti di Comprensione WCAG 2.0
