CKTIS / JavaScript
Intl.Collator: citlivosť porovnávania a pravidlá triedenia podľa jazyka
Porovnávajte a trieďte reťazce podľa pravidiel vybratého jazykového nastavenia. Voľba `sensitivity` určuje, ktoré rozdiely sa pri porovnaní zohľadnia.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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ísmená podľa pravidiel triedenia skutočne použitého jazykového nastavenia (locale). V predvolenom nemeckom triedení je ä variantom a, kým vo švédskom je to samostatné písmeno. Preto sa pri "base" môžu oba reťazce v de považovať za rovnocenné, ale v sv nie.
Rôzne základné písmená sa rozlišujú pri každej hodnote sensitivity. Pri variantoch toho istého základného písmena "base" ignoruje diakritiku aj veľkosť písmen; "accent" rozlišuje diakritiku, ale nie veľkosť písmen; "case" to robí naopak; "variant" rozlišuje oboje a môže zohľadniť aj ďalšie rozdiely. Hodnota mimo tohto zoznamu, napríklad "ignore", vyvolá RangeError.
V predvolenom režime usage: "sort" má citlivosť predvolenú hodnotu "variant". Pri usage: "search" závisí od jazykového nastavenia; v tomto režime používajte compare(a, b) === 0 na overenie zhody, nie na triedenie. Pri triedení záporný výsledok znamená, že a je pred b, kladný, že je za ním, a nula, že ich porovnanie považuje za rovnocenné. Nespoliehajte sa na presné hodnoty -1 alebo 1. Funkcia collator.compare je viazaná na inštanciu, preto ju môžete odovzdať priamo metóde sort(). Výsledok 0 neznamená, že platí a === b.
Zadajte jazykové nastavenie výslovne: ak sa žiadne z požadovaných nepodarí priradiť k dostupnému nastaveniu, prostredie použije svoje predvolené. Intl.Collator.supportedLocalesOf() overí podporu bez použitia predvoleného nastavenia prostredia ako náhrady a resolvedOptions().locale ukáže skutočne použité nastavenie. Údaje na triedenie sa môžu medzi prostrediami a verziami líšiť aj pri rovnakých skutočne použitých voľbách.
Prí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ýsledok
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
V prvých štyroch riadkoch `true` znamená, že porovnanie považuje dvojicu za rovnocennú: najprv `a` a `á`, potom `a` a `A`. Posledné dva riadky porovnávajú `a` s `ä` pomocou `"base"` v `de` a `sv`. Uvedený výstup predpokladá podporu týchto jazykových nastavení a `en` a použitie opísaných predvolených pravidiel triedenia.
Súvisiace lekcie
- JavaScript · Lekcia 24 · Stredne pokročilá · Verzia: 3