Intl.ListFormat

Intl.ListFormatオブジェクトは言語毎の列挙形式を有効にするオブジェクト用の構築子です。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構築子

Intl.ListFormat()

新規ListFormatオブジェクトを作成。

属性

Intl.ListFormat.prototype

全オブジェクトに属性を追加するのを許可する。

メソッド

Intl.ListFormat.supportedLocalesOf()

配列を返します。配列の要素は提供済み地域特性での相当する値であり，実行時の既定地域特性への代替を用意する必要なく対応しています。

Intl.ListFormat実体

 全Intl.ListFormat実体はIntl.Listformat.prototypeより継承しています。

属性

Intl.ListFormat.prototype.constructor

オブジェクトの祖型を作成する函数を指定します。

メソッド

Intl.ListFormat.prototype.format()

言語固有の形式の文字列を返して，列挙要素を表示します。

Intl.ListFormat.prototype.formatToParts()

配列を返し，言語に対応した方法で列挙を整形するのに用いる様々な構成子オブジェクトを表示します。

事例

formatを使う

次の例では日本語用の列挙整形器を作成する方法を示します。

const list = ['二輪車', '乗合', '乗用車'];

 console.log(new Intl.ListFormat('ja', { style: 'long', type: 'conjunction' }).format(list));
// > 二輪車、乗合、乗用車

 console.log(new Intl.ListFormat('ja', { style: 'short', type: 'disjunction' }).format(list));
// > 二輪車、乗合、または乗用車

 console.log(new Intl.ListFormat('ja', { style: 'narrow', type: 'unit' }).format(list));
// > 二輪車乗合乗用車

formatToPartsを使う

次の例では整形済み断片を返す列挙整形器を作成する方法を示します。

const list = ['二輪車', '乗合', '乗用車'];
console.log(new Intl.ListFormat('ja', { style: 'long', type: 'conjunction' }).formatToParts(list));
 
// [ { "type": "element", "value": "二輪車" }, 
//   { "type": "literal", "value": "、" }, 
//   { "type": "element", "value": "乗合" },
//   { "type": "literal", "value": "、" },
//   { "type": "element", "value": "乗用車" } ];

仕様

ブラウザ互換性

関連項目

• Intl