DocumentazioneAEM 6.5Guida utente

Internazionalizzazione dei componenti internationalizing-components

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Internazionalizza i componenti e le finestre di dialogo in modo che le relative stringhe dell’interfaccia utente possano essere presentate in lingue diverse. I componenti progettati per l’internazionalizzazione consentono di esternalizzare, tradurre e importare le stringhe dell’interfaccia utente nell’archivio. In fase di esecuzione, le preferenze della lingua dell’utente o le impostazioni locali della pagina determinano quale lingua viene visualizzata nell’interfaccia utente.

chlimage_1-9

Utilizza il seguente processo per internazionalizzare i componenti e fornire l’interfaccia utente in diverse lingue:

  1. Implementare i componenti utilizzando codice che internazionalizza le stringhe. Il codice identifica le stringhe da tradurre e seleziona la lingua da presentare in fase di esecuzione.

  2. Crea dizionari e aggiungi le stringhe inglesi da tradurre.

  3. Esporta il dizionario in formato XLIFF, traduci le stringhe, quindi importa i file XLIFF di nuovo in AEM. In alternativa, è possibile aggiungere manualmente le traduzioni al dizionario.

  4. Incorporare il dizionario nel processo di gestione delle versioni dell'applicazione.

NOTE
I metodi qui descritti per l’internazionalizzazione dei componenti sono destinati alla traduzione di stringhe statiche. Quando ci si aspetta che le stringhe dei componenti cambino, è necessario utilizzare i flussi di lavoro di traduzione convenzionali. Ad esempio, se gli autori possono modificare una stringa dell’interfaccia utente utilizzando le proprietà nella finestra di dialogo Modifica di un componente, non utilizzare un dizionario della lingua per internazionalizzare la stringa.

Dizionari di lingua language-dictionaries

Il framework di internazionalizzazione AEM utilizza i dizionari nel repository per memorizzare le stringhe inglesi e le loro traduzioni in altre lingue. Il framework utilizza l'inglese come lingua predefinita. Le stringhe vengono identificate utilizzando la loro versione inglese. In genere, i framework di internazionalizzazione utilizzano ID alfanumerici per le stringhe dell’interfaccia utente. L’utilizzo della versione inglese della stringa come ID presenta diversi vantaggi:

  • Il codice è facile da leggere.
  • La lingua predefinita è sempre disponibile.

Le stringhe localizzate possono essere memorizzate in diversi dizionari dell'archivio. I dizionari di sistema AEM si trovano sotto il nodo /libs. È possibile creare dizionari per i componenti sotto il nodo /apps. Il framework di internazionalizzazione AEM combina i dizionari e li rende disponibili in Sling come un singolo oggetto ResourceBundle. Quando i componenti vengono sottoposti a rendering, recuperano le stringhe tradotte dal bundle di risorse. I dizionari combinati vengono distribuiti anche sul server web in formato JSON per fornire stringhe tradotte al codice JavaScript nelle pagine web.

Inoltre, lo strumento di traduzione consente di gestire tutti i dizionari da un'unica posizione centrale.

chlimage_1-10

NOTE
Non modificare i dizionari di sistema AEM che si trovano sotto il nodo /libs.

Sovrapposizione di stringhe nei dizionari di sistema overlaying-strings-in-system-dictionaries

Le stringhe nei dizionari al di sotto del nodo /apps sostituiscono le stringhe duplicate nei dizionari al di sotto del nodo /libs. Se i componenti utilizzano stringhe incluse nei dizionari di sistema AEM, duplicare la stringa nel proprio dizionario. Tutti i componenti utilizzeranno le stringhe del dizionario.

Non è possibile prevedere quale traduzione viene utilizzata quando le stringhe vengono duplicate nei dizionari che si trovano tutti sotto il nodo /apps.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2