Intl.Locale.prototype.collation

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Die collation Zugriffsleiste von Intl.Locale Instanzen gibt den Sortieralgorithmus für diese Locale zurück, der verwendet wird, um Zeichenketten entsprechend den Regeln der Locale zu ordnen.

Beschreibung

Sortierung ist der Prozess der Anordnung von Zeichenketten. Sie wird immer dann verwendet, wenn Zeichenketten sortiert und in eine bestimmte Reihenfolge gebracht werden müssen, von Suchabfrageergebnissen bis zur Anordnung von Datensätzen in einer Datenbank. Während die Idee, Zeichenketten in eine Reihenfolge zu bringen, trivial erscheinen mag, kann die Vorstellung von Ordnung je nach Region und Sprache variieren. Der Wert der collation Eigenschaft wird zum Zeitpunkt der Erstellung festgelegt, entweder durch den co Schlüssel des Locale-Identifiers oder durch die collation Option des Intl.Locale() Konstruktors. Letzterer hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

Eine Liste der unterstützten Sortiertypen finden Sie unter Intl.Locale.prototype.getCollations().

Der Set-Zugriffsmechanismus von collation ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Locale-Subtags kann der Sortiertyp dem Intl.Locale Objekt über den Locale-String oder ein Konfigurationsobjekt-Argument für den Konstruktor hinzugefügt werden.

Hinzufügen eines Sortiertyps über den Locale-String

Im Unicode-Locale-String-Spezifikationsdokument sind Sortiertypen "Erweiterungssubtags". Diese Subtags fügen zusätzliche Daten zur Locale hinzu und werden durch die Verwendung der -u Erweiterung zu Locale-Identifiers hinzugefügt. Daher kann der Sortiertyp dem anfänglichen Locale-String hinzugefügt werden, der an den Intl.Locale() Konstruktor übergegeben wird. Um den Sortiertyp hinzuzufügen, fügen Sie zuerst die -u Erweiterung zum String hinzu. Fügen Sie dann die -co Erweiterung hinzu, um anzuzeigen, dass Sie einen Sortiertyp hinzufügen. Schließlich fügen Sie den Sortiertyp zum String hinzu.

js
const locale = new Intl.Locale("zh-Hant-u-co-zhuyin");
console.log(locale.collation); // "zhuyin"

Hinzufügen eines Sortiertyps über das Konfigurationsobjekt-Argument

Der Intl.Locale() Konstruktor verfügt über ein optionales Konfigurationsobjekt-Argument, das mehrere Erweiterungstypen enthalten kann, einschließlich Sortiertypen. Setzen Sie die collation Eigenschaft des Konfigurationsobjekts auf den gewünschten Sortiertyp und übergeben Sie dann das Objekt an den Konstruktor.

js
const locale = new Intl.Locale("zh-Hant", { collation: "zhuyin" });
console.log(locale.collation); // "zhuyin"

Spezifikationen

Specification
ECMAScript Internationalization API Specification
# sec-Intl.Locale.prototype.collation

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch