Intl.DisplayNames
=================

L'objet **`Intl.DisplayNames`** est un constructeur d'objets qui permettent de fournir des traductions des noms de langues, régions et systèmes d'écriture.

Exemple interactif
------------------

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.

Méthodes des instances
----------------------

`Intl.DisplayNames.prototype.of()`

Cette méthodes reçoit un `code` et retourne une chaine à partir sur la langue et les options fournies lors de l'instanciation de `Intl.DisplayNames`.

`Intl.DisplayNames.prototype.resolvedOptions()`

Retourne un nouvel objet dont les propriété feflè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 objet `Intl.DisplayNames` pour une langue et obtenir le nom correspondant à un code de région dans cette langue.


```js
// Obtenir le nom d'une région en anglais
let nomsRégions = new Intl.DisplayNames(['en'], {type: 'region'});
nomsRégions.of('419'); // "Latin America"
nomsRégions.of('BZ');  // "Belize"
nomsRégions.of('US');  // "United States"
nomsRégions.of('BA');  // "Bosnia & Herzegovina"
nomsRégions.of('MM');  // "Myanmar (Burma)"

// Obtenir le nom d'une région en chinois traditionnel
nomsRégions = new Intl.DisplayNames(['zh-Hant'], {type: 'region'});
nomsRégions.of('419'; // "拉丁美洲"
nomsRégions.of('BZ'); // "貝里斯"
nomsRégions.of('US'); // "美國"
nomsRégions.of('BA'); // "波士尼亞與赫塞哥維納"
nomsRégions.of('MM'); // "緬甸"
```

### Affichage des noms de langues

Pour créer un objet `Intl.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.


```js
// 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"); // "德文"
```

### Affichage des noms de systèmes d'écriture

To create an `Intl.DisplayNames` for a locale and get the display name for a script code.

Pour créer un objet `Intl.DisplayNames` pour une langue et obtenir le nom correspondant à un code de système d'écriture dans cette langue.


```js
// Obtenir le nom d'un système d'écriture en anglais
let nomsSystèmes = new Intl.DisplayNames(["en"], { type: "script" });
nomsSystèmes.of("Latn"); // "Latin"
nomsSystèmes.of("Arab"); // "Arabic"
nomsSystèmes.of("Kana"); // "Katakana"

// Obtenir le nom d'un système d'écriture en chinois traditionnel
nomsSystèmes = new Intl.DisplayNames(["zh-Hant"], { type: "script" });
nomsSystèmes.of("Latn"); // "拉丁文"
nomsSystèmes.of("Arab"); // "阿拉伯文"
nomsSystèmes.of("Kana"); // "片假名"
```

### Affichage des noms de devises

Pour créer un objet `Intl.DisplayNames` pour une langue et obtenir le nom correspondant au code d'une devise.


```js
// Obtenir le nom d'une devise in English
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 in Traditional Chinese
nomsDevises = new Intl.DisplayNames(["zh-Hant"], { type: "currency" });
nomsDevises.of("USD"); // "美元"
nomsDevises.of("EUR"); // "歐元"
nomsDevises.of("TWD"); // "新台幣"
nomsDevises.of("CNY"); // "人民幣"
```

Spécifications
--------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # intl-displaynames-objects |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Intl`