Intl.Locale : proprit caseFirst

Description

Les rgles de collation d'une locale sont utilises pour dterminer comment les chanes de caractres sont ordonnes dans cette locale. Certaines locales utilisent la casse d'un caractre (MAJUSCULE ou minuscule) dans le processus de collation. Cette rgle supplmentaire peut tre exprime dans la proprit caseFirst d'un objet Intl.Locale. La proprit caseFirst peut avoir 3 valeurs, dcrites dans le tableau ci-dessous.

La valeur de la proprit caseFirst est dfinie 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 dernire prend le pas si les deux sont prsentes ; et si aucune n'est prsente, la proprit a pour valeur undefined.

Le mutateur d'accesseur de caseFirst est undefined. Vous ne pouvez pas modifier cette proprit directement.

Exemples

Comme pour d'autres sous-balises de locale, la valeur caseFirst peut tre ajoute l'objet Intl.Locale soit par la chane de caractres de description de la locale, soit par un objet de configuration pass en argument au constructeur.

Ajouter une valeur caseFirst par le biais de la chane de caractres de la locale

Dans la spcification Unicode des chanes de caractres de locale (angl.), caseFirst est une  sous-balise d'extension . Ces sous-balises ajoutent des informations supplmentaires concernant la locale et sont ajoutes aux identifiants de locale l'aide de la cl d'extension -u. Pour ajouter la valeur caseFirst la chane de caractres d'identifiant de la locale initiale passe 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.

const locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // "upper"

Ajouter une valeur caseFirst par l'objet de configuration pass en argument au constructeur

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. Dfinissez la proprit caseFirst de l'objet de configuration sur votre valeur caseFirst dsire, puis passez-le dans le constructeur.

const locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // "lower"

Spcifications

Compatibilit des navigateurs

Voir aussi

• L'objet Intl.Locale
• Spcification Unicode pour la collation selon la casse (angl.)