Intl.Locale : propriété collation
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2020.
La propriété d'accesseur collation des instances de Intl.Locale retourne le type de collation (angl.) pour cette locale, qui est utilisé pour ordonner les chaînes de caractères selon les règles de la locale.
Description
La collation est le processus de tri des chaînes de caractères. Elle est utilisée chaque fois que des chaînes de caractères doivent être triées et placées dans un certain ordre, des résultats de recherche à l'organisation des enregistrements dans une base de données. Bien que l'idée de placer des chaînes de caractères dans un ordre puisse sembler triviale, la notion d'ordre peut varier d'une région à l'autre et d'une langue à l'autre. Pour une liste des types de collation pris en charge, voir Intl.supportedValuesOf().
La valeur de la propriété collation est définie au moment de la construction, soit avec la clé co de l'identifiant de la locale, soit avec l'option collation du constructeur Intl.Locale(). Cette dernière prend le pas si les deux sont présentes ; et si aucune n'est présente, la propriété a pour valeur undefined.
Le mutateur d'accesseur de collation est undefined. Vous ne pouvez pas modifier cette propriété directement.
Exemples
Comme les autres sous-balises de locale, le type de classement peut être ajouté à l'objet Intl.Locale par le biais de la chaîne de locale ou d'un argument d'objet de configuration passé au constructeur.
Ajouter un type de collation par le biais de la chaîne de locale
Dans la spécification Unicode des chaînes de caractères de locale (angl.), collation est une « sous-balise d'extension ». Ces sous-balises ajoutent des informations supplémentaires concernant la locale et sont ajoutées aux identifiants de locale à l'aide de la clé d'extension -u. Pour ajouter le type de collation à la chaîne de caractères d'identifiant de locale initiale passée au constructeur Intl.Locale(), ajoutez d'abord la clé d'extension -u si elle n'existe pas. Ensuite, ajoutez l'extension -co pour indiquer que vous ajoutez un type de collation. Enfin, ajoutez le type de collation.
const locale = new Intl.Locale("zh-Hant-u-co-zhuyin");
console.log(locale.collation); // "zhuyin"
Ajouter un type de collation par le biais de l'objet de configuration
Le constructeur Intl.Locale() a un argument d'objet de configuration optionnel, qui peut contenir n'importe lequel de plusieurs types d'extensions, y compris les types de collation. Définissez la propriété collation de l'objet de configuration sur le type de collation souhaité, puis passez-le dans le constructeur.
const locale = new Intl.Locale("zh-Hant", { collation: "zhuyin" });
console.log(locale.collation); // "zhuyin"
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.Locale.prototype.collation> |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.Locale - La méthode
Intl.Locale.prototype.getCollations()