Intl.ListFormat

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

構築子

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.ListFormat proposal Stage 3

ブラウザ互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
ListFormat
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし
ListFormat() constructor
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし
format
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし
formatToParts
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし
resolvedOptions
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし
supportedLocalesOf
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。

関連項目