Intl.Locale.prototype.variants
Die variants Zugriffseigenschaft von Intl.Locale-Instanzen gibt die Varianten zurück, die dieser Locale zugeordnet sind, als eine durch Bindestriche (-) getrennte Zeichenkette von Identifikatoren in der ursprünglich angegebenen Reihenfolge.
Beschreibung
Varianten sind Teil der Hauptsprachen-ID. Sie wählen Varianten einer Sprache aus, die das (Sprache, Region, Skript)-Triplett nicht unterscheiden kann. Normalerweise repräsentieren sie dieselbe Sprache in unterschiedlichen Epochen oder verschiedenen Orthografien. Zum Beispiel hat Deutsch die Orthografievarianten 1901 und 1996, die als de-1901 und de-1996 geschrieben werden; die Variante "Frühmoderne Englisch (1500-1700)" wird als en-emodeng geschrieben. Das Subtag kann mehrere durch Bindestriche (-) getrennte Identifikatoren enthalten. Diese Identifikatoren sind technisch gesehen ungeordnet, obwohl sie in der Praxis oft eine semantische Hierarchie haben — zum Beispiel wird der Resian-Dialekt des Slowenischen als sl-rozaj geschrieben, und der San Giorgio/Bila-Dialekt von Resian wird als sl-rozaj-biske geschrieben.
Der Wert der variants-Eigenschaft wird bei der Konstruktion festgelegt, entweder durch den Teil des Locale-Identifikators nach der region oder durch die variants-Option des Intl.Locale()-Konstruktors. Letztere hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.
Der Set-Accessor von variants ist undefined. Man kann diese Eigenschaft nicht direkt ändern.
Beispiele
Wie andere Locale-Subtags können die Varianten über den locale-String oder ein Konfigurationsobjekt-Argument in das Intl.Locale-Objekt hinzugefügt werden.
Hinzufügen von Varianten über den locale-String
Die Varianten, wenn vorhanden, sind die letzten Teile eines gültigen Unicode-Sprachidentifikator-Strings und können dem initialen Locale-Identifikator-String hinzugefügt werden, der in den Intl.Locale()-Konstruktor übergeben wird. Beachten Sie, dass die Varianten kein erforderlicher Teil eines Locale-Identifikators sind.
const locale = new Intl.Locale("sl-rozaj-biske");
console.log(locale.variants); // "rozaj-biske"
Hinzufügen von Varianten über das Konfigurationsobjekt
Der Intl.Locale()-Konstruktor hat ein optionales Konfigurationsobjekt-Argument. Setzen Sie die variants-Eigenschaft des Konfigurationsobjekts auf die gewünschten Varianten und übergeben Sie sie dann an den Konstruktor.
const locale = new Intl.Locale("sl", { variants: "rozaj-biske" });
console.log(locale.variants); // "rozaj-biske"
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-Intl.Locale.prototype.variants |
Browser-Kompatibilität
Siehe auch
Intl.Locale- Unicode variant subtag in der Unicode-Locale-Daten-Markup-Sprache-Spezifikation
- IANA language subtag registry