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 VoiceOver

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 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 ❌

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

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 ✅

An iOS 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 VoiceOver

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 = true sull'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

  1. Attiva VoiceOver
  2. Cerca di focalizzare l'elemento di testo
  3. 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:

  1. Naviga verso l'elemento di testo.
  2. Conferma che il Pannello Ispezione sia visibile.
  3. Seleziona il Ispettore di Identità.
  4. Sotto Accessibilità, seleziona la casella "Abilitato".

Per correggere nel codice, rendi l'elemento di testo focalizzabile da VoiceOver:

label.isAccessibilityElement = true

SwiftUI

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