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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
---
title: Intl.Locale.prototype.collation
slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/collation
tags:
- Internationalisation
- Intl
- JavaScript
- Locale
- Propriété
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/collation
original_slug: Web/JavaScript/Reference/Objets_globaux/Intl/Locale/collation
---
{{JSRef}}
La propriété **`Intl.Locale.prototype.collation`** est une propriété (à laquelle on accède via un accesseur) qui renvoie le [type de collation](https://www.unicode.org/reports/tr35/tr35-collation.html#CLDR_Collation) pour l'instance de `Locale` courante. La collation est la méthode qui permet d'ordonner des chaînes de caractères en fonction des règles de la locale.
## Description
La collation est la façon dont les chaînes de caractères sont ordonnées. Elle est utilisée lorsqu'on doit trier des chaînes de caractères (des résultats de recherche, des enregistrements dans une base de donnée, etc.). Bien que cela puisse sembler trivial, la collation varie d'une région à l'autre et d'une langue à une autre. Cette propriété permet aux développeurs de connaître le type de collation pour une locale donnée.
Voici un tableau listant les types de collation possibles tels que définis dans [la spécification Unicode sur la collation](https://github.com/unicode-org/cldr/blob/2dd06669d833823e26872f249aa304bc9d9d2a90/common/bcp47/collation.xml).
<table class="standard-table">
<caption>
Les différents types de collation
</caption>
<thead>
<tr>
<th scope="col">Type de collation</th>
<th scope="col">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>big5han</code></td>
<td>
Ordre pinyin pour l'alphabet latin et ordre big5 pour les caractères CJK
(utilisés en chinois)
</td>
</tr>
<tr>
<td><code>compat</code></td>
<td>
Une version précédente de l'ordre, utilisée à des fins de compatibilité
</td>
</tr>
<tr>
<td><code>dict</code></td>
<td>Ordre à la façon d'un dictionnaire (comme utilisé en cingalais)</td>
</tr>
<tr>
<td>
<div class="warning">
<p>
<strong>Attention :</strong> Le type <code>direct</code> a été
déprécié et ne doit pas être utilisé.
</p>
</div>
<p><code>direct</code></p>
</td>
<td>Ordre des points de code binaires (utilisé en hindoux)</td>
</tr>
<tr>
<td><code>ducet</code></td>
<td>La collation Unicode par défaut pour les éléments d'un tableau</td>
</tr>
<tr>
<td><code>emoji</code></td>
<td>L'ordre recommandé pour les émojis</td>
</tr>
<tr>
<td><code>eor</code></td>
<td>Règles d'ordre européennes</td>
</tr>
<tr>
<td><code>gb2312</code></td>
<td>
Ordre pinyin pour l'alphabet latin et ordre gb2312han pour les
caractères CJK (utilisés en chinois)
</td>
</tr>
<tr>
<td><code>phonebk</code></td>
<td>Ordre à la façon d'un annuaire (tel qu'en allemand)</td>
</tr>
<tr>
<td><code>phonetic</code></td>
<td>Ordre phonétique, basé sur la prononciation</td>
</tr>
<tr>
<td><code>pinyin</code></td>
<td>
Ordre pinyin pour les caractères de l'alphabet latin et les caractères
CJK (utilisés en chniois)
</td>
</tr>
<tr>
<td><code>reformed</code></td>
<td>Ordre réformé (tel qu'en suédois)</td>
</tr>
<tr>
<td><code>search</code></td>
<td>
Collation spéciale pour les chaînes de caractères utilisées pour des
recherches
</td>
</tr>
<tr>
<td><code>searchjl</code></td>
<td>
Collation spéciale pour la recherche des consonnes initiales en coréen
</td>
</tr>
<tr>
<td><code>standard</code></td>
<td>L'ordre par défaut pour chaque langue</td>
</tr>
<tr>
<td><code>stroke</code></td>
<td>
Ordre pinyin pour l'alphabet latin et ordre de dessin (<em>stroke</em>)
pour les caractères CJK (utilisés en chinois)
</td>
</tr>
<tr>
<td><code>trad</code></td>
<td>Ordre traditionnel (tel qu'en espagnol)</td>
</tr>
<tr>
<td><code>unihan</code></td>
<td>
Ordre pinyin pour l'alphabet latin et ordre Unihan radical pour les
caractères CJK (utilisés en chinois)
</td>
</tr>
<tr>
<td><code>zhuyin</code></td>
<td>
<p>
Ordre pinyin pour l'alphabet latin, ordre zhuyin pour les caractères
Bopomofo et CJK (utilisés en chinois)
</p>
</td>
</tr>
</tbody>
</table>
## Exemples
À l'instar des autres étiquettes, le type de collation peut être défini pour l'objet {{jsxref("Locale", "Intl.Locale")}} via la chaîne de caractères qui définit la locale ou grâce au deuxième paramètre du constructeur qui est un objet de configuration.
### Définir le type de collation via la chaîne décrivant la locale
Le premier argument passé à [`Intl.Locale`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Locale "The Intl.Locale constructor is a standard built-in property of the Intl object.") est une chaîne de caractères qui décrit la locale. Cette chaîne peut contenir des fragments additionnels (en plus de l'identifiant canonique de la locale). Pour cela, on ajoutera `-u` afin d'indiquer qu'on définit une extension. On ajoutera ensuite la clé identifiant cette extension, ici `-co` pour la collation. Enfin, on ajoutera la valeur souhaitée pour cette extension (dans cet exemple, `-emoji`) :
```js
let stringColl = new Intl.Locale("en-Latn-US-u-co-emoji");
console.log(stringColl.collation); // Affichera "emoji" dans la console
```
### Définir le type de collation via l'objet de configuration
Le constructeur [`Intl.Locale`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Locale "The Intl.Locale constructor is a standard built-in property of the Intl object.") possède un deuxième argument optionnel qui est un objet de configuration. Chaque propriété de cet objet pourra permettre de préciser une extension à la locale, y compris un type de collation. Pour définir le type de collation, on pourra utiliser une propriété `collation` sur cet objet avec une des valeurs indiquées ci-avant :
```js
let configColl = new Intl.Locale("en-Latn-US", {collation: "emoji"});
console.log(configColl.collation); // Affichera "emoji" dans la console
```
## Spécifications
| Spécification | État | Commentaires |
| -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ------------ |
| [Proposition pour `Intl.Locale.prototype.collation`](https://tc39.github.io/proposal-intl-locale/#sec-Intl.Locale.prototype.collation) | Proposition de niveau 3 | |
## Compatibilité des navigateurs
{{Compat("javascript.builtins.Intl.Locale.collation")}}
## Voir aussi
- {{jsxref("Locale", "Intl.Locale")}}
|
