Da destra a sinistra e direzione del layout

Arabo, ebraico, persiano e urdu si scrivono da destra a sinistra (RTL). Per queste persone l'intera interfaccia dovrebbe rispecchiarsi: i pulsanti di navigazione indietro devono puntare a destra, gli elenchi devono allinearsi al margine destro e l'avanzamento deve procedere da destra a sinistra. Il supporto RTL è una parte fondamentale dell'internazionalizzazione.

La regola d'oro è progettare usando leading e trailing invece di sinistra e destra. Leading indica il punto da cui inizia la lettura: a sinistra in inglese, a destra in arabo. Usando leading e trailing, il sistema rispecchia automaticamente il layout in RTL.

SwiftUI espone la direzione corrente tramite il valore d'ambiente layoutDirection, che può essere .leftToRight o .rightToLeft. Leggetelo quando vi serve una logica dipendente dalla direzione, ad esempio per scegliere una risorsa grafica per il chevron.

Molti SF Symbols si rispecchiano automaticamente. Per le immagini personalizzate direzionali, indicate che devono invertirsi con la direzione del layout, così una freccia che punta in avanti continuerà a puntare in avanti in RTL. Il modificatore flipsForRightToLeftLayoutDirection controlla questo comportamento.

Talvolta una sottovista deve mantenere una direzione fissa, ad esempio un numero di telefono o un frammento di codice da sinistra a destra all'interno di un layout RTL. Sovrascrivete la direzione applicando il modificatore environment(\.layoutDirection, _) solo a quella gerarchia.

Usate .leading e .trailing anche per l'allineamento del testo. Un paragrafo allineato con .leading aderisce automaticamente al margine destro in arabo. Evitate .left/.right, che non si invertono mai.

I paragrafi RTL contengono spesso sequenze LTR, come URL, numeri e nomi di marchi in inglese. L'algoritmo bidirezionale Unicode gestisce l'ordine, ma potete racchiudere le sequenze ambigue tra caratteri di isolamento direzionale per impedire che l'ordine visivo risulti alterato.

Alcuni controlli, come i pulsanti di riproduzione multimediale e le timeline, NON devono rispecchiarsi perché il loro significato è fisico, non legato alla direzione di lettura. L'attributo semanticContentAttribute di UIKit, con valori come .playback, .spatial e .forceLeftToRight, indica al sistema quando mantenere una direzione fissa.

Non vi serve una traduzione in arabo per testare il rispecchiamento. Eseguite l'app con la Right-to-Left Pseudolanguage nelle impostazioni della lingua dell'app dello schema. L'interfaccia si rispecchia usando le stringhe esistenti, così potete individuare immediatamente i problemi causati da .left/.right inseriti manualmente.

Prestate attenzione a questi casi:

• Allineamento o spaziatura con .left/.right inseriti manualmente.
• Viste posizionate manualmente usando offset x fissi.
• Immagini personalizzate direzionali che non si invertono.
• Chevron indietro o cursori che puntano nella direzione sbagliata.
• Stringhe bidirezionali concatenate il cui ordine risulta alterato.

Una riga ben costruita usa leading e trailing ovunque, consente ai simboli di invertirsi e impone una direzione solo quando lo richiede il significato. Una vista di questo tipo non necessita di alcuna modifica per apparire corretta sia in inglese sia in arabo.

Ricordate il principio fondamentale per un layout compatibile con RTL.

Avete imparato a supportare le lingue con scrittura da destra a sinistra:

• Progettate usando leading/trailing, mai sinistra/destra.
• Leggete l'ambiente layoutDirection per la logica dipendente dalla direzione.
• Invertite le immagini direzionali; sovrascrivete la direzione per le gerarchie fisse, come quelle che contengono codice o numeri di telefono.
• Usate semanticContentAttribute per i controlli di riproduzione e spaziali che non devono rispecchiarsi.
• Testate con la pseudolingua RTL prima della pubblicazione.