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

Beschreibung

Die Kollationsregeln einer Locale werden verwendet, um festzulegen, wie Zeichenketten in dieser Locale sortiert werden. In bestimmten Locales wird die Groß- oder Kleinschreibung eines Zeichens bei der Kollation berücksichtigt. 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, aufgeführt in der untenstehenden Tabelle.

caseFirst-Werte

Wert Beschreibung
upper Großbuchstaben werden vor Kleinbuchstaben sortiert.
lower Kleinbuchstaben werden vor Großbuchstaben sortiert.
false Keine spezielle Groß-/Kleinschreibungsreihenfolge.

Beispiele

Einstellung des caseFirst-Wertes über den Locale-String

In der Unicode-Locale-String-Spezifikation entsprechen die Werte, die caseFirst repräsentiert, dem Schlüssel kf. kf wird als Locale-String-"Erweiterungs-Subtag" behandelt. Diese Subtags fügen zusätzliche Informationen über die Locale hinzu und werden zu Locale-Identifikatoren hinzugefügt, indem der -u-Erweiterungsschlüssel verwendet wird. So kann der caseFirst-Wert dem anfänglichen Locale-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. Fügen Sie anschließend den -kf-Erweiterungsschlüssel hinzu, um anzuzeigen, 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"

Einstellung des caseFirst-Wertes über das Konfigurationsobjekt-Argument

Der Intl.Locale()-Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das verwendet werden kann, um Erweiterungstypen zu übergeben. Setzen Sie die caseFirst-Eigenschaft des Konfigurationsobjekts auf den gewünschten caseFirst-Wert und übergeben Sie es dann dem Konstruktor.

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch