Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje