CKTIS / JavaScript
Intl.Collator: чувствителност при сравнение и езикови правила за сортиране
Сравнявайте и сортирайте низове според правилата на избраната езикова настройка. Опцията `sensitivity` определя кои разлики влияят на сравнението.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
new Intl.Collator(locales, { sensitivity: "base" | "accent" | "case" | "variant", usage: "sort" | "search" })
collator.compare(a, b)
strings.sort(collator.compare)
Intl.Collator.supportedLocalesOf(locales)
collator.resolvedOptions()
The `|` notation lists alternatives; pass one string value per option. Both constructor arguments and both shown options are optional.В Intl.Collator правилата за сортиране на действително използваната езикова настройка (locale) определят какво се смята за основна буква. При стандартното немско сортиране ä е разновидност на a, а при шведското е отделна буква. Затова при "base" двата низа могат да се смятат за равностойни в de, но не и в sv.
Различните основни букви се различават при всяка стойност на sensitivity. При разновидности на една и съща основна буква "base" пренебрегва диакритичните знаци и разликата между главни и малки букви; "accent" отчита диакритичните знаци, но не различава главни от малки букви; "case" прави обратното; "variant" отчита и двата вида разлики и може да отчита и други. Стойност извън този списък, например "ignore", предизвиква RangeError.
При режима по подразбиране usage: "sort" чувствителността по подразбиране е "variant". При usage: "search" тя зависи от езиковата настройка; в този режим използвайте compare(a, b) === 0 за проверка за съвпадение, а не за сортиране. При сортиране отрицателният резултат означава, че a е преди b, положителният — че е след него, а нулата — че сравнението ги смята за равностойни. Не разчитайте на точно -1 или 1. Функцията collator.compare е обвързана с екземпляра и може да се подаде направо на sort(). Резултат 0 не означава, че a === b.
Посочете изрично езикова настройка: ако никоя от заявените не съответства на налична настройка, средата използва своята настройка по подразбиране. Intl.Collator.supportedLocalesOf() проверява поддръжката, без да прибягва до настройката по подразбиране на средата, а resolvedOptions().locale показва действително използваната настройка. Данните за сортиране могат да се различават между среди и версии дори при еднакви действително използвани опции.
Примери
{
const locales = ["en", "de", "sv"];
if (typeof Intl === "undefined" || typeof Intl.Collator !== "function" ||
Intl.Collator.supportedLocalesOf(locales).length !== locales.length) {
console.log("Intl.Collator or required locales unavailable");
} else {
for (const sensitivity of ["base", "accent", "case", "variant"]) {
const { compare } = new Intl.Collator("en", { sensitivity });
console.log(`${sensitivity}: ${compare("a", "á") === 0}, ${compare("a", "A") === 0}`);
}
for (const locale of ["de", "sv"]) {
const { compare } = new Intl.Collator(locale, { sensitivity: "base" });
console.log(`${locale}: ${compare("a", "ä") === 0}`);
}
}
}Резултат
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
В първите четири реда `true` означава, че двойката се смята за равностойна: първо `a` и `á`, след това `a` и `A`. Последните два реда сравняват `a` с `ä` при `"base"` в `de` и `sv`. Показаният резултат предполага поддръжка на тези настройки и `en`, както и прилагане на описаните правила за сортиране по подразбиране.
Свързани уроци
- JavaScript · Урок 24 · Средно · Версия: 3