Intl.ListFormat.formatToParts() を更新 (#491)

2021/03/29 時点の英語版に同期

1 files changed, 92 insertions, 0 deletions

diff --git a/files/ja/web/javascript/reference/global_objects/intl/listformat/formattoparts/index.html b/files/ja/web/javascript/reference/global_objects/intl/listformat/formattoparts/index.html
new file mode 100644
index 0000000000..af8fce9eab
--- /dev/null
+++ b/files/ja/web/javascript/reference/global_objects/intl/listformat/formattoparts/index.html
@@ -0,0 +1,92 @@
+---
+title: Intl.ListFormat.prototype.formatToParts()
+slug: Web/JavaScript/Reference/Global_Objects/Intl/ListFormat/formatToParts
+tags:
+  - Internationalization
+  - Intl
+  - JavaScript
+  - ListFormat
+  - Localization
+  - Method
+  - Prototype
+  - Reference
+translation_of: Web/JavaScript/Reference/Global_Objects/Intl/ListFormat/formatToParts
+---
+<div>{{JSRef}}</div>
+
+<p><strong><code>Intl.ListFormat.prototype.formatToParts()</code></strong> メソッドは、ロケールを意識した値のリストの書式化で使用できる様々な部分を表すオブジェクトの配列を返します。</p>
+
+<h2 id="Syntax">構文</h2>
+
+<pre class="brush: js">Intl.ListFormat.prototype.formatToParts(<var>list</var>)
+</pre>
+
+<h3 id="Parameters">引数</h3>
+
+<dl>
+	<dt><code><var>list</var></code></dt>
+	<dd>ロケールに従って書式化するための値の {{jsxref("Array")}} です。</dd>
+</dl>
+
+<h3 id="Return_value">返値</h3>
+
+<p>リストから書式された部品を含むコンポーネントの {{jsxref("Array")}} です。</p>
+
+<h2 id="Description">解説</h2>
+
+<p>{{jsxref("Intl/ListFormat/format", "Intl.ListFormat.prototype.format()")}} は、 (渡されたロケールとスタイルのオプションに応じて) リストの書式化された文字列を返すのに対し、 <code>formatToParts()</code> は、書式化されたされた文字列のさまざまなコンポーネントの配列を返します。</p>
+
+<p>フォーマットに使用されるロケールとスタイルのオプションは、Intl.ListFormatインスタンスを構築する際に与えられます。結果として得られる配列の各要素には、 <code>type</code> と <code>value</code> という 2 つのプロパティがあります。 <code>type</code> プロパティには、リストの値を表す "<code>element</code>" か、言語構造を表す "<code>literal</code>" のいずれかを指定します。 <code>value</code> プロパティは、トークンの内容を文字列で表したものです。</p>
+
+<p>フォーマットに使用されるロケールとスタイルのオプションは、 {{jsxref("Intl.ListFormat")}} インスタンスを構築する際に与えられます。</p>
+
+<h2 id="Examples">例</h2>
+
+<h3 id="Using_formatToParts">formatToParts の使用</h3>
+
+<pre class="brush: js">const fruits = ['Apple', 'Orange', 'Pineapple'];
+const myListFormat = new Intl.ListFormat('en-GB', { style: 'long', type: 'conjunction' });
+
+console.table(myListFormat.formatToParts(fruits));
+// [
+//  { "type": "element", "value": "Apple" },
+//  { "type": "literal", "value": ", " },
+//  { "type": "element", "value": "Orange" },
+//  { "type": "literal", "value": ", and " },
+//  { "type": "element", "value": "Pineapple" }
+// ]
+</pre>
+
+<h2 id="Specifications">仕様書</h2>
+
+<table class="standard-table">
+	<thead>
+		<tr>
+			<th scope="col">仕様書</th>
+		</tr>
+	</thead>
+	<tbody>
+		<tr>
+			<td>{{SpecName('Intl.ListFormat',
+				'#sec-Intl.ListFormat.prototype.formatToParts', 'formatToParts()')}}</td>
+		</tr>
+	</tbody>
+</table>
+
+<h2 id="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>{{Compat("javascript.builtins.Intl.ListFormat.formatToParts")}}</div>
+
+<h2 id="See_also">関連情報</h2>
+
+<ul>
+	<li>{{jsxref("Intl.ListFormat")}}</li>
+	<li>{{jsxref("Intl/ListFormat/format", "Intl.ListFormat.prototype.format()")}}
+	</li>
+	<li>{{jsxref("Intl/RelativeTimeFormat/formatToParts",
+		"Intl.RelativeTimeFormat.prototype.formatToParts()")}}</li>
+	<li>{{jsxref("Intl/NumberFormat/formatToParts",
+		"Intl.NumberFormat.prototype.formatToParts()")}}</li>
+	<li>{{jsxref("Intl/DateTimeFormat/formatToParts",
+		"Intl.DateTimeFormat.prototype.formatToParts()")}}</li>
+</ul>