Intl.ListFormat
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Intl.ListFormat
オブジェクトは、言語を考慮したリストの整形ができるようにします。
試してみましょう
コンストラクター
Intl.ListFormat()
-
新しい
Intl.ListFormat
オブジェクトを作成します。
静的メソッド
Intl.ListFormat.supportedLocalesOf()
-
指定したロケールのうち、ランタイムの既定のロケールに代替されることなく対応しているものを含む配列を返します。
インスタンスメソッド
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" } ];
仕様書
Specification |
---|
ECMAScript Internationalization API Specification # listformat-objects |
ブラウザーの互換性
BCD tables only load in the browser