Intl.ListFormat

基线 广泛可用

此功能已得到很好的建立,并在许多设备和浏览器版本上都能正常工作。 它自以下时间起在各个浏览器中可用: 2021 年 4 月.

Intl.ListFormat 对象支持语言敏感的列表格式化。

试一试

构造函数

Intl.ListFormat()

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

静态方法

Intl.ListFormat.supportedLocalesOf()

返回一个数组,其中包含在没有回退到运行时默认区域设置的情况下支持的提供的区域设置。

实例属性

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

Intl.ListFormat.prototype.constructor

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

Intl.ListFormat.prototype[Symbol.toStringTag]

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

实例方法

Intl.ListFormat.prototype.format()

返回一个语言特定的格式化字符串,表示列表中的元素。

Intl.ListFormat.prototype.formatToParts()

返回一个对象数组,表示可以使用这些对象以区域设置感知的方式格式化列表值的各个组件。

Intl.ListFormat.prototype.resolvedOptions()

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

示例

使用 format

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

js
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

使用 formatToParts

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

js
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" } ];

规范

规范
ECMAScript 国际化 API 规范
# listformat-objects

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅