Intl.Locale.prototype.collation
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.
Die Accessor-Eigenschaft collation von Intl.Locale-Instanzen gibt den Sortierungstyp für diese Locale zurück. Er wird verwendet, um Zeichenfolgen nach den Regeln der Locale zu ordnen.
Beschreibung
Bei der Sortierung werden Zeichenfolgen in eine bestimmte Reihenfolge gebracht. Dies ist immer dann erforderlich, wenn Zeichenfolgen sortiert werden müssen – von Suchergebnissen bis hin zu Datensätzen in einer Datenbank. Auch wenn das Ordnen von Zeichenfolgen einfach erscheinen mag, kann sich die Reihenfolge je nach Region und Sprache unterscheiden. Eine Liste der unterstützten Sortierungstypen finden Sie unter Intl.supportedValuesOf().
Der Wert der Eigenschaft collation wird beim Erstellen der Instanz festgelegt: entweder über den Schlüssel co des Locale-Bezeichners oder über die Option collation des Konstruktors Intl.Locale(). Wenn beide angegeben sind, hat die Option Vorrang. Ist keiner von beiden angegeben, 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 Sortierungstyp dem Intl.Locale-Objekt über die Locale-Zeichenfolge oder über ein Konfigurationsobjekt als Argument des Konstruktors hinzugefügt werden.
Sortierungstyp über die Locale-Zeichenfolge hinzufügen
In der Spezifikation für Unicode-Locale-Zeichenfolgen ist collation ein „Erweiterungs-Subtag“. Solche Subtags enthalten zusätzliche Informationen zur Locale und werden Locale-Bezeichnern mithilfe des Erweiterungsschlüssels -u hinzugefügt. Um der ursprünglichen Locale-Zeichenfolge, die an den Konstruktor Intl.Locale() übergeben wird, einen Sortierungstyp hinzuzufügen, fügen Sie zuerst den Erweiterungsschlüssel -u hinzu, falls er noch nicht vorhanden ist. Fügen Sie dann die Erweiterung -co hinzu, um anzugeben, dass ein Sortierungstyp folgt. Fügen Sie schließlich den Sortierungstyp hinzu.
const locale = new Intl.Locale("zh-Hant-u-co-zhuyin");
console.log(locale.collation); // "zhuyin"
Sortierungstyp über das Konfigurationsobjekt hinzufügen
Der Konstruktor Intl.Locale() akzeptiert optional ein Konfigurationsobjekt als Argument. Dieses kann verschiedene Erweiterungstypen enthalten, darunter Sortierungstypen. Setzen Sie die Eigenschaft collation des Konfigurationsobjekts auf den gewünschten Sortierungstyp und übergeben Sie das Objekt anschließend an den Konstruktor.
const locale = new Intl.Locale("zh-Hant", { collation: "zhuyin" });
console.log(locale.collation); // "zhuyin"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.Locale.prototype.collation> |