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