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 formatToParts() Methode von Intl.ListFormat Instanzen gibt ein Array von Objekten zurück, das jeweils einen Teil des formatierten Strings repräsentiert, den format() zurückgeben würde. Dies ist nützlich zum Erstellen von benutzerdefinierten Strings aus lokalisierungsspezifischen Token.

Probieren Sie es aus

Syntax

js
formatToParts(list)

Parameter

list

Ein iterierbares Objekt, wie ein Array, das Zeichenketten enthält. Wenn es weggelassen wird, führt dies zur Formatierung des leeren Arrays, was etwas verwirrend sein könnte. Es ist daher ratsam, immer explizit eine Liste zu übergeben.

Rückgabewert

Ein Array von Objekten, das die formatierte Liste in Teilen enthält. Jedes Objekt hat zwei Eigenschaften, type und value, die jeweils eine Zeichenkette enthalten. Die Verkettung der value-Zeichenfolgen in der bereitgestellten Reihenfolge ergibt den gleichen String wie format(). Der type kann einer der folgenden sein:

literal

Jede Zeichenkette, die Teil des Formatmusters ist; zum Beispiel ", ", ", and" usw.

element

Ein Element der Liste, genau wie 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® 2025 Internationalization API Specification
# sec-Intl.ListFormat.prototype.formatToParts

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch