Come tradurre l'interfaccia utente di un'app web

Come tradurre l'interfaccia utente di un'app web

Ultimo aggiornamento: 12 settembre 2026

Per tradurre l'interfaccia di un'applicazione web hai due opzioni concrete. Estrarre ogni stringa in file locali distribuiti insieme all'app, oppure eseguire un livello sopra il DOM renderizzato che sostituisce il testo man mano che compare. La maggior parte dei team finisce per usare un po' di entrambe, e quale delle due faccia più lavoro dipende da quanta parte dell'interfaccia è costituita da testi del prodotto e quanta da contenuti.

Questa guida riguarda le schermate delle app, non le pagine di destinazione: dashboard, impostazioni, moduli, pulsanti, stati vuoti, messaggi di errore e le email inviate dalla tua app. I casi di errore sono diversi e la maggior parte dei consigli scritti sulla "traduzione di un sito web" non regge al confronto con l'interfaccia di un prodotto reale.

Ne vale la pena. CSA Research ha intervistato 8,709 consumatori in 29 paesi e ha scoperto che il 40% non acquisterà mai da siti web in altre lingue. Il suo Chief Research Officer, il dott. Donald A. DePalma, lo ha detto chiaramente: "se un'azienda sceglie di non localizzare l'esperienza di acquisto, rischia di perdere il 40% o più del mercato potenziale totale."

Un'interfaccia di un'app non si comporta affatto come una pagina di marketing

Una pagina di destinazione è un blocco di testo fisso che si trova nell'HTML al momento del caricamento. Un'app è una macchina che produce testo. Un errore di convalida esiste solo dopo che qualcuno invia un modulo non valido. Un toast esiste per quattro secondi. Il contenuto di una finestra modale non è nel documento finché un clic non la crea. Uno stato vuoto appare solo per gli account senza dati, il che di solito significa mai sulla tua macchina.

Questo è importante perché ogni approccio deve rispondere a una domanda: in quale momento una stringa diventa testo? I file locali rispondono in fase di compilazione. Un livello di runtime risponde ogni volta che il DOM cambia. Qualsiasi soluzione che risponda solo al caricamento della pagina non rileverà la maggior parte dei contenuti del tuo prodotto.

La grammatica si rompe prima dell'impaginazione

Gli errori di conteggio arrivano per primi. L'inglese ha due forme plurali e molto codice presume tacitamente che sia così ovunque. Unicode CLDR definisce sei categorie plurali: zero, uno, due, pochi, molti e altro. L'arabo usa tutte e sei per i numeri cardinali, il russo e il polacco ne usano quattro, il giapponese e il coreano una. Una stringa come {count} items non si può correggere aggiungendo una "s" finale, e sbagliare fa sembrare l'interfaccia malfunzionante, non semplicemente straniera.

Poi ci sono date e numeri. Lo stesso totale dell'ordine è 1,299.50 negli Stati Uniti, 1.299,50 in Germania e 1 299,50 in Francia. Non serve una libreria per questo, perché Intl.NumberFormat e Intl.DateTimeFormat sono integrati in tutti i browser attuali. La formattazione è l'unico aspetto dell'i18n delle app che la piattaforma ha davvero risolto al posto tuo.

Le etichette tradotte non entrano nei pulsanti che hai progettato

L'espansione del testo è un problema di impaginazione che si manifesta solo in produzione. Le indicazioni del W3C sulla lunghezza del testo in traduzione riprendono la tabella di espansione di IBM, e il suo andamento è l'opposto di quello che molti si aspettano: le stringhe di origine lunghe fino a dieci caratteri possono espandersi dal 200 al 300 percento, mentre quelle di oltre settanta caratteri si assestano intorno al 130 percento.

Consideralo nel contesto di un'interfaccia. I paragrafi più lunghi sono gli elementi più sicuri della pagina. I danni si verificano nei pulsanti, nelle etichette delle schede e nelle voci di menu. La stessa pagina del W3C rileva che la parola "views" è 2.8 volte più lunga in tedesco che in inglese. La direzione è l'altra metà del problema: il W3C conta dodici sistemi di scrittura da destra a sinistra in 215 lingue, e la scrittura da destra a sinistra è un problema CSS, non di traduzione.

Opzione uno: una libreria i18n in fase di compilazione

Racchiudi ogni stringa visibile all'utente in una chiamata di funzione, le estrai in file JSON per ciascuna lingua e le distribuisci insieme all'app. i18next è la scelta predefinita in JavaScript, con circa 16 milioni di download settimanali del pacchetto npm principale e altri 11.6 milioni per react-i18next (npm, settimana del 5 settembre 2026). La documentazione stessa descrive accuratamente l'ambito: "i18next va oltre la semplice fornitura delle funzionalità i18n standard, come plurali, contesto, interpolazione e formattazione."

Questo è il vero argomento a suo favore. Ottieni categorie plurali, interpolazione, varianti contestuali, namespace caricati in modo differito e, cosa fondamentale, traduzioni che vivono al di fuori del browser, così email, PDF ed errori API condividono un unico catalogo. Il costo è il tempo di sviluppo: qualcuno deve racchiudere le stringhe e impedire che testo non tradotto finisca in ogni pull request.

Opzione due: un livello di traduzione in runtime

L'altro approccio lascia intatto il tuo codice. Uno script osserva il DOM renderizzato, raccoglie il testo visibile e lo sostituisce man mano che compaiono nuovi nodi. Poiché reagisce alle modifiche invece che ai caricamenti delle pagine, intercetta modali, notifiche toast e righe che arrivano in un secondo momento da un'API.

Il vantaggio principale è la velocità. Ottieni un'interfaccia tradotta in un pomeriggio senza toccare i componenti, una soluzione adatta a strumenti interni, pannelli di amministrazione e prodotti nelle prime fasi di sviluppo. Gestisce anche i contenuti generati dagli utenti, cosa che i file di localizzazione non possono fare strutturalmente, perché nessuna fase di build può sapere cosa scriveranno i tuoi clienti.

I limiti da considerare sono ancora più importanti. Non può tradurre una stringa che non raggiunge mai il DOM, quindi le email transazionali, le notifiche push e le risposte delle API restano invariate. Aggiunge un round trip di rete al primo rendering, quindi prevedi un breve intervallo in cui i contenuti non sono tradotti.

Come scegliere tra i due approcci

In pratica, la scelta dipende dalla responsabilità dei contenuti, non dalla tecnologia. Se una stringa fa parte delle specifiche del prodotto e la sua formulazione viene rivista e approvata, appartiene ai file di localizzazione. Il Project Fluent di Mozilla spiega questa esigenza meglio di chiunque altro: "I traduttori dovrebbero poter usare tutto il potenziale espressivo della propria lingua senza chiedere il permesso agli sviluppatori". Non puoi ottenere questo risultato con un sistema che vede solo l'inglese renderizzato.

Tutto il resto è contenuto: testi di aiuto, changelog, contenuti di marketing nell'app e tutto ciò che gli utenti hanno scritto. È per questa seconda categoria che è stato creato WeLocale: ti basta un tag script per applicare la traduzione con l'IA al DOM live, inclusi i contenuti caricati dopo la pagina, e hai a disposizione un editor per correggere le stringhe tradotte male dalla macchina. WeLocale è davvero lo strumento sbagliato se le stringhe tradotte fanno parte delle specifiche del tuo prodotto.

Gli imprevisti che emergono nella seconda settimana

Imposta l'attributo lang e modificalo quando cambia la lingua. Gli screen reader usano questo attributo per applicare le regole di pronuncia. Il criterio di successo 3.1.2 delle WCAG 2.2 richiede che "la lingua umana di ogni passaggio o frase nel contenuto possa essere determinata a livello di codice", ed è proprio ai casi di schermate di app con più lingue che si riferisce.

Non preoccuparti della SEO per ciò che è accessibile solo dopo aver effettuato l'accesso. I crawler non vedono mai quelle pagine, quindi lì hreflang e gli URL delle lingue indicizzabili sono lavoro sprecato. Sono importanti solo per le pagine pubbliche.

Gestisci la cache con criterio. I bundle di localizzazione dovrebbero essere immutabili e avere un'impronta digitale, mentre le traduzioni in runtime dovrebbero essere memorizzate nella cache locale, così gli utenti che tornano non devono scaricarle di nuovo. E scrivi un test che inserisca la tua stringa tedesca più lunga nel tuo pulsante più stretto.

FAQ

Posso tradurre un'app React o Vue senza riscrivere i componenti? Sì, con un livello in runtime che osserva il DOM e sostituisce il testo dopo che il tuo framework lo ha renderizzato. Gestisce modali, notifiche toast e dati che arrivano da un'API. Non può gestire le stringhe che non vengono mai renderizzate nel browser, come le email transazionali o i messaggi di errore delle API.

E per i testi che gli utenti scrivono autonomamente? I file di localizzazione non possono essere d'aiuto, perché nessuna fase di build può sapere cosa scriverà un utente. I contenuti generati dagli utenti devono essere tradotti in runtime, tramite un livello a livello di DOM oppure richiamando un'API di traduzione dal tuo codice prima di mostrarli.

Mi servono i tag hreflang per la dashboard di un'app? No. Le pagine accessibili solo dopo aver effettuato l'accesso non vengono mai scansionate, quindi hreflang e gli URL delle lingue indicizzabili non servono a nulla. Aggiungili invece alle tue pagine pubbliche: il sito di marketing, la documentazione, i prezzi e la schermata di accesso stessa.

Su questo sito

Lo vuoi sul tuo sito? Aggiungi oltre 50 lingue con un solo snippet, senza modifiche al codice.

Prova WeLocale gratis