Aurelia - Localizzazione

Aurelia offre i18ncollegare. In questo capitolo imparerai come localizzare la tua app usando questo plugin.

Passaggio 1: installa un plug-in

Apri il command prompt finestra ed eseguire il codice seguente per l'installazione i18n collegare.

C:\Users\username\Desktop\aureliaApp>jspm install aurelia-i18n

Abbiamo anche bisogno di installare il plugin di backend.

C:\Users\username\Desktop\aureliaApp>jspm install npm:i18next-xhr-backend

Passaggio 2: creare cartelle e file

Nella cartella principale del progetto, dobbiamo creare un file locale directory.

C:\Users\username\Desktop\aureliaApp>mkdir locale

In questa cartella, devi aggiungere nuove cartelle per qualsiasi lingua desideri. Creeremoen con translation.js file all'interno.

C:\Users\username\Desktop\aureliaApp\locale>mkdir en
C:\Users\username\Desktop\aureliaApp\locale\en>touch translation.json

Passaggio 3: utilizzare un plug-in

È necessario utilizzare il bootstrap manuale per poter utilizzare questo plugin. Controllare il capitolo Configurazione per ulteriori informazioni. Dobbiamo aggiungerei18n plugin per il main.js file.

main.js

import {I18N} from 'aurelia-i18n';
import XHR from 'i18next-xhr-backend';

export function configure(aurelia) {
   aurelia.use
   .standardConfiguration()
   .developmentLogging()
	
   .plugin('aurelia-i18n', (instance) => {
      // register backend plugin
      instance.i18next.use(XHR);

      // adapt options to your needs (see http://i18next.com/docs/options/)
      instance.setup({
         backend: {                                  
            loadPath: '/locales/{{lng}}/{{ns}}.json',
         },
				
         lng : 'de',
         attributes : ['t','i18n'],
         fallbackLng : 'en',
         debug : false
      });
   });

   aurelia.start().then(a => a.setRoot());
}

Passaggio 4: traduzione del file JSON

Questo è il file in cui puoi impostare i valori di traduzione. Useremo un esempio da una documentazione ufficiale. Ilde-DE La cartella dovrebbe effettivamente essere utilizzata per la traduzione in lingua tedesca, tuttavia utilizzeremo invece frasi in inglese, per una più facile comprensione.

translation.json

{
   "score": "Score: {{score}}",
   "lives": "{{count}} life remaining",
   "lives_plural": "{{count}} lives remaining",
   "lives_indefinite": "a life remaining",
   "lives_plural_indefinite": "some lives remaining",
   "friend": "A friend",
   "friend_male": "A boyfriend",
   "friend_female": "A girlfriend"
}

Passaggio 5: impostare le impostazioni internazionali

Dobbiamo solo importare i18n plug-in e impostalo per utilizzare il codice JSON da de-DE cartella.

app.js

import {I18N} from 'aurelia-i18n';

export class App {
   static inject = [I18N];
	
   constructor(i18n) {
      this.i18n = i18n;
      this.i18n
      .setLocale('de-DE')
		
      .then( () => {
         console.log('Locale is ready!');
      });
   }
}

Passaggio 6: visualizzazione

Esistono due modi per tradurre i dati. Useremo un ValueConverter personalizzato denominatot. Nell'esempio seguente puoi vedere vari modi di formattazione dei dati. Confronta questo con iltranslation.json file e noterai i modelli utilizzati per la formattazione.

<template>
   <p>
      Translation with Variables: <br />
      ${ 'score' | t: {'score': 13}}
   </p>

   <p>
      Translation singular: <br />
      ${ 'lives' | t: { 'count': 1 } }
   </p>

   <p>
      Translation plural: <br />
      ${ 'lives' | t: { 'count': 2 } }
   </p>

   <p>  
      Translation singular indefinite: <br />
      ${ 'lives' | t: { 'count': 1, indefinite_article: true  } }
   </p>

   <p>
      Translation plural indefinite: <br />
      ${ 'lives' | t: { 'count': 2, indefinite_article: true } }
   </p>

   <p>
      Translation without/with context: <br />
      ${ 'friend' | t } <br />
      ${ 'friend' | t: { context: 'male' } } <br />
      ${ 'friend' | t: { context: 'female' } }
   </p>
	
</template>

Quando eseguiamo l'app, otterremo il seguente output.