Utility FunctionsLocales

resolveAliasLocale

Référence de l’API pour la fonction resolveAliasLocale

Présentation

La fonction resolveAliasLocale convertit les codes de locale canoniques en leurs codes de locale alias lorsqu’un mappage personnalisé est configuré. Cette fonction autonome offre la même fonctionnalité que la méthode de la classe GT, sans nécessiter d’instance.


Références

Paramètres

Prop

Type

Renvoie

string - Le code de locale alias si un mappage existe, sinon la locale d'origine


Exemples

import { resolveAliasLocale } from 'generaltranslation';

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'chinois simplifié' },
  'traditional-chinese': { code: 'zh-TW', name: 'chinois traditionnel' }
};

// Conversion du canonique vers l’alias
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// Une locale non cartographiée renvoie la valeur d’origine
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'

Notes

  • Convertit les codes de locale canoniques en alias conviviaux
  • Renvoie la locale d’origine s’aucune correspondance n’existe
  • Indispensable pour afficher les noms de locale côté utilisateur
  • Fonctionne avec des correspondances de locale personnalisées
  • Fonction pure, sans état — aucun effet secondaire

Prochaines étapes

Que pensez-vous de ce guide ?

resolveAliasLocale