KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.Collator: onderscheidingsniveaus en taalafhankelijke sorteerregels

Vergelijk en sorteer tekenreeksen volgens de gekozen taalinstelling. De optie `sensitivity` bepaalt welke verschillen meetellen bij de vergelijking.

Versie: 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.

Bij Intl.Collator bepalen de sorteerregels van de daadwerkelijk gebruikte taalinstelling (locale) wat als basisletter geldt. In de Duitse standaardsortering is ä een variant van a; in de Zweedse is het een aparte letter. Daarom kunnen deze tekenreeksen bij "base" in de als gelijkwaardig gelden, maar niet in sv.

Verschillende basisletters blijven bij elke waarde van sensitivity onderscheiden. Bij varianten van dezelfde basisletter negeert "base" diakritische tekens en hoofdletterverschillen. "accent" maakt onderscheid op basis van diakritische tekens maar niet op basis van hoofdlettergebruik; "case" doet het omgekeerde. "variant" houdt met beide rekening en kan ook andere verschillen meenemen. Een waarde buiten deze lijst, zoals "ignore", veroorzaakt een RangeError.

Bij de standaardmodus usage: "sort" is de standaardwaarde voor sensitivity "variant". Bij usage: "search" hangt die af van de taalinstelling. Gebruik in die modus compare(a, b) === 0 om een overeenkomst te testen, niet om te sorteren. Bij sorteren betekent een negatief resultaat dat a vóór b komt, een positief resultaat dat a erna komt, en nul dat ze als gelijkwaardig worden behandeld. Reken niet op precies -1 of 1. collator.compare is gebonden aan de instantie, dus je kunt de functie rechtstreeks aan sort() doorgeven. De uitkomst 0 betekent niet dat a === b.

Vraag expliciet een taalinstelling aan: als geen van de aangevraagde instellingen kan worden gekoppeld aan een beschikbare instelling, gebruikt de runtime zijn standaardinstelling. Intl.Collator.supportedLocalesOf() controleert ondersteuning zonder op die standaardinstelling terug te vallen; resolvedOptions().locale toont de daadwerkelijk gebruikte instelling. Sorteergegevens kunnen per runtime en versie verschillen, zelfs bij dezelfde effectieve opties.

Voorbeelden

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

Resultaat

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

In de eerste vier regels betekent `true` dat het paar als gelijkwaardig wordt behandeld: eerst `a` en `á`, daarna `a` en `A`. De laatste twee regels vergelijken `a` met `ä` bij `"base"` in `de` en `sv`. De getoonde uitvoer gaat uit van ondersteuning voor deze taalinstellingen en `en`, met de beschreven standaardsorteerregels.

Gerelateerde lessen

  • JavaScript · Les 24 · Gemiddeld · Versie: 3

Bronnen