Intl.ListFormat.prototype.formatToParts()

Метод formatToParts() экземпляров Intl.ListFormat возвращает массив объектов, представляющих каждую часть форматированной строки, которая была бы возвращена format(). Он полезен для построения пользовательских строк из токенов, зависящих от локали.

Попробуйте

const vehicles = ["Motorcycle", "Bus", "Car"];

const formatterEn = new Intl.ListFormat("en", {
  style: "long",
  type: "conjunction",
});

const formatterFr = new Intl.ListFormat("fr", {
  style: "long",
  type: "conjunction",
});

const partValuesEn = formatterEn.formatToParts(vehicles).map((p) => p.value);
const partValuesFr = formatterFr.formatToParts(vehicles).map((p) => p.value);

console.log(partValuesEn);
// Expected output: "["Motorcycle", ", ", "Bus", ", and ", "Car"]"
console.log(partValuesFr);
// Expected output: "["Motorcycle", ", ", "Bus", " et ", "Car"]"

Синтаксис

formatToParts(list)

Параметры

list

Итерируемый объект, например, Array, содержащий строки. Если его опустить, будет выполнено форматирование пустого массива, что может сбить с толку, поэтому рекомендуется всегда явно передавать список.

Возвращаемое значение

Массив Array объектов, содержащих отформатированный список по частям. Каждый объект имеет два свойства, type и value, каждое из которых содержит строку. Конкатенация строк value в заданном порядке даст ту же строку, что и format(). Значение type может быть одним из следующих:

literal

Любая строка, являющаяся частью шаблона форматирования; например ", ", ", and" и т. д.

element

Элемент списка, точно как он был предоставлен.

Примеры

Использование formatToParts()

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" }
// ]

Спецификации

Совместимость с браузерами

Смотрите также

• Intl.ListFormat
• Intl.ListFormat.prototype.format()