Intl.ListFormat.prototype.formatToParts()

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.

Die Methode formatToParts() von Intl.ListFormat-Instanzen 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 lokalisierten Weise zu formatieren.

Probieren Sie es aus

Syntax

js
formatToParts(list)

Parameter

list

Ein iterierbares Objekt, wie ein Array, das gemäß einer Lokale formatiert werden soll.

Rückgabewert

Ein Array von Komponenten, das die formatierten Teile der Liste enthält.

Beschreibung

Während Intl.ListFormat.prototype.format() eine Zeichenkette zurückgibt, die die formatierte Version der Liste darstellt (gemäß der angegebenen Lokalisierungs- und Stiloptionen), gibt formatToParts() ein Array der verschiedenen Komponenten der formatierten Zeichenkette zurück.

Jedes Element des resultierenden Arrays hat zwei Eigenschaften: type und value. Die type-Eigenschaft kann entweder "element" sein, was sich auf einen Wert aus der Liste bezieht, oder "literal", was sich auf eine sprachliche Konstruktion bezieht. Die value-Eigenschaft liefert den Inhalt des Tokens als Zeichenkette.

Die Lokalisierungs- und Stiloptionen, die für die Formatierung verwendet werden, werden beim Erstellen der Intl.ListFormat-Instanz angegeben.

Beispiele

Verwendung von formatToParts

js
const fruits = ["Apple", "Orange", "Pineapple"];
const myListFormat = new Intl.ListFormat("en-GB", {
  style: "long",
  type: "conjunction",
});

console.table(myListFormat.formatToParts(fruits));
// [
//  { "type": "element", "value": "Apple" },
//  { "type": "literal", "value": ", " },
//  { "type": "element", "value": "Orange" },
//  { "type": "literal", "value": " and " },
//  { "type": "element", "value": "Pineapple" }
// ]

Spezifikationen

Specification
ECMAScript Internationalization API Specification
# sec-Intl.ListFormat.prototype.formatToParts

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch