Intl.Locale.prototype.getCollations()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die getCollations() Methode von Intl.Locale Instanzen gibt eine Liste von einem oder mehreren Kollationstypen für diese Lokalisierung zurück.

Hinweis: In einigen Versionen von einigen Browsern wurde diese Methode als Zugriffs-Eigenschaft namens collations implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, ist sie nun als Methode implementiert, um zu verhindern, dass locale.collations === locale.collations false zurückgibt. Siehe die Browser-Kompatibilitätstabelle für Details.

Syntax

getCollations()

Parameter

Keine.

Rückgabewert

Ein Array von Strings, die alle häufig verwendeten Kollationstypen für das Locale darstellen, alphabetisch sortiert, wobei die Werte standard und search immer ausgeschlossen sind. Wenn das Locale bereits über eine collation verfügt, enthält das zurückgegebene Array diesen einzelnen Wert.

Unten ist eine Liste der unterstützten Kollationstypen, angepasst aus der Unicode-Kollationsspezifikation.

Unterstützte Kollationstypen

big5han: Pinyin-Reihenfolge für Latein, big5 Zeichensatzreihenfolge für CJK-Zeichen (für Chinesisch)

Warnung: Der Kollationstyp big5han ist veraltet, nicht verfügbar in Firefox, Chrome oder Edge.
compat: Eine frühere Version der Reihenfolge, für Kompatibilität (für Arabisch)
dict: Wörterbuchartige Reihenfolge (für Singhalesisch)
direct: Binäre Codepunktreihenfolge

Warnung: Der Kollationstyp direct ist veraltet. Nicht verwenden.
ducet: Die Standardreihenfolge der Unicode-Kollationselementtabelle

Warnung: Der Kollationstyp ducet ist im Web nicht verfügbar. Verwenden Sie stattdessen das und Locale ohne Kollationstyp-Spezifikator. und ist die Kollation, die ducet am nächsten kommt.
emoji: Empfohlene Reihenfolge für Emoji-Zeichen (für das und Locale)
eor: Europäische Ordnungsregeln (für das und Locale)
gb2312: Pinyin-Reihenfolge für Latein, gb2312han Zeichensatzreihenfolge für CJK-Zeichen (für Chinesisch)

Warnung: Der Kollationstyp gb2312 ist veraltet, nicht verfügbar in Firefox, Chrome oder Edge.
phonebk: Telefonbuchartige Reihenfolge (für Deutsch)
phonetic: Phonetische Reihenfolge (Sortierung basierend auf Aussprache; für Lingala)
pinyin: Pinyin-Reihenfolge für Latein und für CJK-Zeichen (für Chinesisch)
reformed: Reformierte Reihenfolge (früher für Schwedisch)

Warnung: Nicht explizit verwenden. Dies ist der alte Name für die Standardreihenfolge für Schwedisch die Kollationsnamen unterschieden sich früher von anderen Sprachen. Da dies der Standard war, fordern Sie sv anstelle von sv-u-co-reformed an.
search: Spezieller Kollationstyp für die Zeichenfolgensuche

Warnung: Nicht als Kollationstyp verwenden, da diese Kollation in Intl.Collator, durch den "search" Wert für die usage Option aktiviert wird. Derzeit gibt es keine API für Substring-Suche, daher ist dies derzeit nur zur Filterung einer Liste von Zeichenfolgen nützlich, indem ein vollständiger Zeichenfolgenabgleich des Schlüssels mit jedem Listenelement versucht wird.
searchjl: Spezieller Kollationstyp für die koreanische Initialkonsontantensuche

Warnung: Diese Kollation ist nicht zum Sortieren, auch wenn sie über Intl.Collator mit Nutzung "sort" anstelle von Nutzung "search" bereitgestellt wird.
standard: Standardreihenfolge für jede Sprache, außer Chinesisch (und früher auch Schwedisch)

Warnung: Nicht explizit verwenden. Im Allgemeinen ist es unnötig, dies explizit anzugeben, und dies für Schwedisch anzugeben ist problematisch aufgrund der unterschiedlichen Bedeutung für Schwedisch in der Vergangenheit.
stroke: Pinyin-Reihenfolge für Latein, Strichreihenfolge für CJK-Zeichen (für Chinesisch)
trad: Traditionelle Stilreihenfolge (wie im Spanischen)
unihan: Radikal-Strich-Reihenfolge für Han-Zeichen (für Chinesisch, Japanisch und Koreanisch). Pinyin-Reihenfolge für Latein im Fall von Chinesisch.

Hinweis: Der Kollationstyp unihan ist nicht verfügbar in Chrome oder Edge.
zhuyin: Pinyin-Reihenfolge für Latein, Zhuyin-Reihenfolge für Bopomofo und CJK-Zeichen (für Chinesisch)

Beispiele

Unterstützte Kollationstypen beziehen

Wenn das Locale-Objekt noch keine collation hat, listet getCollations() alle häufig verwendeten Kollationstypen für das gegebene Locale auf. Für Beispiele zur expliziten Festlegung einer collation siehe collation Beispiele.

const locale = new Intl.Locale("zh");
console.log(locale.getCollations()); // ["pinyin", "stroke", "zhuyin", "emoji", "eor"]

Spezifikationen

Specification
Intl Locale Info Proposal # sec-Intl.Locale.prototype.getCollations

Browser-Kompatibilität

BCD tables only load in the browser