Intl.Locale.prototype.collation

Свойство-аксессор collation экземпляров Intl.Locale возвращает тип сопоставления (collation type) для этой локали, который используется для упорядочивания строк в соответствии с правилами локали.

Описание

Сопоставление (collation) — это процесс упорядочивания символьных строк. Оно используется всякий раз, когда строки должны быть отсортированы и расположены в определенном порядке, от результатов поискового запроса до упорядочивания записей в базе данных. Хотя идея упорядочивания строк может показаться тривиальной, представление о порядке может варьироваться от региона к региону и от языка к языку. Список поддерживаемых типов сопоставления см. в Intl.supportedValuesOf().

Значение свойства collation устанавливается во время создания, либо через ключ co идентификатора локали, либо через опцию collation конструктора Intl.Locale(). Последний имеет приоритет, если присутствуют оба; а если не присутствует ни один из них, свойство имеет значение undefined.

Сет-аксессор collation — это undefined. Вы не можете изменить это свойство напрямую.

Примеры

Как и другие подтеги локали, тип сопоставления может быть добавлен к объекту Intl.Locale с помощью строки локали или аргумента объекта конфигурации конструктора.

Добавление типа сопоставления через строку локали

В спецификации строки локали Unicode collation является «подтегом расширения». Эти подтеги добавляют дополнительные данные о локали и добавляются к идентификаторам локали с использованием ключа расширения -u. Чтобы добавить тип сопоставления к исходной строке идентификатора локали, переданной в конструктор Intl.Locale(), сначала добавьте ключ расширения -u, если он не существует. Затем добавьте расширение -co, чтобы указать, что вы добавляете тип сопоставления. Наконец, добавьте тип сопоставления.

const locale = new Intl.Locale("zh-Hant-u-co-zhuyin");
console.log(locale.collation); // "zhuyin"

Добавление типа сопоставления через аргумент объекта конфигурации

Конструктор Intl.Locale() имеет необязательный аргумент объекта конфигурации, который может содержать любой из нескольких типов расширений, включая типы сопоставления. Установите свойство collation объекта конфигурации в желаемый тип сопоставления, а затем передайте его в конструктор.

const locale = new Intl.Locale("zh-Hant", { collation: "zhuyin" });
console.log(locale.collation); // "zhuyin"

Спецификации

Совместимость с браузерами

См. также

• Intl.Locale
• Intl.Locale.prototype.getCollations()