Intl.ListFormat.prototype.formatToParts()

¥Syntax

formatToParts(list)

¥Parameters

list

可迭代对象，例如 Array，根据区域设置进行格式化。

¥Return value

Array 个组件，其中包含列表中的格式化部分。

¥An Array of components which contains the formatted parts from the list.

¥Description

Intl.ListFormat.prototype.format() 返回列表的格式化版本的字符串（根据给定的区域设置和样式选项），而 formatToParts() 返回格式化字符串的不同组件的数组。

¥Whereas Intl.ListFormat.prototype.format() returns a string being the formatted version of the list (according to the given locale and style options), formatToParts() returns an array of the different components of the formatted string.

结果数组的每个元素都有两个属性：type 和 value。type 属性可以是 "element"（指列表中的值）或 "literal"（指语言构造）。value 属性以字符串形式给出令牌的内容。

¥Each element of the resulting array has two properties: type and value. The type property may be either "element", which refers to a value from the list, or "literal" which refers to a linguistic construct. The value property gives the content, as a string, of the token.

用于格式化的区域设置和样式选项在构造 Intl.ListFormat 实例时给出。

¥The locale and style options used for formatting are given when constructing the Intl.ListFormat instance.

¥Examples

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

¥See also

• Intl.ListFormat
• Intl.ListFormat.prototype.format()
• Intl.RelativeTimeFormat.prototype.formatToParts()
• Intl.NumberFormat.prototype.formatToParts()
• Intl.DateTimeFormat.prototype.formatToParts()