From fd47fdad29f03657acc4826e2a909fca497e6adc Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Mon, 26 Apr 2021 01:40:16 +0900
Subject: Intl.ListFormat.formatToParts() を更新 (#491)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

2021/03/29 時点の英語版に同期
---
 .../intl/listformat/formattoparts/index.html       | 92 ++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 files/ja/web/javascript/reference/global_objects/intl/listformat/formattoparts/index.html

(limited to 'files/ja/web/javascript/reference')

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>
-- 
cgit v1.2.3-54-g00ecf