| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DisplayNames | [Back] [Original] |
Get to know MDN better
Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.
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'objet Intl.DisplayNames permet la traduction cohrente des noms de langues, de rgions et de systmes d'criture.
const regionNamesInFrench = new Intl.DisplayNames(["fr"], { type: "region" });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], {
type: "region",
});
console.log(regionNamesInFrench.of("FR"));
// Rsultat attendu : "France"
console.log(regionNamesInTraditionalChinese.of("FR"));
// Rsultat attendu : ""
Intl.DisplayNames()Cre un nouvel objet Intl.DisplayNames.
Intl.DisplayNames.supportedLocalesOf()Retourne un tableau contenant les langues fournies qui sont supportes sans avoir se rabattre sur la langue locale par dfaut au moment de l'excution.
Ces proprits sont dfinies sur Intl.DisplayNames.prototype et partages par toutes les instances de Intl.DisplayNames.
Intl.DisplayNames.prototype.constructorLa fonction constructeur qui a cr l'objet instance. Pour les instances de Intl.DisplayNames, la valeur initiale est le constructeur Intl.DisplayNames.
Intl.DisplayNames.prototype[Symbol.toStringTag]La valeur initiale de la proprit [Symbol.toStringTag] est la chane de caractres "Intl.DisplayNames". Cette proprit est utilise dans Object.prototype.toString().
Intl.DisplayNames.prototype.of()Cette mthode reoit un code et retourne une chane de caractres partir de la langue et des options fournies lors de l'instanciation de Intl.DisplayNames.
Intl.DisplayNames.prototype.resolvedOptions()Retourne un nouvel objet avec des proprits refltant la locale et les options de mise en forme calcules lors de l'initialisation de l'objet.
Pour crer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant un code de rgion dans cette langue.
// Obtenir le nom d'une rgion en anglais
let 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 rgion en chinois traditionnel
nomsRegions = new Intl.DisplayNames(["zh-Hant"], { type: "region" });
nomsRegions.of("419"); // ""
nomsRegions.of("BZ"); // ""
nomsRegions.of("US"); // ""
nomsRegions.of("BA"); // ""
nomsRegions.of("MM"); // ""
Pour crer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant un code de langue (possiblement suivi d'un code de systme d'criture ou de rgion) dans cette langue.
// Obtenir le nom d'une langue en anglais
let 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 traditionnel
nomsLangues = new Intl.DisplayNames(["zh-Hant"], { type: "language" });
nomsLangues.of("fr"); // ""
nomsLangues.of("zh"); // ""
nomsLangues.of("de"); // ""
Pour crer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant un code de systme d'criture dans cette langue.
// Obtenir le nom d'un systme d'criture en anglais
let nomsScript = new Intl.DisplayNames(["en"], { type: "script" });
nomsScript.of("Latn"); // "Latin"
nomsScript.of("Arab"); // "Arabic"
nomsScript.of("Kana"); // "Katakana"
// Obtenir le nom d'un systme d'criture en chinois traditionnel
nomsScript = new Intl.DisplayNames(["zh-Hant"], { type: "script" });
nomsScript.of("Latn"); // ""
nomsScript.of("Arab"); // ""
nomsScript.of("Kana"); // ""
Pour crer un objet Intl.DisplayNames pour une langue et obtenir le nom correspondant au code d'une devise.
// Obtenir le nom d'une devise en anglais
let 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 traditionnel
nomsDevises = new Intl.DisplayNames(["zh-Hant"], { type: "currency" });
nomsDevises.of("USD"); // ""
nomsDevises.of("EUR"); // ""
nomsDevises.of("TWD"); // ""
nomsDevises.of("CNY"); // ""
| Spcification |
|---|
| ECMAScript 2027 Internationalization API Specification # intl-displaynames-objects |
Cette page a t modifie le 27 fvr. 2026 par les contributeurices du MDN.
Intl.DisplayNamesObject/FunctionObject.prototype.__defineGetter__()Object.prototype.__defineSetter__()Object.prototype.__lookupGetter__()Object.prototype.__lookupSetter__()Object.prototype.hasOwnProperty()Object.prototype.isPrototypeOf()Object.prototype.propertyIsEnumerable()Object.prototype.toLocaleString()Object.prototype.toString()Object.prototype.valueOf()IntlIntl.CollatorIntl.DateTimeFormatIntl.DurationFormatIntl.ListFormatIntl.LocaleIntl.NumberFormatIntl.PluralRulesIntl.RelativeTimeFormatIntl.SegmenterCertaines parties de ce contenu sont protges par le droit d'auteur 19982026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.
| Web Proxy Viewer | New URL | Original Page |