/
index.md
124 lines (91 loc) · 4.63 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
---
title: Intl.DisplayNames
slug: Web/JavaScript/Reference/Global_Objects/Intl/DisplayNames
---
{{JSRef}}
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.
{{EmbedInteractiveExample("pages/js/intl-displaynames.html")}}
## Constructeur
- [`Intl.DisplayNames()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DisplayNames/DisplayNames)
- : Crée un nouvel objet `Intl.DisplayNames`.
## Méthodes statiques
- [`Intl.DisplayNames.supportedLocalesOf()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/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()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DisplayNames/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()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DisplayNames/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
{{Specifications}}
## Compatibilité des navigateurs
{{Compat}}
## Voir aussi
- {{jsxref("Intl")}}