Intl.ListFormat.prototype.formatToParts()

基线 广泛可用

此功能已得到良好建立，并且可以在许多设备和浏览器版本中使用。它自 2021 年 4 月.

报告反馈

试试看

语法

The formatToParts() method of Intl.ListFormat instances returns an Array of objects representing the different components that can be used to format a list of values in a locale-aware fashion.
formatToParts(list)

js

参数

list

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

返回值

描述

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

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

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

示例

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

The formatToParts() method of Intl.ListFormat instances returns an Array of objects representing the different components that can be used to format a list of values in a locale-aware fashion.
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" }
// ]

规范

使用 formatToParts
规范
# ECMAScript 国际化 API 规范

浏览器兼容性

sec-Intl.ListFormat.prototype.formatToParts

另请参阅