GT ClassMethodsLocales

requiresTranslation

Riferimento API per il metodo requiresTranslation di GT

Panoramica

Il metodo requiresTranslation determina se è necessaria una traduzione in base alle impostazioni locali (locale) di origine e di destinazione. Verifica se il contenuto di origine deve essere tradotto confrontando i codici locale e tenendo conto dell’elenco delle localizzazioni approvate.


Riferimenti

Parametri

Prop

Type

Descrizione dei parametri

ParametroDescrizione
sourceLocaleIl codice della lingua/locale di origine. Se non specificato, utilizza il sourceLocale dell'istanza
targetLocaleIl codice della lingua/locale di destinazione. Se non specificato, utilizza il targetLocale dell'istanza
approvedLocalesElenco (array) di lingue/locali di destinazione approvate. Se non specificato, utilizza l’array locales dell'istanza
customMappingMappatura personalizzata opzionale per la risoluzione della lingua/locale

Restituisce

boolean - true se è necessaria la traduzione, false altrimenti

Eccezioni

  • Error - Se non viene fornito un locale di origine e l'istanza non ha un sourceLocale configurato
  • Error - Se non viene fornito un locale di destinazione e l'istanza non ha un targetLocale configurato

Esempi

const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'es-ES',
  locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});

// Lingue diverse richiedono una traduzione
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// La stessa lingua non richiede una traduzione
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Dialetti diversi della stessa lingua non richiedono una traduzione
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// La lingua di destinazione non è tra quelle approvate
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT non è tra le lingue approvate)

Note

  • Considera le famiglie linguistiche delle locale, non solo le corrispondenze esatte
  • Rispetta gli elenchi di locale approvate
  • Restituisce false quando la locale di destinazione non è presente tra quelle approvate (se fornite)

Prossimi passaggi

Come valuti questa guida?

requiresTranslation