Angular utilise l'identifiant de locale Unicode (Unicode locale ID) pour trouver les données de locale correctes pour l'internationalisation des chaînes de texte.
Identifiant de locale Unicode
Un identifiant de locale est conforme à la spécification de base du Unicode Common Locale Data Repository (CLDR). Pour en savoir plus sur les identifiants de locale, consultez Unicode Language and Locale Identifiers.
Le CLDR et Angular utilisent les balises BCP 47 comme base de l'identifiant de locale
Un identifiant de locale spécifie la langue, le pays et un code facultatif pour d'autres variantes ou subdivisions.
Un identifiant de locale se compose de l'identifiant de langue, d'un trait d'union (-) et de l'extension de locale.
{language_id}-{locale_extension}Utile : Pour traduire correctement votre projet Angular, vous devez décider quelles langues et quelles locales vous ciblez pour l'internationalisation.
De nombreux pays partagent la même langue, mais avec des usages différents. Les différences concernent la grammaire, la ponctuation, les formats des devises, des nombres décimaux, des dates, etc.
Pour les exemples de ce guide, utilisez les langues et locales suivantes.
| Langue | Locale | Identifiant de locale Unicode |
|---|---|---|
| Anglais | Canada | en-CA |
| Anglais | États-Unis d'Amérique | en-US |
| Français | Canada | fr-CA |
| Français | France | fr-FR |
Le dépôt Angular inclut les locales courantes.
Pour une liste des codes de langue, consultez ISO 639-2.
Définir l'identifiant de la locale source
Utilisez l'Angular CLI pour définir la langue source dans laquelle vous écrivez le template et le code du composant.
Par défaut, Angular utilise en-US comme locale source de votre projet.
Pour changer la locale source de votre projet pour le build, effectuez les actions suivantes.
- Ouvrez le fichier de configuration de build du workspace
angular.json. - Ajoutez ou modifiez le champ
sourceLocaledans la sectioni18n:
{
"projects": {
"your-project": {
"i18n": {
"sourceLocale": "ca" // Use your desired locale code
}
}
}
}Lire la locale active en dehors de l'injection de dépendances
Dans un composant ou un service, injectez le token LOCALE_ID pour obtenir la locale active.
Si vous ne pouvez pas injecter LOCALE_ID, par exemple dans une simple fonction en dehors d'un contexte d'injection, lisez $localize.locale.
Chaque build localisé définit cette valeur, et c'est elle que lit la fabrique par défaut de LOCALE_ID.
Si votre application fournit son propre LOCALE_ID, $localize.locale ne le reflète pas.
declare const $localize: {locale?: string};
export const locale = (typeof $localize !== 'undefined' && $localize.locale) || 'en-US';Placez ce code dans un fichier qui contient un import ou un export. Si votre projet inclut déjà les types de @angular/localize, omettez la ligne declare.