diff options
Diffstat (limited to 'files/ja/web')
11 files changed, 129 insertions, 326 deletions
diff --git a/files/ja/web/api/document/body/index.html b/files/ja/web/api/document/body/index.html index 055e65e7a1..cf20308c6b 100644 --- a/files/ja/web/api/document/body/index.html +++ b/files/ja/web/api/document/body/index.html @@ -3,7 +3,6 @@ title: Document.body slug: Web/API/Document/body tags: - API - - BODY - Document - HTML DOM - Property @@ -17,26 +16,26 @@ translation_of: Web/API/Document/body <h2 id="Syntax" name="Syntax">構文</h2> -<pre class="syntaxbox">var <var>objRef</var> = document.body; -document.body = <var>objRef</var>;</pre> +<pre class="syntaxbox notranslate">const <var>objRef</var> = document.body +document.body = <var>objRef</var></pre> <h2 id="Example" name="Example">例</h2> -<pre class="brush:js">// Given this HTML: <body id="oldBodyElement"></body> +<pre class="brush:js notranslate">// Given this HTML: <body id="oldBodyElement"></body> alert(document.body.id); // "oldBodyElement" -var aNewBodyElement = document.createElement("body"); +const aNewBodyElement = document.createElement("body"); aNewBodyElement.id = "newBodyElement"; document.body = aNewBodyElement; alert(document.body.id); // "newBodyElement" </pre> -<h2 id="Notes" name="Notes">メモ</h2> +<h2 id="Notes" name="Notes">注</h2> <p><code>document.body</code> は文書の内容を持つ要素です。 <code><body></code> の内容を持つ文書では <code><body></code> 要素を返し、フレームセット文書では、これは最も外側の <code><frameset></code> 要素を返します。</p> -<p><code>body</code> は設定が可能ですが、文書に新しい <code>body</code> を設定すると、既存の <code><body></code> 要素の子ノードは全て削除されます。</p> +<p><code>body</code> プロパティは設定が可能ですが、文書に新しい <code>body</code> を設定すると、既存の <code><body></code> 要素の子ノードは全て削除されます。</p> <h2 id="Specification" name="Specification">仕様書</h2> @@ -52,32 +51,22 @@ alert(document.body.id); // "newBodyElement" <tr> <td>{{SpecName('HTML WHATWG','dom.html#dom-document-body','Document.body')}}</td> <td>{{Spec2('HTML WHATWG')}}</td> - <td> </td> + <td></td> </tr> <tr> <td>{{SpecName('HTML5.1','dom.html#dom-document-body','Document.body')}}</td> <td>{{Spec2('HTML5.1')}}</td> - <td> </td> + <td></td> </tr> <tr> <td>{{SpecName('HTML5 W3C','dom.html#dom-document-body','Document.body')}}</td> <td>{{Spec2('HTML5 W3C')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM2 HTML','html.html#ID-56360201','Document.body')}}</td> - <td>{{Spec2('DOM2 HTML')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM1','level-one-html.html#attribute-body','Document.body')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>初回定義</td> + <td></td> </tr> </tbody> </table> -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> <div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> diff --git a/files/ja/web/css/url/index.html b/files/ja/web/css/url/index.html index 95d1814a2e..2ca334be5a 100644 --- a/files/ja/web/css/url/index.html +++ b/files/ja/web/css/url/index.html @@ -9,7 +9,8 @@ tags: - URL - urn - レイアウト -translation_of: Web/CSS/url +translation_of: Web/CSS/url() +translation_of_original: Web/CSS/url --- <div>{{CssRef}}</div> diff --git a/files/ja/web/javascript/guide/exception_handling_statements/index.html b/files/ja/web/javascript/guide/exception_handling_statements/index.html deleted file mode 100644 index fddf6c4181..0000000000 --- a/files/ja/web/javascript/guide/exception_handling_statements/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 例外処理文 -slug: Web/JavaScript/Guide/Exception_Handling_Statements ---- -<h3 id=".E4.BE.8B.E5.A4.96.E5.87.A6.E7.90.86.E6.96.87" name=".E4.BE.8B.E5.A4.96.E5.87.A6.E7.90.86.E6.96.87">例外処理文</h3> -<p><code>throw</code> 文を使用すると例外を投げることができます。また、<code>try...catch</code> 文を使用すると例外を処理することができます。</p> -<p><code>try...catch</code> 文を使用して Java の例外を処理することもできます。この情報については <a href="/ja/Core_JavaScript_1.5_Guide/LiveConnect_Overview/JavaScript_to_Java_Communication#JavaScript_.E3.81.A7.E3.81.AE_Java_.E3.81.AE.E4.BE.8B.E5.A4.96.E3.81.AE.E5.87.A6.E7.90.86" title="ja/Core_JavaScript_1.5_Guide/LiveConnect_Overview/JavaScript_to_Java_Communication#JavaScript_.E3.81.A7.E3.81.AE_Java_.E3.81.AE.E4.BE.8B.E5.A4.96.E3.81.AE.E5.87.A6.E7.90.86">JavaScript での Java の例外の処理</a> および <a href="/ja/Core_JavaScript_1.5_Guide/LiveConnect_Overview/JavaScript_to_Java_Communication" title="ja/Core_JavaScript_1.5_Guide/LiveConnect_Overview/JavaScript_to_Java_Communication">Java と JavaScript との通信</a> をご覧ください。</p> -<ul> - <li><a href="/ja/Core_JavaScript_1.5_Guide/Exception_Handling_Statements/throw_Statement" title="ja/Core_JavaScript_1.5_Guide/Exception_Handling_Statements/throw_Statement">throw 文</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/Exception_Handling_Statements/try...catch_Statement" title="ja/Core_JavaScript_1.5_Guide/Exception_Handling_Statements/try...catch_Statement">try...catch 文</a></li> -</ul> -<h3 id=".E4.BE.8B.E5.A4.96.E3.81.AE.E7.A8.AE.E9.A1.9E" name=".E4.BE.8B.E5.A4.96.E3.81.AE.E7.A8.AE.E9.A1.9E">例外の種類</h3> -<p>JavaScript ではほとんどどんなオブジェクトでも投げることができます。とは言っても、必ずしもすべての投げられたオブジェクトが同等に作られているわけではありません。数値や文字列をエラーとして投げる方法はよく用いられますが、特にこの用途のために作られている例外の種類のうちのどれかを使用したほうがより効率的であることがよくあります。</p> -<ul> - <li>ECMAScript の例外 - <ul> - <li><a href="/ja/Core_JavaScript_1.5_Guide/Error" title="ja/Core_JavaScript_1.5_Guide/Error">Error</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/EvalError" title="ja/Core_JavaScript_1.5_Guide/EvalError">EvalError</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/RangeError" title="ja/Core_JavaScript_1.5_Guide/RangeError">RangeError</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/ReferenceError" title="ja/Core_JavaScript_1.5_Guide/ReferenceError">ReferenceError</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/SyntaxError" title="ja/Core_JavaScript_1.5_Guide/SyntaxError">SyntaxError</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/TypeError" title="ja/Core_JavaScript_1.5_Guide/TypeError">TypeError</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/URIError" title="ja/Core_JavaScript_1.5_Guide/URIError">URIError</a></li> - </ul> - </li> - <li>DOM の例外 - <ul> - <li><a href="/ja/Core_JavaScript_1.5_Guide/DOMException" title="ja/Core_JavaScript_1.5_Guide/DOMException">DOMException</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/EventException" title="ja/Core_JavaScript_1.5_Guide/EventException">EventException</a></li> - <li><a href="/ja/Core_JavaScript_1.5_Guide/RangeException" title="ja/Core_JavaScript_1.5_Guide/RangeException">RangeException</a></li> - <li>... (?)</li> - </ul> - </li> - <li><a href="/ja/NsIXPCException" title="ja/NsIXPCException">nsIXPCException</a> (<a href="/ja/XPConnect" title="ja/XPConnect">XPConnect</a>)</li> -</ul> -<p>{{ PreviousNext("JavaScript/Guide/Comments", "JavaScript/Guide/Exception_Handling_Statements/throw_Statement") }}</p> diff --git a/files/ja/web/javascript/guide/exception_handling_statements/throw_statement/index.html b/files/ja/web/javascript/guide/exception_handling_statements/throw_statement/index.html deleted file mode 100644 index 9d98321883..0000000000 --- a/files/ja/web/javascript/guide/exception_handling_statements/throw_statement/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: throw 文 -slug: Web/JavaScript/Guide/Exception_Handling_Statements/throw_Statement ---- -<h3 id="throw_.E6.96.87" name="throw_.E6.96.87">throw 文</h3> -<p><code>throw</code> 文は例外を投げるために使用します。例外を投げるときは、投げたい値からなる式を指定してください。</p> -<pre class="eval">throw expression; -</pre> -<p>特定の型の式だけではなく、あらゆる式を投げることができます。下記のコードは様々な型の例外を投げています。</p> -<pre class="eval">throw "Error2"; -throw 42; -throw true; -throw {toString: function() { return "I'm an object!"; } }; -</pre> -<div class="note"> - <strong>注意：</strong>例外を投げる際にオブジェクトを指定することができます。すると、<code>catch</code> ブロックでそのオブジェクトのプロパティを参照できるようになります。次の例では <code>UserException</code> という種類の <code>myUserException</code> というオブジェクトを作ります。また、このオブジェクトを throw 文で使用します。</div> -<pre class="eval">// UserException という種類のオブジェクトを作成 -function UserException (message) -{ - this.message=message; - this.name="UserException"; -} - -// 文字列として使用されるとき（例：エラーコンソール上）に -// 例外を整形する -UserException.prototype.toString = function () -{ - return this.name + ': "' + this.message + '"'; -} - -// そのオブジェクトの種類のインスタンスを作成し、それを投げる -throw new UserException("Value too high"); -</pre> -<p>{{ PreviousNext("JavaScript/Guide/Exception_Handling_Statements", "JavaScript/Guide/Exception_Handling_Statements/try...catch_Statement") }}</p> diff --git a/files/ja/web/javascript/guide/exception_handling_statements/try...catch_statement/index.html b/files/ja/web/javascript/guide/exception_handling_statements/try...catch_statement/index.html deleted file mode 100644 index 678cd3f38e..0000000000 --- a/files/ja/web/javascript/guide/exception_handling_statements/try...catch_statement/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: try...catch 文 -slug: Web/JavaScript/Guide/Exception_Handling_Statements/try...catch_Statement ---- -<h3 id="try...catch_.E6.96.87" name="try...catch_.E6.96.87">try...catch 文</h3> - -<p><code>try...catch</code> 文はテストしたい文のブロックを指定し、さらに投げられるであろう例外に対する 1 つ以上の対処方法を指定します。例外が投げられると <code>try...catch</code> 文がそれを受け取ります。</p> - -<p><code>try...catch</code> 文は 1 つの <code>try</code> ブロックと 0 個以上の <code>catch</code> ブロックからなります。前者は 1 つ以上の文からなります。後者は try ブロックで例外が投げられた場合にどうするかを指定する文からなります。すなわち、成功させたい <code>try</code> ブロックと、失敗した場合にコントロールを渡す <code>catch</code> ブロックからなります。<code>try</code> ブロック内（もしくは <code>try</code> ブロック内から呼び出された関数内）のいずれかの文が例外を投げた場合、コントロールはすぐに <code>catch</code> ブロックに移ります。<code>try</code> ブロックで例外が投げられなかった場合は <code>catch</code> ブロックは飛ばされます。<code>finally</code> ブロックは <code>try</code> および <code>catch</code> ブロックが実行された後に実行されます。ただし <code>try...catch</code> 文の後に続く文より先に実行されます。</p> - -<p>次の例では <code>try...catch</code> 文を使用しています。この例では渡された値に基づいて配列から月の名前を取り出す関数を呼び出します。値に対応する月の数字 (1-12) がなかったら、<code>InvalidMonthNo</code> という値を持つ例外が投げられ、<code>catch</code> ブロックの中の文は <code>monthName</code> という変数に <code>unknown</code> という値をセットします。</p> - -<pre>function getMonthName (mo) { - mo=mo-1; // 月の数字を配列のインデックスに合わせる (1=Jan, 12=Dec) - var months=new Array("Jan","Feb","Mar","Apr","May","Jun","Jul", - "Aug","Sep","Oct","Nov","Dec"); - if (months[mo] != null) { - return months[mo] - } else { - throw "InvalidMonthNo" - } -} - -try { -// テストする文 - monthName=getMonthName(myMonth) // 関数は例外を投げることがある -} -catch (e) { - monthName="unknown" - logMyErrors(e) // 例外オブジェクトをエラー処理部分に渡す -} -</pre> - -<h4 id="catch_.E3.83.96.E3.83.AD.E3.83.83.E3.82.AF" name="catch_.E3.83.96.E3.83.AD.E3.83.83.E3.82.AF">catch ブロック</h4> - -<p>単一の <code>catch</code> ブロックを使用すると、<code>try</code> ブロックで生じうるすべての例外を扱うことができます。また、扱う例外の種類によって <code>catch</code> ブロックをそれぞれに分けることもできます。</p> - -<p><strong>単一の catch ブロック</strong><br> - <code>try</code> ブロックで投げられるいかなる例外にも対応したエラー処理コードを実行するには、<code>try...catch</code> 文で <code>catch</code> を 1 つ使用してください。</p> - -<p>単一の <code>catch</code> ブロックは次のように使用します。</p> - -<pre>catch (catchID) { - statements -} -</pre> - -<p><code>catch</code> ブロックは、<code>throw</code> 文で指定された値を持つ識別子（上記の構文における <code>catchID</code>）を指定します。この識別子を使用することで投げられた例外についての情報を得ることができます。JavaScript は <code>catch</code> ブロックに入るときにこの識別子を作成します。識別子は <code>catch</code> ブロックにいる間だけ持続します。つまり、<code>catch</code> ブロックの実行が終了するとその識別子はもう使えなくなります。</p> - -<p>例えば、次のコードは例外を投げます。例外が生じるとコントロールが <code>catch</code> ブロックに移ります。</p> - -<pre>try { - throw "myException" // 例外を生成 -} -catch (e) { -// どんな例外も扱う文 - logMyErrors(e) // 例外オブジェクトをエラー処理部分に渡す -} -</pre> - -<p><strong>複数の catch ブロック</strong><br> - 1 つの <code>try</code> 文に対して、複数の条件についての <code>catch</code> ブロックを使うことができます。そして、そのそれぞれがそれぞれの種類の例外を担当します。この場合、そのブロックで指定されている例外が投げられたときだけ、適切な条件の <code>catch</code> ブロックに入ることになります。すべての未指定の例外のために、すべての例外に対応した <code>catch</code> ブロックをその文の最後の catch ブロックとしてオプション的に設けることもできます。</p> - -<p>例えば、次の関数は 3 つの別の関数（どこかで定義済み）を呼び出します。この関数はその引数が妥当であるかを確かめます。妥当性確認関数が確認対象の構成要素が妥当でないと決定した場合、その関数は 0 を返し、該当する例外を呼び出し元に投げさせます。</p> - -<pre>function getCustInfo(name, id, email) -{ - var n, i, e; - - if (!validate_name(name)) - throw "InvalidNameException" - else - n = name; - if (!validate_id(id)) - throw "InvalidIdException" - else - i = id; - if (!validate_email(email)) - throw "InvalidEmailException" - else - e = email; - cust = (n + " " + i + " " + e); - return (cust); -} -</pre> - -<p>おのおのの条件の <code>catch</code> ブロックは適当な例外処理部分にコントロールを渡します。</p> - -<pre>try { -// 関数は 3 つの例外を投げうる - getCustInfo("Lee", 1234, "lee@netscape.com") -} - -catch (e if e == "InvalidNameException") { -// 不正な名前に対しての処理部分を呼び出す - bad_name_handler(e) -} - -catch (e if e == "InvalidIdException") { -// 不正な ID に対しての処理部分を呼び出す - bad_id_handler(e) -} - -catch (e if e == "InvalidEmailException") { -// 不正なメールアドレスに対しての処理部分を呼び出す - bad_email_handler(e) -} - -catch (e){ -// 何が起きるかはわからないが、そのログをとる - logError(e) -} -</pre> - -<h4 id="finally_.E3.83.96.E3.83.AD.E3.83.83.E3.82.AF" name="finally_.E3.83.96.E3.83.AD.E3.83.83.E3.82.AF">finally ブロック</h4> - -<p><code>finally</code> ブロックは、try および catch ブロックの実行が終わった後に実行される文からなります。ただし <code>try...catch</code> 文の後に続く文より前に実行されます。<code>finally</code> ブロックは例外が投げられても投げられなくても実行されます。例外が投げられた場合、<code>finally</code> ブロック内の文はたとえ例外処理をする catch ブロックがなくても実行されます。</p> - -<p><code>finally</code> ブロックを使用することで、例外発生時に適切にスクリプトを停止させることができます。例えば、スクリプトで使用していたリソースを解放する必要があるかもしれません。次の例ではファイルを開き、そのファイルを使用する文を実行します（サーバサイド JavaScript ではファイルにアクセスできます）。ファイルを開いている間に例外が投げられると、スクリプトが停止する前に <code>finally</code> ブロックがそのファイルを閉じます。</p> - -<pre>openMyFile(); -try { - writeMyFile(theData); // エラーを投げる可能性がある -} catch(e) { - handleError(e); // エラーを受け取り、それを処理する -} finally { - closeMyFile(); // 常にリソースを閉じる -} -</pre> - -<h4 id="try...catch_.E6.96.87.E3.81.AE.E3.83.8D.E3.82.B9.E3.83.88" name="try...catch_.E6.96.87.E3.81.AE.E3.83.8D.E3.82.B9.E3.83.88">try...catch 文のネスト</h4> - -<p>1 つ以上の <code>try...catch</code> 文を入れ子にすることができます。内側の <code>try...catch</code> 文に catch ブロックがない場合、囲んでいる <code>try...catch</code> 文の catch ブロックがマッチしているか確認されます。</p> - -<p>{{ PreviousNext("JavaScript/Guide/Exception_Handling_Statements/throw_Statement", "JavaScript/Guide/Defining_Functions") }}</p> diff --git a/files/ja/web/javascript/reference/global_objects/array/sort/index.html b/files/ja/web/javascript/reference/global_objects/array/sort/index.html index 6719c55cd4..77437acb42 100644 --- a/files/ja/web/javascript/reference/global_objects/array/sort/index.html +++ b/files/ja/web/javascript/reference/global_objects/array/sort/index.html @@ -12,7 +12,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/sort --- <div>{{JSRef}}</div> -<p><code><strong>sort()</strong></code> メソッドは、配列の要素を <em><a href="https://ja.wikipedia.org/wiki/In-place アルゴリズム">in place</a></em> でソートします。既定のソート順は昇順で、要素を文字列に変換してから、UTF-16 コード単位の値の並びとして比較します。</p> +<p><code><strong>sort()</strong></code> メソッドは、配列の要素を <em><a href="https://ja.wikipedia.org/wiki/In-place%E3%82%A2%E3%83%AB%E3%82%B4%E3%83%AA%E3%82%BA%E3%83%A0">in place</a></em> でソートします。既定のソート順は昇順で、要素を文字列に変換してから、UTF-16 コード単位の値の並びとして比較します。</p> <p>このソートで消費される CPU時間やメモリースペースは実装に依存するので、ここで言及することは出来ません。</p> @@ -28,21 +28,20 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/sort <h3 id="Parameters" name="Parameters">引数</h3> <dl> + <dt><code>firstEl</code></dt> + <dd>比較対象の一つ目の要素を指定します。</dd> + <dt><code>secondEl</code></dt> + <dd>比較対象の二つ目の要素を指定します。</dd> +</dl> + +<dl> <dt><code>compareFunction</code> {{optional_inline}}</dt> <dd>ソート順を定義する関数を指定します。省略された場合、配列の各要素は文字列に変換され、各文字の <a href="/ja/docs/Web/JavaScript/Guide/Values,_variables,_and_literals#Unicode">Unicode</a> のコードポイント順に従ってソートされます。</dd> - <dl> - <dt><code>firstEl</code></dt> - <dd>比較対象の一つ目の要素を指定します。</dd> - <dt><code>secondEl</code></dt> - <dd>比較対象の二つ目の要素を指定します。</dd> - </dl> - </dl> - <h3 id="Return_value" name="Return_value">返値</h3> -<p>ソートされた結果の配列。ソートは対象配列上で <em><a href="https://en.wikipedia.org/wiki/In-place_algorithm">in place</a></em> に行われることに注意して下さい。コピーされた別の配列が準備されることはありません。</p> +<p>ソートされた結果の配列。ソートは対象配列上で <em><a href="https://ja.wikipedia.org/wiki/In-place%E3%82%A2%E3%83%AB%E3%82%B4%E3%83%AA%E3%82%BA%E3%83%A0">in place</a></em> に行われることに注意して下さい。コピーされた別の配列が準備されることはありません。</p> <h2 id="Description" name="Description">解説</h2> diff --git a/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.html b/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.html index 049e69396d..76ae82a7c6 100644 --- a/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.html +++ b/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/datetimeformat/index.html @@ -20,14 +20,14 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/Date <h2 id="Syntax" name="Syntax">構文</h2> -<pre class="syntaxbox">new Intl.DateTimeFormat([<var>locales</var>[, <var>options</var>]])</pre> +<pre class="syntaxbox notranslate">new Intl.DateTimeFormat([<var>locales</var>[, <var>options</var>]])</pre> <h3 id="Parameters" name="Parameters">引数</h3> <dl> <dt><code><var>locales</var></code> {{optional_inline}}</dt> <dd> - <p>BCP47 言語タグの文字列、または、そのような文字列の配列です。ブラウザーの既定のロケールを使用するには、この引数を省略するか、 <code>undefined</code> を渡すかしてください。 Unicode 拡張に対応しています (例えば "<code>en-US-u-ca-buddhist</code>" など)。 <code>locales</code> 引数の一般的な形式と解釈は、 {{jsxref("Global_Objects/Intl", "Intl", "#Locale_identification_and_negotiation", 1)}} のページをご覧ください。次の Unicode 拡張キーが利用できます。</p> + <p>BCP47 言語タグの文字列、または、そのような文字列の配列です。ブラウザーの既定のロケールを使用するには、空の配列を渡してください。。 Unicode 拡張に対応しています (例えば "<code>en-US-u-ca-buddhist</code>" など)。 <code>locales</code> 引数の一般的な形式と解釈は、 {{jsxref("Global_Objects/Intl", "Intl", "#Locale_identification_and_negotiation", 1)}} のページをご覧ください。次の Unicode 拡張キーが利用できます。</p> <dl> <dt><code>nu</code></dt> @@ -51,6 +51,10 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/Date <li>"<code>medium</code>"</li> <li>"<code>short</code>"</li> </ul> + + <div class="blockIndicator note"> + <p><code>dateStyle</code> は <code>timeStyle</code> と一緒に使用することができますが、他のオプションと一緒に使用することができません (例えば <code>weekday</code>, <code>hour</code>, <code>month</code>, など)。</p> + </div> </dd> <dt><code>timeStyle</code></dt> <dd><code>format()</code> が呼び出された際に使用される時刻の書式化スタイルです。利用可能な値は以下のとおりです。 @@ -61,8 +65,11 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/Date <li>"<code>short</code>"</li> </ul> </dd> - <dt><code>fractionalSecondDigits</code></dt> - <dd><code>format()</code> を呼び出したときに適用する秒の小数点以下の桁数です。有効な値は 0-3 です。</dd> + <dd> + <div class="blockIndicator note"> + <p><code>timeStyle</code> は <code>dateStyle</code> と一緒に使用することができますが、他のオプションと一緒に使用することができません (例えば <code>weekday</code>, <code>hour</code>, <code>month</code>, など)。</p> + </div> + </dd> <dt><code>calendar</code></dt> <dd>暦です。有効な値は、 "<code>buddhist</code>", "<code>chinese</code>", " <code>coptic</code>", "<code>ethiopia</code>", "<code>ethiopic</code>", "<code>gregory</code>", " <code>hebrew</code>", "<code>indian</code>", "<code>islamic</code>", "<code>iso8601</code>", " <code>japanese</code>", "<code>persian</code>", "<code>roc</code>" です。</dd> <dt><code>dayPeriod</code></dt> @@ -142,6 +149,20 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/Date <dd>分の表現です。利用可能な値は "<code>numeric</code>", "<code>2-digit</code>" です。</dd> <dt><code>second</code></dt> <dd>秒の表現です。利用可能な値は "<code>numeric</code>", "<code>2-digit</code>" です。</dd> + <dt><code>fractionalSecondDigits</code></dt> + <dd> + <div class="blockIndicator note"> + <p class="noinclude">Firefox 84, Chrome 84, などで追加されました。詳しくは互換性一覧表を参照してください。</p> + </div> + 秒の小数点以下を表すために使用される数字の桁数 (その先の桁は切り捨てられます)。利用可能な値は次の通りです。 + + <ul> + <li><code>0</code> (小数点以下は切り捨て)</li> + <li><code>1</code> (小数点以下は1桁で表される。例えば、 736 は <code>7</code> と書式化される。)</li> + <li><code>2</code> (小数点以下は2桁で表される。例えば、 736 は <code>73</code> と書式化される。)</li> + <li><code>3</code> (小数点以下は2桁で表される。例えば、 736 は <code>736</code> と書式化される。)</li> + </ul> + </dd> <dt><code>timeZoneName</code></dt> <dd>タイムゾーン名の表現です。利用可能な値は以下の通りです。 <ul> @@ -155,6 +176,37 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/Date </dd> </dl> +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_DateTimeFormat" name="Using_DateTimeFormat">DateTimeFormat の使用</h3> + +<p>ロケールを指定しない基本的な使用方法では、 <code>DateTimeFormat</code> は既定のロケールとオプションを使用します。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// toLocaleString without arguments depends on the implementation, +// the default locale, and the default time zone +console.log(new Intl.DateTimeFormat().format(date)); +// → "12/19/2012" if run with en-US locale (language) and time zone America/Los_Angeles (UTC-0800)</pre> + +<h3 id="Using_timeStyle_and_dateStyle" name="Using_timeStyle_and_dateStyle">timeStyle と dateStyle の使用</h3> + +<pre class="brush: js notranslate">let o = new Intl.DateTimeFormat("en" , { + timeStyle: "short" +}); +console.log(o.format(Date.now())); // "13:31 AM" + +let o = new Intl.DateTimeFormat("en" , { + dateStyle: "short" +}); +console.log(o.format(Date.now())); // "07/07/20" + +let o = new Intl.DateTimeFormat("en" , { + timeStyle: "medium", + dateStyle: "short" +}); +console.log(o.format(Date.now())); // "07/07/20, 13:31:55 AM"</pre> + <h2 id="Specifications" name="Specifications">仕様書</h2> <table class="standard-table"> diff --git a/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/formatrange/index.html b/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/formatrange/index.html index 39d0d6212e..36091b38c9 100644 --- a/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/formatrange/index.html +++ b/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/formatrange/index.html @@ -10,23 +10,23 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/form --- <div>{{JSRef}}</div> -<p><strong><code>Intl.DateTimeFormat.prototype.formatRange()</code></strong> は、日付の範囲をもっとも簡明な方法で、 {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトがインスタンス化されたときに提供された <strong><code>locale</code></strong> と <code><strong>options</strong></code> に基づいて書式化します。</p> +<p><strong><code>Intl.DateTimeFormat.prototype.formatRange()</code></strong> は、日付の範囲をもっとも簡明な方法で、 {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトがインスタンス化されたときに提供された <strong><code>locale</code></strong> と <strong><code>options</code></strong> に基づいて書式化します。</p> <div>{{EmbedInteractiveExample("pages/js/intl-datetimeformat-prototype-formatrange.html", "taller")}}</div> -<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p> +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> <h2 id="Syntax" name="Syntax">構文</h2> -<pre><code>Intl.DateTimeFormat.prototype.formatRange(<var>startDate, endDate</var>)</code></pre> +<pre class="notranslate"><code>Intl.DateTimeFormat.prototype.formatRange(<var>startDate, endDate</var>)</code></pre> <h2 id="Examples" name="Examples">例</h2> -<h3 id="Basic_formatRange_usage" name="Basic_formatRange_usage">基本的な <code>formatRange</code> の使用</h3> +<h3 id="Basic_formatRange_usage" name="Basic_formatRange_usage">基本的な formatRange の使用</h3> -<p>このメソッドは2つの {{jsxref("Date")}} を受け取り、 {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトがインスタンス化されたときに提供された <strong><code>locale</code></strong> と <code><strong>options</strong></code> に基づいて日付の範囲を書式化します。</p> +<p>このメソッドは2つの {{jsxref("Date")}} を受け取り、 {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトがインスタンス化されたときに提供された <code>locale</code> と <code>options</code> に基づいて日付の範囲を書式化します。</p> -<pre class="brush: js">let date1 = new Date(Date.UTC(2007, 0, 10, 10, 0, 0)); +<pre class="brush: js notranslate">let date1 = new Date(Date.UTC(2007, 0, 10, 10, 0, 0)); let date2 = new Date(Date.UTC(2007, 0, 10, 11, 0, 0)); let date3 = new Date(Date.UTC(2007, 0, 20, 10, 0, 0)); // > 'Wed, 10 Jan 2007 10:00:00 GMT' @@ -66,19 +66,23 @@ console.log(fmt2.formatRange(date1, date3)); <thead> <tr> <th scope="col">仕様書</th> - <th scope="col">状態</th> - <th scope="col">備考</th> </tr> </thead> <tbody> <tr> - <td><a href="https://tc39.es/proposal-intl-DateTimeFormat-formatRange/#sec-intl.datetimeformat.prototype.formatRange">Intl.DateTimeFormat.prototype.formatRange</a></td> - <td>Stage 3</td> - <td></td> + <td>{{SpecName('Intl.DateTimeFormat.formatRange', '#sec-intl.datetimeformat.prototype.formatRange', 'formatRange()')}}</td> </tr> </tbody> </table> +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.DateTimeFormat.formatRange")}}</p> +</div> + <h2 id="See_also" name="See_also">関連情報</h2> <ul> diff --git a/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/supportedlocalesof/index.html b/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/supportedlocalesof/index.html index 0be4ec7300..d6659432fc 100644 --- a/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/supportedlocalesof/index.html +++ b/files/ja/web/javascript/reference/global_objects/intl/datetimeformat/supportedlocalesof/index.html @@ -9,120 +9,77 @@ tags: - Prototype translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/supportedLocalesOf --- -<div>{{JSRef("Global_Objects", "DateTimeFormat", "Intl,Collator,NumberFormat")}}</div> +<div>{{JSRef}}</div> -<h2 id="概要">概要</h2> +<p><strong><code>Intl.DateTimeFormat.supportedLocalesOf()</code></strong> メソッドは、ランタイムの既定のロケールで代替する必要なく日時の書式で対応されているものを含む配列を返します。</p> -<p>ランタイムのデフォルトローケルに戻る必要なしでフォーマットしている日時でサポートしている提供されているローケルを含んでいる配列を返します。</p> +<div>{{EmbedInteractiveExample("pages/js/intl-datetimeformat-prototype-supportedlocalesof.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> <h2 id="Syntax" name="Syntax">構文</h2> -<pre class="syntaxbox"><code>Intl.DateTimeFormat.supportedLocalesOf(<var>locales</var>[, <var>options</var>])</code></pre> +<pre class="syntaxbox notranslate">Intl.DateTimeFormat.supportedLocalesOf(<var>locales</var>[, <var>options</var>])</pre> <h3 id="Parameters" name="Parameters">引数</h3> <dl> - <dt><code>locales</code></dt> - <dd>BCP47言語タグの文字列、そのような文字列の配列。 <code>locales</code>引数の一般的な形式に対して、{{jsxref("Global_Objects/Intl", "Intl page", "#Locale_identification_and_negotiation", 1)}}を確かめて下さい。</dd> - <dt><code>options</code></dt> + <dt><code><var>locales</var></code></dt> + <dd>BCP 47 言語タグを持つ文字列、またはそのような文字列の配列です。 <code>locales</code> 引数の一般的な形式については、 {{jsxref("Intl", "Intl のページ", "#Locale_identification_and_negotiation", 1)}}を参照してください。</dd> + <dt><code><var>options</var></code></dt> <dd> - <p>オプション。次のプロパティを持つオブジェクト:</p> + <p>省略可能です。以下のプロパティを持つことがあるオブジェクトです。</p> <dl> <dt><code>localeMatcher</code></dt> - <dd>使っているローケルマッチングアルゴリズム。利用可能な値は<code>"lookup"</code>、<code>"best fit"</code>。デフォルトでは <code>"best fit"</code>。このオプションについての情報のために、{{jsxref("Global_Objects/Intl", "Intl page", "#Locale_negotiation", 1)}}を確かめて下さい。</dd> + <dd>使用するロケールの一致アルゴリズムです。指定可能な値は <code>lookup</code> および <code>best fit</code> で、既定値は <code>best fit</code> です。このオプションの詳細は、 {{jsxref("Intl", "Intl のページ", "#Locale_negotiation", 1)}}を参照してください。</dd> </dl> </dd> </dl> -<h2 id="説明">説明</h2> +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>指定したロケールタグのサブセットを表す文字列の配列で、ランタイムの既定のロケールで代替する必要なく日時の書式で対応されているものを含みます。</p> + +<h2 id="Description" name="Description">解説</h2> -<p><code>locales</code>で提供されている言語タグのサブセットを持つ配列を返します。返される言語タグは、ランタイムがローケルマッチングアルゴリズムを使って考慮してフォーマットしている日時でのローケルをサポートしていてるので、デフォルトローケルに戻る必要はありません。</p> +<p><code>locales</code> で提供されている言語タグのサブセットを含む配列を返します。返される言語タグは、ランタイムが日時のロケールに対応しているもので、使用しているロケール一致アルゴリズムで一致しているとみなされているものです。</p> -<h2 id="例">例</h2> +<h2 id="Examples" name="Examples">例</h2> -<h3 id="例_supportedLocalesOfを使う">例: <code>supportedLocalesOf</code>を使う</h3> +<h3 id="Using_supportedLocalesOf" name="Using_supportedLocalesOf">supportedLocalesOf() の使用</h3> -<p>日時のフォーマットで、バリ語ではなく、インドネシア語とドイツ語をサポートしているランタイムを仮定すると、<code>supportedLocalesOf</code>はインドネシア語とドイツ語の言語タグを返します。ピンインは日時のフォーマットには適切ではなくインドネシア語では使われません。インドネシアの特定のドイツ語はサポートされそうにもありません。 <code>"lookup"</code>アルゴリズムの指定に注意して下さい。<code>"best fit"</code>はインドネシア語はバリ語に対して、十分にふさわしいと決定するかもしれません。というのも、 ほとんどのバリの人はインドネシア語も理解するからです。それゆえバリ言語タグも同様に返します。</p> +<p>日時の書式でインドネシア語とドイツ語に対応しており、バリ語に対応していないランタイムを想定すると、 <code>supportedLocalesOf</code> はインドネシア語とドイツ語の言語タグを変更せずに返しますが、 pinyin の照合は日時の書式には関係なく、インドネシア語でも使用されません。ここでの <code>lookup</code> アルゴリズムの仕様に注意してください — バリ語話者のほとんどはインドネシア語も理解しているので、 <code>best fit</code> のマッチャーはインドネシア語がバリ語に適切に一致すると判断し、バリ語の言語タグも返すかもしれません。</p> -<pre class="brush: js">var locales = ['ban', 'id-u-co-pinyin', 'de-ID']; +<pre class="brush: js notranslate">var locales = ['ban', 'id-u-co-pinyin', 'de-ID']; var options = { localeMatcher: 'lookup' }; console.log(Intl.DateTimeFormat.supportedLocalesOf(locales, options).join(', ')); // → "id-u-co-pinyin, de-ID" </pre> -<h2 id="仕様">仕様</h2> +<h2 id="Specifications" name="Specifications">仕様書</h2> <table class="standard-table"> <tbody> <tr> - <th scope="col">仕様</th> - <th scope="col">状況</th> - <th scope="col">コメント</th> + <th scope="col">仕様書</th> </tr> <tr> - <td>{{SpecName('ES Int 1.0', '#sec-12.2.2', 'Intl.DateTimeFormat.supportedLocalesOf')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Initial definition.</td> + <td>{{SpecName('ES Int Draft', '#sec-intl.datetimeformat.supportedlocalesof', 'Intl.DateTimeFormat.supportedLocalesOf')}}</td> </tr> </tbody> </table> -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2> +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> -<div>{{CompatibilityTable}}</div> +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>機能</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>基本サポート</td> - <td>{{CompatChrome("24")}}</td> - <td>{{CompatGeckoDesktop("29")}}</td> - <td>{{CompatIE("11")}}</td> - <td>{{CompatOpera("15")}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>機能</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>基本サポート</td> - <td>{{CompatNo}}</td> - <td>{{CompatChrome("26")}}</td> - <td>{{CompatNo}}<br> - {{bug("864843")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> +<p>{{Compat("javascript.builtins.Intl.DateTimeFormat.supportedLocalesOf")}}</p> </div> -<h2 id="関連情報">関連情報</h2> +<h2 id="See_also" name="See_also">関連情報</h2> <ul> - <li>{{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}</li> + <li>{{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}</li> </ul> diff --git a/files/ja/web/javascript/reference/global_objects/intl/listformat/index.html b/files/ja/web/javascript/reference/global_objects/intl/listformat/index.html index 08be4d24aa..453fd66739 100644 --- a/files/ja/web/javascript/reference/global_objects/intl/listformat/index.html +++ b/files/ja/web/javascript/reference/global_objects/intl/listformat/index.html @@ -74,6 +74,10 @@ console.log(new Intl.ListFormat('en-GB', { style: 'long', type: 'conjunction' }) // { "type": "element", "value": "Car" } ]; </pre> +<h2 id="Polyfill" name="Polyfill">ポリフィル</h2> + +<p><a href="https://formatjs.io/docs/polyfills/intl-listformat">formatjs Intl.ListFormat polyfill</a></p> + <h2 id="Specifications" name="Specifications">仕様書</h2> <table class="standard-table"> diff --git a/files/ja/web/javascript/reference/global_objects/intl/numberformat/formattoparts/index.html b/files/ja/web/javascript/reference/global_objects/intl/numberformat/formattoparts/index.html index 5d4a91fc85..240d9d2219 100644 --- a/files/ja/web/javascript/reference/global_objects/intl/numberformat/formattoparts/index.html +++ b/files/ja/web/javascript/reference/global_objects/intl/numberformat/formattoparts/index.html @@ -14,7 +14,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/format --- <div>{{JSRef}}</div> -<p><strong><code>Intl.Numberformat.prototype.formatToParts()</code></strong> メソッドは <code>NumberTimeFormat</code> フォーマッターによって生成された文字列のロケールに応じた書式設定を可能にします。</p> +<p><strong><code>Intl.Numberformat.prototype.formatToParts()</code></strong> メソッドは <code>NumberFormat</code> フォーマッターによって生成された文字列のロケールに応じた書式設定を可能にします。</p> <h2 id="Syntax" name="Syntax">構文</h2> @@ -69,6 +69,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/format <dl> <dt>percentSign</dt> <dd>パーセント文字列 ("%")。</dd> + <dt>unit</dt> + <dd>単位の文字列、例えば "l" または "litres" で、 <code>unitDisplay</code> がどのように指定されているかに依存します。</dd> </dl> <h2 id="Examples" name="Examples">例</h2> |