CKTIS / JavaScript
Intl.Collator: sensibilità e regole di ordinamento locali
Confronta e ordina stringhe secondo le regole della lingua selezionata. L’opzione `sensitivity` stabilisce quali differenze contano nel confronto.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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.Con Intl.Collator, sono le regole di ordinamento dell’impostazione locale effettiva a stabilire che cosa costituisce una lettera di base. Nell’ordinamento predefinito del tedesco, ä è una variante di a; in svedese è una lettera distinta. Perciò, con "base", le due stringhe possono risultare equivalenti in de, ma non in sv.
Le lettere di base diverse restano distinte con qualsiasi valore di sensitivity. Tra varianti della stessa lettera di base, "base" ignora i segni diacritici e le differenze tra maiuscole e minuscole; "accent" distingue i diacritici, ma non le maiuscole dalle minuscole; "case" fa il contrario; "variant" distingue entrambi gli aspetti e può distinguerne altri. Un valore non previsto, come "ignore", genera un RangeError.
Con l’impostazione predefinita usage: "sort", la sensibilità predefinita è "variant". Con usage: "search", dipende dall’impostazione locale; in questa modalità, usa compare(a, b) === 0 per verificare una corrispondenza, non per ordinare. In un ordinamento, un esito negativo indica che a precede b, uno positivo che lo segue, e zero che il confronto li considera equivalenti. Non aspettarti esattamente -1 o 1. La funzione collator.compare è legata all’istanza, quindi puoi passarla direttamente a sort(). Un risultato pari a 0 non implica a === b.
Richiedi esplicitamente un’impostazione locale: se non si trova alcuna corrispondenza per quelle richieste, l’ambiente usa quella predefinita. Intl.Collator.supportedLocalesOf() verifica il supporto senza ripiegare sull’impostazione predefinita dell’ambiente, mentre resolvedOptions().locale mostra quella effettiva. I dati di ordinamento possono variare tra ambienti e versioni anche a parità di opzioni effettive.
Esempi
{
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}`);
}
}
}Risultato
base: true, true accent: false, true case: true, false variant: false, false de: true sv: false
Nelle prime quattro righe, `true` indica che la coppia risulta equivalente: prima `a` e `á`, poi `a` e `A`. Le ultime due righe confrontano `a` con `ä` usando `"base"` in `de` e `sv`. L’output mostrato presuppone il supporto di queste impostazioni e di `en`, con le regole di ordinamento predefinite descritte.
Lezioni correlate
- JavaScript · Lezione 24 · Intermedio · Versione: 3