Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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.
DasIntl.ListFormat-Objekt ermöglicht eine sprachsensitive Listenformatierung.
Probieren Sie es aus
const vehicles = ["Motorcycle", "Bus", "Car"];const formatter = new Intl.ListFormat("en", { style: "long", type: "conjunction",});console.log(formatter.format(vehicles));// Expected output: "Motorcycle, Bus, and Car"const formatter2 = new Intl.ListFormat("de", { style: "short", type: "disjunction",});console.log(formatter2.format(vehicles));// Expected output: "Motorcycle, Bus oder Car"const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });console.log(formatter3.format(vehicles));// Expected output: "Motorcycle Bus Car"Konstruktor
Intl.ListFormat()Erstellt ein neues
Intl.ListFormat-Objekt.
Statische Methoden
Intl.ListFormat.supportedLocalesOf()Gibt ein Array zurück, das diejenigen der bereitgestellten Locales enthält, die unterstützt werden, ohne dass auf die Standard-Locale des Laufzeitsystems zurückgegriffen werden muss.
Instanzeigenschaften
Diese Eigenschaften sind aufIntl.ListFormat.prototype definiert und werden von allenIntl.ListFormat Instanzen gemeinsam genutzt.
Intl.ListFormat.prototype.constructorDie 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 einen sprachspezifisch formatierten String zurück, der die Elemente der Liste darstellt.
Intl.ListFormat.prototype.formatToParts()Gibt ein Array von Objekten zurück, die die verschiedenen Komponenten repräsentieren, die verwendet werden können, um eine Liste von Werten in einer localesensiblen Art zu formatieren.
Intl.ListFormat.prototype.resolvedOptions()Gibt ein neues Objekt mit Eigenschaften zurück, die die Locale- und Stilformatierungsoptionen widerspiegeln, die während der Konstruktion des aktuellen
Intl.ListFormat-Objekts berechnet wurden.
Beispiele
Verwendung von format
Das folgende Beispiel zeigt, wie man einen List-Formatter mit der englischen Sprache erstellt.
const list = ["Motorcycle", "Bus", "Car"];console.log( new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format( list, ),);// Motorcycle, Bus and Carconsole.log( new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format( list, ),);// Motorcycle, Bus or Carconsole.log( new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),);// Motorcycle Bus CarVerwendung von formatToParts
Das folgende Beispiel zeigt, wie man einen List-Formatter erstellt, 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® 2026 Internationalization API Specification # listformat-objects |