CKTIS / JavaScript
Intl.Collator: citlivost porovnávání a pravidla řazení podle jazyka
Porovnávejte a řaďte řetězce podle pravidel vybraného jazykového nastavení. Volba `sensitivity` určuje, které rozdíly se při porovnávání zohlední.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 určuje základní písmena podle pravidel řazení skutečně použitého jazykového nastavení (locale). Ve výchozím německém řazení je ä variantou a, zatímco ve švédském je to samostatné písmeno. Proto se při "base" mohou oba řetězce v de porovnat jako rovnocenné, ale v sv ne.
Různá základní písmena se rozlišují při každé hodnotě sensitivity. U variant téhož základního písmene "base" ignoruje diakritiku i velikost písmen; "accent" rozlišuje diakritiku, ale ne velikost písmen; "case" to dělá naopak; "variant" rozlišuje obojí a může zohlednit i další rozdíly. Hodnota mimo tento seznam, například "ignore", vyvolá RangeError.
Ve výchozím režimu usage: "sort" má citlivost výchozí hodnotu "variant". Při usage: "search" závisí na jazykovém nastavení; v tomto režimu používejte compare(a, b) === 0 k ověření shody, nikoli k řazení. Při řazení záporný výsledek znamená, že a je před b, kladný že je za ním, a nula znamená, že je porovnání považuje za rovnocenné. Nespoléhejte na přesné hodnoty -1 nebo 1. Funkce collator.compare je svázaná s instancí, takže ji můžete předat přímo metodě sort(). Výsledek 0 neznamená, že platí a === b.
Zadejte jazykové nastavení výslovně: pokud se žádné z požadovaných nepodaří přiřadit k dostupnému nastavení, prostředí použije své výchozí. Intl.Collator.supportedLocalesOf() ověří podporu bez přechodu na výchozí nastavení prostředí a resolvedOptions().locale ukáže skutečně použité nastavení. Data pro řazení se mohou mezi prostředími a verzemi lišit i při stejných skutečně použitých volbách.
Příklady
{
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}`);
}
}
}Výsledek
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
V prvních čtyřech řádcích `true` znamená, že porovnání považuje dvojici za rovnocennou: nejprve `a` a `á`, potom `a` a `A`. Poslední dva řádky porovnávají `a` s `ä` pomocí `"base"` v `de` a `sv`. Uvedený výstup předpokládá podporu těchto jazykových nastavení a `en` a použití popsaných výchozích pravidel řazení.
Související lekce
- JavaScript · Lekce 24 · Středně pokročilá · Verze: 3