Intl.Collator
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Das Intl.Collator
-Objekt ermöglicht sprachabhängige Zeichenfolgenvergleiche.
Probieren Sie es aus
Konstruktor
Intl.Collator()
-
Erstellt ein neues
Collator
-Objekt.
Statische Methoden
Intl.Collator.supportedLocalesOf()
-
Gibt ein Array zurück, das diejenigen der bereitgestellten Locales enthält, die unterstützt werden, ohne auf die Standardsprache des Laufzeitsystems zurückgreifen zu müssen.
Instanz-Eigenschaften
Diese Eigenschaften sind auf Intl.Collator.prototype
definiert und werden von allen Intl.Collator
Instanzen geteilt.
Intl.Collator.prototype.constructor
-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Intl.Collator
Instanzen ist der Anfangswert derIntl.Collator
Konstruktor. Intl.Collator.prototype[Symbol.toStringTag]
-
Der Anfangswert der
[Symbol.toStringTag]
Eigenschaft ist der String"Intl.Collator"
. Diese Eigenschaft wird inObject.prototype.toString()
verwendet.
Instanz-Methoden
Intl.Collator.prototype.compare()
-
Getter-Funktion, die zwei Zeichenfolgen gemäß der Sortierreihenfolge dieses
Intl.Collator
-Objekts vergleicht. Intl.Collator.prototype.resolvedOptions()
-
Gibt ein neues Objekt mit Eigenschaften zurück, das die während der Initialisierung des Objekts berechneten Locale- und Sortieroptionen widerspiegelt.
Beispiele
Verwendung von Collator
Das folgende Beispiel demonstriert die unterschiedlichen potenziellen Ergebnisse, wenn ein String vor, nach oder auf der gleichen Ebene wie ein anderer auftritt:
console.log(new Intl.Collator().compare("a", "c")); // -1, or some other negative value
console.log(new Intl.Collator().compare("c", "a")); // 1, or some other positive value
console.log(new Intl.Collator().compare("a", "a")); // 0
Beachten Sie, dass die in den obigen Code gezeigten Ergebnisse zwischen verschiedenen Browsern und Browserversionen variieren können. Dies liegt daran, dass die Werte implementationsspezifisch sind. Das heißt, die Spezifikation erfordert nur, dass die Vor- und Nachwerte negativ und positiv sind.
Verwendung von Locales
Die durch Intl.Collator.prototype.compare()
bereitgestellten Ergebnisse variieren zwischen den Sprachen. Um die Sortierreihenfolge der Sprache zu erhalten, die in der Benutzeroberfläche Ihrer Anwendung verwendet wird, stellen Sie sicher, dass Sie diese Sprache (und möglicherweise einige Ersatzsprachen) mit dem locales
-Argument angeben:
// in German, ä sorts with a
console.log(new Intl.Collator("de").compare("ä", "z"));
// -1, or some other negative value
// in Swedish, ä sorts after z
console.log(new Intl.Collator("sv").compare("ä", "z"));
// 1, or some other positive value
Verwendung von Optionen
Die durch Intl.Collator.prototype.compare()
bereitgestellten Ergebnisse können mithilfe des options
-Arguments angepasst werden:
// in German, ä has a as the base letter
console.log(new Intl.Collator("de", { sensitivity: "base" }).compare("ä", "a"));
// 0
// in Swedish, ä and a are separate base letters
console.log(new Intl.Collator("sv", { sensitivity: "base" }).compare("ä", "a"));
// 1, or some other positive value
Spezifikationen
Specification |
---|
ECMAScript Internationalization API Specification # collator-objects |
Browser-Kompatibilität
BCD tables only load in the browser