Intl.Locale.prototype.caseFirst

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 caseFirst Zugriffs-Eigenschaft von Intl.Locale Instanzen gibt an, ob bei den Kollationsregeln dieser Sprachumgebung die Groß- und Kleinschreibung berücksichtigt wird.

Beschreibung

Die Kollationsregeln einer Sprachumgebung bestimmen, wie Zeichenfolgen in dieser Umgebung geordnet werden. Bestimmte Sprachumgebungen verwenden den Fall eines Zeichens (GROSSBUCHSTABEN oder kleinbuchstaben) im Kollationsprozess. Diese zusätzliche Regel kann in der caseFirst-Eigenschaft eines Intl.Locale-Objekts ausgedrückt werden.

Es gibt 3 Werte, die die caseFirst-Eigenschaft annehmen kann, wie in der folgenden Tabelle dargestellt.

caseFirst-Werte

Wert Beschreibung
upper Großbuchstaben werden vor Kleinbuchstaben sortiert.
lower Kleinbuchstaben werden vor Großbuchstaben sortiert.
false Keine spezielle Berücksichtigung der Groß- und Kleinschreibung.

Beispiele

Setzen des caseFirst-Wertes über den Sprachumgebungs-String

In der Unicode Locale String Spezifikation entsprechen die Werte, die caseFirst darstellt, dem Schlüssel kf. kf wird als "Erweiterungs-Subtag" im Sprachumgebungs-String behandelt. Diese Subtags fügen zusätzliche Daten über die Sprachumgebung hinzu und werden durch den -u Erweiterungsschlüssel zu Sprachumgebungskennungen hinzugefügt. Der caseFirst-Wert kann somit dem initialen Sprachumgebungs-Identifikator-String hinzugefügt werden, der an den Locale-Konstruktor übergeben wird. Um den caseFirst-Wert hinzuzufügen, fügen Sie zuerst den -u Erweiterungsschlüssel zum String hinzu. Als Nächstes fügen Sie den -kf Erweiterungsschlüssel hinzu, um anzugeben, dass Sie einen Wert für caseFirst hinzufügen. Schließlich fügen Sie den caseFirst-Wert zum String hinzu.

js
const locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // Prints "upper"

Festlegen des caseFirst-Wertes über das Konfigurationsobjekt-Argument

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das zum Übergeben von Erweiterungstypen verwendet werden kann. Setzen Sie die caseFirst-Eigenschaft des Konfigurationsobjekts auf den gewünschten caseFirst-Wert und übergeben Sie diesen dann an den Konstruktor.

js
const locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // Prints "lower"

Spezifikationen

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

Browser-Kompatibilität

Siehe auch