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
| Parametro | Descrizione |
|---|---|
sourceLocale | Il codice della lingua/locale di origine. Se non specificato, utilizza il sourceLocale dell'istanza |
targetLocale | Il codice della lingua/locale di destinazione. Se non specificato, utilizza il targetLocale dell'istanza |
approvedLocales | Elenco (array) di lingue/locali di destinazione approvate. Se non specificato, utilizza l’array locales dell'istanza |
customMapping | Mappatura 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 unsourceLocaleconfiguratoError- Se non viene fornito un locale di destinazione e l'istanza non ha untargetLocaleconfigurato
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
falsequando la locale di destinazione non è presente tra quelle approvate (se fornite)
Prossimi passaggi
- Controlla le relazioni tra i locale con
isSameLanguage - Determina il locale migliore con
determineLocale - Valida i locale con
isValidLocale
Come valuti questa guida?