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 septembre 2020.
La propriété d'accesseur caseFirst des instances de Intl.Locale retourne la valeur indiquant si la casse est prise en compte pour les règles de collation de cette locale.
Les règles de collation d'une locale sont utilisées pour déterminer comment les chaînes de caractères sont ordonnées dans cette locale. Certaines locales utilisent la casse d'un caractère (MAJUSCULE ou minuscule) dans le processus de collation. Cette règle supplémentaire peut être exprimée dans la propriété caseFirst d'un objet Intl.Locale. La propriété caseFirst peut avoir 3 valeurs, décrites dans le tableau ci-dessous.
| upper | Les majuscules devraient être triées avant les minuscules. |
| lower | Les minuscules devraient être triées avant les majuscules. |
| false | La casse n'a pas d'importance pour le tri des chaînes de caractères. |
La valeur de la propriété caseFirst est définie au moment de la construction, soit avec la clé kf de l'identifiant de la locale, soit avec l'option caseFirst 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 caseFirst est undefined. Vous ne pouvez pas modifier cette propriété directement.
Comme pour d'autres sous-balises de locale, la valeur caseFirst peut être ajoutée à l'objet Intl.Locale soit par la chaîne de caractères de description de la locale, soit par un objet de configuration passé en argument au constructeur.
Dans la spécification Unicode des chaînes de caractères de locale (angl.), caseFirst 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 la valeur caseFirst à la chaîne de caractères d'identifiant de la 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 -kf pour indiquer que vous ajoutez une valeur pour caseFirst. Enfin, ajoutez la valeur caseFirst.
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 caseFirst. Définissez la propriété caseFirst de l'objet de configuration sur votre valeur caseFirst désirée, puis passez-le dans le constructeur.
| ECMAScript® 2027 Internationalization API Specification # sec-Intl.Locale.prototype.caseFirst |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 25 avr. 2026 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.