JavaScript | Intl.ListFormat.prototype.formatToParts() 方法

JavaScript | Intl.ListFormat.prototype.formatToParts()方法是ECMAScript国际化API的一部分。它是一个Intl.ListFormat对象的实例方法，用于将数组转换为适合语言环境的人类可读的列表字符串，其中列表的各个部分（如分隔符等）以可重用的格式返回。

语法

Intl.ListFormat.prototype.formatToParts(list)

参数:

• list: 一个数组，其中包含要格式化为字符串的项。

返回值: 返回一个数组，其中包含分隔符等可重用格式的对象。

用法

const list = [
  "apple",
  "banana",
  "cherry"
];

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

const parts = formatter.formatToParts(list);

console.log(parts); // [object Object],[object Object],[object Object],[object Object]

上面的代码中，我们首先定义了一个包含三个水果的数组。接下来，我们创建了一个Intl.ListFormat的实例，specifying 'en'作为语言和'{long, conjunction}'作为列表风格和类型。我们然后使用formatter对象的formatToParts()方法将数组转换为适合语言环境的格式化字符串。

最后，我们打印出parts数组，该数组包含四个对象，而不是一个字符串。这是因为formatToParts()方法返回一个数组，其中包含分隔符、标记和其他元素的对象，以便将其各自应用于数组的每个项目。

分試器属性

formatToParts() 方法返回的数组对象包含以下四个属性：

• type: 该对象表示的元素的类型，可能的值是： "literal"、 "element"、 "separator" 和 "unknown"。
• value: 该对象表示的元素的字符串值（如果它是一个不需要填充或替换的文本或分隔符，那么它将是一个字符串；如果它是一个元素，则它将为undefined）。
• source: 该对象表示的元素的在格式化函数文本中的起始索引位置。
• target: 该对象表示的元素的在格式化后字符串中的起始索引位置。

下面是一个简单的例子：

const list = ["apple", "banana", "cherry"];

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

const parts = formatter.formatToParts(list);

for (let part of parts) {
  console.log(part.type + ": " + part.value);
}
// output:
// element: apple
// literal: ', '
// element: banana
// literal: ', and '
// element: cherry

该代码将打印出以下内容：

element: apple
literal: ', '
element: banana
literal: ', and '
element: cherry

结论

JavaScript | Intl.ListFormat.prototype.formatToParts()方法是ECMAScript国际化API的一部分，它可以将数组转换为语言环境适用的人类可读列表字符串，并返回可重用格式的分隔符等对象数组。通过使用这个方法，我们可以将这些对象用于自定义格式化工具或上下文有关的操作中。