Prova a rendere più accessibili i composable della tua app. I seguenti passaggi possono migliorare l'accessibilità del composable:
- Descrivi il tuo componibile
- Aggiungere interazioni
- Gestire UI complesse
Descrivi il tuo componibile
Per descrivere un elemento componibile, dichiara le sue proprietà semantiche (ad esempio role,
label, state o azioni) utilizzando Modifier.semantics. I servizi di accessibilità possono leggere queste proprietà semantiche e utilizzare le informazioni per interagire con l'interfaccia utente e annunciarla.
La proprietà Role è particolarmente importante perché fornisce il contesto necessario
affinché i servizi di accessibilità annuncino lo scopo di un componente e
le interazioni previste. Ad esempio, considera un'icona personalizzata che si comporta come un
pulsante su cui è possibile fare clic. Se imposti il ruolo su Role.button, puoi assicurarti che
gli screen reader lo annuncino come elemento interattivo, non come immagine statica.
Per saperne di più, vedi Semantica.
Aggiungere interazioni
Per aggiungere interazioni al componibile, utilizza i modificatori clickable o toggleable. Questi modificatori sono dotati di proprietà semantiche integrate che i servizi di accessibilità possono leggere. Per rendere più accessibili i gesti complessi
del touchscreen, utilizza CustomAccessibilityAction.
Per saperne di più, consulta Azioni personalizzate.
Gestire UI complesse
Sebbene Compose supporti molte funzionalità di accessibilità per impostazione predefinita, un'interfaccia utente più complessa potrebbe richiedere un comportamento più personalizzato. Puoi rendere più accessibili le UI complesse strutturando logicamente la gerarchia della UI e fornendo un ordine di lettura logico per i servizi di accessibilità.
Struttura la gerarchia della UI in modo logico:se un composable principale è costituito da più elementi secondari, puoi specificare in modo esplicito come questi elementi vengono raggruppati o eseguirne l'override completo. Per ulteriori informazioni, vedi Unione e cancellazione.
Controlla l'ordine di attraversamento:se l'ordine di lettura predefinito di Compose non è sufficiente, puoi controllare manualmente il modo in cui gli screen reader navigano tra gli elementi della UI. Per ulteriori informazioni, vedi Modificare l'ordine di attraversamento.
Controllo dello stato attivo:per la navigazione da tastiera e con il D-pad, puoi ignorare manualmente l'ordine di attraversamento dello stato attivo. Per saperne di più, consulta Modificare il comportamento della messa a fuoco e Modificare l'ordine di attraversamento della messa a fuoco.
Risorse aggiuntive
Per saperne di più su come rendere accessibile la tua UI, consulta le seguenti risorse aggiuntive: