CKTIS / JavaScript
Intl.Collator: czułość porównania i reguły ustawień regionalnych
Porównuj i sortuj tekst zgodnie z regułami wybranego języka. Opcja `sensitivity` określa, które różnice wpływają na wynik porównania.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 porównuje napisy według reguł sortowania faktycznie wybranych ustawień regionalnych (locale). To te reguły określają, co jest literą podstawową. Przy domyślnym sortowaniu niemieckim ä to wariant a, a w szwedzkim to osobna litera. Dlatego przy "base" te dwa napisy mogą być równoważne w de, ale nie w sv.
Różne litery podstawowe są rozróżniane przy każdej wartości sensitivity. W obrębie tej samej litery podstawowej "base" pomija znaki diakrytyczne i wielkość liter; "accent" uwzględnia diakrytykę, ale nie wielkość liter; "case" robi odwrotnie; "variant" uwzględnia obie różnice i może uwzględniać również inne. Wartość spoza tej listy, np. "ignore", powoduje RangeError.
Przy domyślnym usage: "sort" domyślna czułość to "variant". Przy usage: "search" zależy ona od ustawień regionalnych; w tym trybie sprawdzaj dopasowanie przez compare(a, b) === 0, a nie kolejność. W trybie sortowania wynik ujemny oznacza, że a poprzedza b, dodatni — że następuje po b, a zero — że porównanie ich nie rozróżnia. Nie zakładaj, że wynikiem będzie dokładnie -1 lub 1. Funkcja collator.compare jest powiązana z instancją, więc można ją przekazać bezpośrednio do sort(). Wynik 0 nie oznacza, że a === b.
Podaj ustawienia regionalne jawnie: jeśli żadne z żądanych nie pasują do dostępnych, środowisko użyje domyślnych. Intl.Collator.supportedLocalesOf() sprawdza obsługę bez przechodzenia na domyślne ustawienia środowiska, a resolvedOptions().locale pokazuje faktycznie wybrane ustawienia. Dane sortowania mogą się różnić między środowiskami i ich wersjami, nawet przy tych samych efektywnych opcjach.
Przykłady
{
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}`);
}
}
}Wynik
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
W pierwszych czterech wierszach `true` oznacza, że porównanie nie rozróżnia danej pary: najpierw `a` i `á`, potem `a` i `A`. Ostatnie dwa wiersze porównują `a` z `ä` przy `"base"` w `de` i `sv`. Pokazany wynik zakłada obsługę tych ustawień i ustawień `en` oraz opisane domyślne reguły sortowania.
Powiązane lekcje
- JavaScript · Lekcja 24 · Średniozaawansowany · Wersja: 3