Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Intl.DisplayNames
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.
L'objetIntl.DisplayNames permet la traduction cohérente des noms de langues, de régions et de systèmes d'écriture.
Exemple interactif
const regionNamesInFrench = new Intl.DisplayNames(["fr"], { type: "region" });const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], { type: "region",});console.log(regionNamesInFrench.of("FR"));// Expected output: "France"console.log(regionNamesInTraditionalChinese.of("FR"));// Expected output: "法國"Constructeur
Intl.DisplayNames()Crée un nouvel objet
Intl.DisplayNames.
Méthodes statiques
Intl.DisplayNames.supportedLocalesOf()Retourne un tableau contenant les langues fournies qui sont supportées sans avoir à se rabattre sur la langue locale par défaut au moment de l'exécution.
Propriétés d'instance
Ces propriétés sont définies surIntl.DisplayNames.prototype et partagées par toutes les instances deIntl.DisplayNames.
Intl.DisplayNames.prototype.constructorLa fonction constructeur qui a créé l'objet instance. Pour les instances de
Intl.DisplayNames, la valeur initiale est le constructeurIntl.DisplayNames.Intl.DisplayNames.prototype[Symbol.toStringTag]La valeur initiale de la propriété
[Symbol.toStringTag]est la chaîne de caractères"Intl.DisplayNames". Cette propriété est utilisée dansObject.prototype.toString().
Méthodes d'instance
Intl.DisplayNames.prototype.of()Cette méthode reçoit un
codeet retourne une chaine à partir de la langue et des options fournies lors de l'instanciation deIntl.DisplayNames.Intl.DisplayNames.prototype.resolvedOptions()Retourne un nouvel objet dont les propriété reflètent la langue et les options de formattage calculées lors de l'initialisation de l'objet.
Exemples
Affichage des noms de régions
Pour créer un objetIntl.DisplayNames pour une langue et obtenir le nom correspondant à un code de région dans cette langue.
// Obtenir le nom d'une région en anglaislet nomsRegions = new Intl.DisplayNames(["en"], { type: "region" });nomsRegions.of("419"); // "Latin America"nomsRegions.of("BZ"); // "Belize"nomsRegions.of("US"); // "United States"nomsRegions.of("BA"); // "Bosnia & Herzegovina"nomsRegions.of("MM"); // "Myanmar (Burma)"// Obtenir le nom d'une région en chinois traditionnelnomsRegions = new Intl.DisplayNames(["zh-Hant"], { type: "region" });nomsRegions.of("419"); // "拉丁美洲"nomsRegions.of("BZ"); // "貝里斯"nomsRegions.of("US"); // "美國"nomsRegions.of("BA"); // "波士尼亞與赫塞哥維納"nomsRegions.of("MM"); // "緬甸"Affichage des noms de langues
Pour créer un objetIntl.DisplayNames pour une langue et obtenir le nom correspondant à un code de langue (possiblement suivi d'un code de système d'écriture ou de région) dans cette langue.
// Obtenir le nom d'une langue en anglaislet nomsLangues = new Intl.DisplayNames(["en"], { type: "language" });nomsLangues.of("fr"); // "French"nomsLangues.of("de"); // "German"nomsLangues.of("fr-CA"); // "Canadian French"nomsLangues.of("zh-Hant"); // "Traditional Chinese"nomsLangues.of("en-US"); // "American English"nomsLangues.of("zh-TW"); // "Chinese (Taiwan)"// Obtenir le nom d'une langue en chinois traditionnelnomsLangues = new Intl.DisplayNames(["zh-Hant"], { type: "language" });nomsLangues.of("fr"); // "法文"nomsLangues.of("zh"); // "中文"nomsLangues.of("de"); // "德文"Affichage des noms de systèmes d'écriture
Pour créer un objetIntl.DisplayNames pour une langue et obtenir le nom correspondant à un code de système d'écriture dans cette langue.
// Obtenir le nom d'un système d'écriture en anglaislet nomsScript = new Intl.DisplayNames(["en"], { type: "script" });nomsScript.of("Latn"); // "Latin"nomsScript.of("Arab"); // "Arabic"nomsScript.of("Kana"); // "Katakana"// Obtenir le nom d'un système d'écriture en chinois traditionnelnomsScript = new Intl.DisplayNames(["zh-Hant"], { type: "script" });nomsScript.of("Latn"); // "拉丁文"nomsScript.of("Arab"); // "阿拉伯文"nomsScript.of("Kana"); // "片假名"Affichage des noms de devises
Pour créer un objetIntl.DisplayNames pour une langue et obtenir le nom correspondant au code d'une devise.
// Obtenir le nom d'une devise en anglaislet nomsDevises = new Intl.DisplayNames(["en"], { type: "currency" });nomsDevises.of("USD"); // "US Dollar"nomsDevises.of("EUR"); // "Euro"nomsDevises.of("TWD"); // "New Taiwan Dollar"nomsDevises.of("CNY"); // "Chinese Yuan"// Obtenir le nom d'une devise en chinois traditionnelnomsDevises = new Intl.DisplayNames(["zh-Hant"], { type: "currency" });nomsDevises.of("USD"); // "美元"nomsDevises.of("EUR"); // "歐元"nomsDevises.of("TWD"); // "新台幣"nomsDevises.of("CNY"); // "人民幣"Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # intl-displaynames-objects |