Intl.ListFormat

Intl.ListFormat オブジェクトは、言語特有のリストを利用可能にするコンストラクターです。

コンストラクター

Intl.ListFormat()
新しい ListFormat オブジェクトを作成します。

静的メソッド

Intl.ListFormat.supportedLocalesOf()
指定したロケールのうち、ランタイムの既定のロケールに代替されることなく対応しているものを含む配列を返します。

インスタンスメソッド

Intl.ListFormat.prototype.format()
言語固有の形式の文字列を返して,列挙要素を表示します。
Intl.ListFormat.prototype.formatToParts()
ロケールを考慮した方法で値のリストを整形するために使用できる、さまざまな部分を表すオブジェクトの配列を返します。

format の使用

次の例では、英語を使用するリストのフォーマッターを生成する方法を示します。

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 の使用

次の例では、整形済みの部分を返すリストフォーマッターを生成する方法を示します。

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

仕様書

仕様書
Intl.ListFormat
ListFormat の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
ListFormat
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 完全対応 78IE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 完全対応 12.0.0
補足
完全対応 12.0.0
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. See the ListFormat() constructor for more details.
ListFormat() constructor
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 完全対応 78IE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 完全対応 13.0.0
完全対応 13.0.0
部分対応 12.0.0
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. When other locales are specified, the ListFormat instance silently falls back to en-US. To make full ICU (locale) data available for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.
format
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 完全対応 78IE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 完全対応 12.0.0
補足
完全対応 12.0.0
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. See the ListFormat() constructor for more details.
formatToParts
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 完全対応 78IE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 完全対応 12.0.0
補足
完全対応 12.0.0
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. See the ListFormat() constructor for more details.
resolvedOptions
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 完全対応 78IE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 完全対応 12.0.0
補足
完全対応 12.0.0
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. See the ListFormat() constructor for more details.
supportedLocalesOf
実験的
Chrome 完全対応 72Edge 未対応 なしFirefox 完全対応 78IE 未対応 なしOpera 完全対応 60Safari 未対応 なしWebView Android 完全対応 72Chrome Android 完全対応 72Firefox Android 未対応 なしOpera Android 完全対応 51Safari iOS 未対応 なしSamsung Internet Android 未対応 なしnodejs 完全対応 13.0.0
完全対応 13.0.0
部分対応 12.0.0
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. To make full ICU (locale) data available for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.

凡例

完全対応  
完全対応
未対応  
未対応
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。

関連情報