Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Intl.Collator: občutljivost primerjanja in jezikovna pravila razvrščanja

Primerjajte in razvrščajte nize po pravilih izbrane jezikovne nastavitve. Možnost `sensitivity` določa, katere razlike vplivajo na primerjavo.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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.

Pri Intl.Collator pravila razvrščanja dejansko uporabljene jezikovne nastavitve (locale) določajo, kaj šteje za osnovno črko. Pri privzetem nemškem razvrščanju je ä različica črke a, pri švedskem pa samostojna črka. Zato sta pri "base" niza v de lahko enakovredna, v sv pa ne.

Različne osnovne črke se razlikujejo pri vsaki vrednosti sensitivity. Pri različicah iste osnovne črke "base" ne upošteva diakritičnih znamenj niti velikosti črk; "accent" upošteva diakritična znamenja, ne pa velikosti črk; "case" ravna obratno; "variant" upošteva oboje, lahko pa upošteva tudi druge razlike. Vrednost zunaj tega seznama, na primer "ignore", sproži RangeError.

V privzetem načinu usage: "sort" je privzeta občutljivost "variant". Pri usage: "search" je odvisna od jezikovne nastavitve; v tem načinu uporabite compare(a, b) === 0 za preverjanje ujemanja, ne za razvrščanje. Pri razvrščanju negativen rezultat pomeni, da je a pred b, pozitiven, da je za njim, nič pa, da sta po primerjavi enakovredna. Ne zanašajte se na točno -1 ali 1. Funkcija collator.compare je vezana na primerek, zato jo lahko posredujete neposredno metodi sort(). Rezultat 0 ne pomeni, da velja a === b.

Izrecno zahtevajte jezikovno nastavitev: če se nobena od zahtevanih ne ujema z razpoložljivimi nastavitvami, okolje uporabi privzeto. Intl.Collator.supportedLocalesOf() preveri podporo brez preklopa na privzeto nastavitev okolja, resolvedOptions().locale pa pokaže dejansko uporabljeno nastavitev. Podatki za razvrščanje se lahko razlikujejo med okolji in različicami tudi pri enakih dejansko uporabljenih možnostih.

Primeri

{
  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}`);
    }
  }
}

Rezultat

base: true, true
accent: false, true
case: true, false
variant: false, false
de: true
sv: false

V prvih štirih vrsticah `true` pomeni, da je par pri primerjavi enakovreden: najprej `a` in `á`, nato `a` in `A`. Zadnji dve vrstici primerjata `a` z `ä` pri `"base"` v `de` in `sv`. Prikazani izpis predpostavlja podporo za te jezikovne nastavitve in `en` ter uporabo opisanih privzetih pravil razvrščanja.

Povezane lekcije

  • JavaScript · Lekcija 24 · Srednja · Različica: 3

Viri