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 Accessor-Eigenschaft von Intl.Locale Instanzen gibt den Kollationstyp für dieses Locale zurück, der verwendet wird, um Zeichenfolgen gemäß den Regeln des Locales zu ordnen.

Beschreibung

Kollation ist der Prozess der Anordnung von Zeichenfolgen. Sie wird immer dann verwendet, wenn Zeichenfolgen sortiert und in eine bestimmte Reihenfolge gebracht werden müssen, von Suchergebnissen bis zur Anordnung von Einträgen in einer Datenbank. Während die Idee, Zeichenfolgen zu ordnen, trivial erscheinen mag, kann die Vorstellung von Ordnung von Region zu Region und Sprache zu Sprache variieren. Für eine Liste der unterstützten Kollationstypen siehe Intl.supportedValuesOf().

Der Wert der collation Eigenschaft wird zur Erstellungszeit festgelegt, entweder durch den co Schlüssel der Locale-Kennung oder durch die collation Option des Intl.Locale() Konstruktors. Letzteres hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

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

Beispiele

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

Hinzufügen eines Kollationstyps über den Locale-String

Im Unicode-Locale-String-Spec ist collation ein "Erweiterungs-Subtag". Diese Subtags fügen zusätzliche Daten über das Locale hinzu und werden den Locale-Kennungen mit dem -u Erweiterungsschlüssel hinzugefügt. Um den Kollationstyp dem anfänglichen Locale-Kennung-String hinzuzufügen, der an den Intl.Locale() Konstruktor übergeben wird, fügen Sie zuerst den -u Erweiterungsschlüssel hinzu, falls er nicht existiert. Fügen Sie dann die -co Erweiterung hinzu, um anzuzeigen, dass Sie einen Kollationstyp hinzufügen. Schließlich fügen Sie den Kollationstyp hinzu.

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

Hinzufügen eines Kollationstyps über das Konfigurationsobjekt-Argument

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das eine von mehreren Erweiterungsarten enthalten kann, einschließlich Kollationstypen. Setzen Sie die collation Eigenschaft des Konfigurationsobjekts auf den gewünschten Kollationstyp und übergeben Sie es dann dem Konstruktor.

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch