Intl.Locale.prototype.caseFirst
Базовый уровень Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2020 года.
Аксессорная собственность caseFirst экземпляров Intl.Locale возвращает, учитывается ли регистр при правилах сортировки данного языка.
Описание
Правила сортировки языка используются для определения порядка строк в этом языке. Некоторые языки учитывают регистр символа (ЗАГЛАВНЫЕ или строчные) в процессе сортировки. Это дополнительное правило может быть выражено в свойстве caseFirst объекта Intl.Locale. Свойство caseFirst может принимать 3 значения, описанные в таблице ниже.
| Значение | Описание |
|---|---|
upper | Заглавные буквы сортируются перед строчными. |
lower | Строчные буквы сортируются перед заглавными. |
false | Специальный порядок регистра отсутствует. |
Значение свойства caseFirst устанавливается во время создания экземпляра, либо через ключ kf идентификатора языка, либо через опцию caseFirst конструктора Intl.Locale(). Последнее имеет приоритет, если оба присутствуют; если ни одно из них не присутствует, свойство принимает значение undefined.
Сеттер свойства caseFirst является undefined. Вы не можете изменить это свойство напрямую.
Примеры
Как и другие подтеги языка, значение caseFirst может быть добавлено в объект Intl.Locale через строку языка или аргумент объекта конфигурации для конструктора.
Добавление значения caseFirst через строку языка
В спецификации строк языка Unicode caseFirst является "расширяющим подтегом". Эти подтеги добавляют дополнительную информацию о языке и добавляются к идентификаторам языка с использованием ключа расширения -u. Чтобы добавить значение caseFirst к начальной строке идентификатора языка, переданной в конструктор Intl.Locale(), сначала добавьте ключ расширения -u, если он еще не существует. Затем добавьте расширение -kf, чтобы указать, что вы добавляете значение для caseFirst. Наконец, добавьте значение caseFirst.
const locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // "upper"
Добавление значения caseFirst через аргумент объекта конфигурации
Конструктор Intl.Locale() имеет необязательный аргумент объекта конфигурации, который может содержать любые типы расширений, включая caseFirst. Установите свойство caseFirst объекта конфигурации на желаемое значение caseFirst, а затем передайте его в конструктор.
const locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // "lower"
Спецификации
Совместимость с браузерами
| Настольные ПК | Мобильные | Сервер | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | WebView на iOS | Bun | Deno | Node.js | |
caseFirst |
74 |
79 |
75 |
62 |
14 |
74 |
79 |
53 |
14 |
11.0 |
74 |
14 |
1.0.0 |
1.8 |
12.0.0 |
См. также
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/caseFirst