Intl.ListFormat
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Das Intl.ListFormat
-Objekt ermöglicht die sprachsensitive Formatierung von Listen.
Probieren Sie es aus
Konstruktor
Intl.ListFormat()
-
Erstellt ein neues
Intl.ListFormat
-Objekt.
Statische Methoden
Intl.ListFormat.supportedLocalesOf()
-
Gibt ein Array zurück, das die von den bereitgestellten Locales enthält, die unterstützt werden, ohne auf die Standard-Locale der Laufzeit zurückgreifen zu müssen.
Instanzeigenschaften
Diese Eigenschaften sind auf Intl.ListFormat.prototype
definiert und werden von allen Intl.ListFormat
-Instanzen geteilt.
Intl.ListFormat.prototype.constructor
-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Intl.ListFormat
-Instanzen ist der Anfangswert derIntl.ListFormat
-Konstruktor. Intl.ListFormat.prototype[Symbol.toStringTag]
-
Der Anfangswert der
[Symbol.toStringTag]
-Eigenschaft ist der String"Intl.ListFormat"
. Diese Eigenschaft wird inObject.prototype.toString()
verwendet.
Instanzmethoden
Intl.ListFormat.prototype.format()
-
Gibt eine sprachspezifisch formatierte Zeichenkette zurück, die die Elemente der Liste darstellt.
Intl.ListFormat.prototype.formatToParts()
-
Gibt ein Array von Objekten zurück, das die verschiedenen Komponenten repräsentiert, die zur Formatierung einer Liste von Werten in einer locale-bewussten Art verwendet werden können.
Intl.ListFormat.prototype.resolvedOptions()
-
Gibt ein neues Objekt mit Eigenschaften zurück, die die bei der Erstellung des aktuellen
Intl.ListFormat
-Objekts berechneten Locale- und Formatierungsoptionen widerspiegeln.
Beispiele
Verwendung von format
Das folgende Beispiel zeigt, wie ein Listen-Formatter mit der englischen Sprache erstellt wird.
const list = ["Motorcycle", "Bus", "Car"];
console.log(
new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
list,
),
);
// Motorcycle, Bus and Car
console.log(
new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
list,
),
);
// Motorcycle, Bus or Car
console.log(
new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),
);
// Motorcycle Bus Car
Verwendung von formatToParts
Das folgende Beispiel zeigt, wie ein Listen-Formatter erstellt wird, der formatierte Teile zurückgibt
const list = ["Motorcycle", "Bus", "Car"];
console.log(
new Intl.ListFormat("en-GB", {
style: "long",
type: "conjunction",
}).formatToParts(list),
);
// [ { "type": "element", "value": "Motorcycle" },
// { "type": "literal", "value": ", " },
// { "type": "element", "value": "Bus" },
// { "type": "literal", "value": ", and " },
// { "type": "element", "value": "Car" } ];
Spezifikationen
Specification |
---|
ECMAScript Internationalization API Specification # listformat-objects |
Browser-Kompatibilität
BCD tables only load in the browser