Intl.Locale.prototype.caseFirst
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 caseFirst-Accessor-Property von Intl.Locale-Instanzen gibt an, ob nach den Sortierregeln dieser Locale Groß- oder Kleinbuchstaben zuerst sortiert werden.
Beschreibung
Die Sortierregeln einer Locale bestimmen, in welcher Reihenfolge Zeichenfolgen sortiert werden. Bei bestimmten Locales wird die Groß- oder Kleinschreibung eines Zeichens (GROSSBUCHSTABEN oder kleinbuchstaben) bei der Sortierung berücksichtigt. Diese zusätzliche Regel kann in der caseFirst-Property eines Intl.Locale-Objekts ausgedrückt werden. Die caseFirst-Property kann einen der drei Werte in der folgenden Tabelle haben.
| Wert | Beschreibung |
|---|---|
upper |
Großbuchstaben werden vor Kleinbuchstaben sortiert. |
lower |
Kleinbuchstaben werden vor Großbuchstaben sortiert. |
false |
Keine besondere Sortierung nach Groß- und Kleinschreibung. |
Der Wert der caseFirst-Property wird bei der Erstellung festgelegt: entweder über den kf-Schlüssel des Locale-Bezeichners oder über die caseFirst-Option des Intl.Locale()-Konstruktors. Wenn beide angegeben sind, hat die Option Vorrang. Ist keiner von beiden angegeben, hat die Property den Wert undefined.
Der Set-Accessor von caseFirst ist undefined. Sie können diese Property nicht direkt ändern.
Beispiele
Wie andere Locale-Subtags kann der caseFirst-Wert dem Intl.Locale-Objekt über den Locale-String oder über ein Konfigurationsobjekt als Argument des Konstruktors hinzugefügt werden.
Einen caseFirst-Wert über den Locale-String hinzufügen
Gemäß der Spezifikation für Unicode-Locale-Strings ist caseFirst ein „Extension-Subtag“. Solche Subtags ergänzen zusätzliche Angaben zur Locale und werden Locale-Bezeichnern mithilfe des Erweiterungsschlüssels -u hinzugefügt. Um dem ursprünglichen Locale-Bezeichner, der an den Intl.Locale()-Konstruktor übergeben wird, einen caseFirst-Wert hinzuzufügen, fügen Sie zunächst den Erweiterungsschlüssel -u hinzu, falls er noch nicht vorhanden ist. Fügen Sie anschließend -kf hinzu, um anzugeben, dass ein Wert für caseFirst folgt. Fügen Sie zuletzt den caseFirst-Wert hinzu.
const locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // "upper"
Einen caseFirst-Wert über das Konfigurationsobjekt hinzufügen
Der Intl.Locale()-Konstruktor akzeptiert optional ein Konfigurationsobjekt als Argument. Dieses kann verschiedene Erweiterungstypen enthalten, darunter caseFirst. Setzen Sie die caseFirst-Property des Konfigurationsobjekts auf den gewünschten caseFirst-Wert und übergeben Sie das Objekt anschließend an den Konstruktor.
const locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // "lower"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-Intl.Locale.prototype.caseFirst |