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 der Intl.ListFormat-Konstruktor.

Intl.ListFormat.prototype[Symbol.toStringTag]

Der Anfangswert der [Symbol.toStringTag]-Eigenschaft ist der String "Intl.ListFormat". Diese Eigenschaft wird in Object.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.

js
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

js
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

Siehe auch