【JavaScript ECMAScript】Intl::Intl.ListFormat.prototype.formatToPartsインスタンスメソッドの使い方

Intl.ListFormat.prototype.formatToParts()メソッドは、指定された文字列のリスト（配列）を、国際的なルールに従って整形し、その結果を構成する個々の「部分（parts）」の配列として返すメソッドです。これは、Intl.ListFormatオブジェクトのインスタンスが提供する機能の一つで、ユーザーのロケール（地域や言語の設定）に応じて、リストの要素を適切に区切ったり、接続詞を追加したりする際に使用されます。

具体的には、「りんご、バナナ、そしてみかん」のように、人間が読みやすい形式に整形された文字列を、さらに「りんご」（要素）、「、」（区切り）、「そして」（接続詞）といった形で、それぞれの役割を持つオブジェクトの配列として出力します。返される各オブジェクトは、その部分が要素（element）なのか、区切り文字や接続詞（literal）なのかを示すtypeプロパティと、実際の文字列を示すvalueプロパティを持ちます。

このメソッドは、単純な整形済み文字列を返すformat()メソッドとは異なり、リストの各部分に個別にアクセスできるため、例えばウェブページで特定のリスト要素だけを強調表示したり、音声読み上げソフトウェアが各部分をより正確に解釈できるようにするなど、より高度で柔軟なユーザーインターフェースやアクセシビリティの実現に役立ちます。国際化されたアプリケーションにおいて、リスト形式の情報を多様な言語や文化圏のユーザーに自然な形で提供するために不可欠な機能と言えます。

Copy
1const listFormatter = new Intl.ListFormat('en');
2const formattedParts = listFormatter.formatToParts(['apple', 'banana', 'orange']);

list

• list: Array: フォーマットされるリストの要素を格納する配列

Array<Object>

Intl.ListFormat.prototype.formatToParts()メソッドは、指定された配列を、ロケールに応じた書式で分割した要素の配列を返します。各要素は、typeとvalueプロパティを持つオブジェクトです。