Intl.ListFormat
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 表格仅在浏览器中加载