Intl.ListFormat

¥Constructor

Intl.ListFormat()

创建一个新的 Intl.ListFormat 对象。

¥Static methods

Intl.ListFormat.supportedLocalesOf()

返回一个数组，其中包含所提供的受支持的语言环境，而无需回退到运行时的默认语言环境。

¥Instance properties

这些属性在 Intl.ListFormat.prototype 上定义并由所有 Intl.ListFormat 实例共享。

¥These properties are defined on Intl.ListFormat.prototype and shared by all Intl.ListFormat instances.

Intl.ListFormat.prototype.constructor

创建实例对象的构造函数。对于 Intl.ListFormat 实例，初始值为 Intl.ListFormat 构造函数。

Intl.ListFormat.prototype[Symbol.toStringTag]

[Symbol.toStringTag] 属性的初始值为字符串 "Intl.ListFormat"。该属性在 Object.prototype.toString() 中使用。

¥Instance methods

Intl.ListFormat.prototype.format()

返回表示列表元素的特定于语言的格式化字符串。

Intl.ListFormat.prototype.formatToParts()

返回表示不同组件的对象数组，这些组件可用于以区域设置感知的方式格式化值列表。

Intl.ListFormat.prototype.resolvedOptions()

返回一个新对象，其属性反映了在构建当前 Intl.ListFormat 对象期间计算的区域设置和样式格式选项。

¥Examples

¥Using format

以下示例演示如何使用英语创建列表格式化程序。

¥The following example shows how to create a List formatter using the English language.

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

console.log(
  new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus and Car

console.log(
  new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus or Car

console.log(
  new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),
);
// Motorcycle Bus Car

¥Using formatToParts

以下示例演示如何创建返回格式化部分的列表格式化程序

¥The following example shows how to create a List formatter returning formatted parts

const list = ["Motorcycle", "Bus", "Car"];
console.log(
  new Intl.ListFormat("en-GB", {
    style: "long",
    type: "conjunction",
  }).formatToParts(list),
);

// [ { "type": "element", "value": "Motorcycle" },
//   { "type": "literal", "value": ", " },
//   { "type": "element", "value": "Bus" },
//   { "type": "literal", "value": ", and " },
//   { "type": "element", "value": "Car" } ];

¥See also

• FormatJS 中 Intl.ListFormat 的 Polyfill
• Intl