Merge branch 'main' into patch-2

mdn · Aug 2, 2023 · 58b2408 · 58b2408
2 parents 4d255aa + 67ac260
commit 58b2408
Show file tree

Hide file tree

Showing 23 changed files with 401 additions and 126 deletions.
diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc
@@ -25,11 +25,9 @@
     "single-title": {
       "front_matter_title": "^\\s*title\\s*[:=]"
     },
-    "no-trailing-punctuation": false,
-    // XXX Replace with the following when ready:
-    // "no-trailing-punctuation": {
-    //   "punctuation": ".,;:"
-    // },
+    "no-trailing-punctuation": {
+      "punctuation": ".,;:"
+    },
     // Consecutive Notes/Callouts currently don't conform with this rule
     "no-blanks-blockquote": false,
     // Force ordered numbering to catch accidental list ending from indenting

diff --git a/files/fr/web/javascript/reference/statements/import/index.md b/files/fr/web/javascript/reference/statements/import/index.md
@@ -57,7 +57,7 @@ monModule.faireToutesLesChosesIncroyables();
 
 ### Importer un seul export depuis un module
 
-Étant donné un objet ou une valeur nommé(e) `monExport` qui est exporté(e) depuis le module `mon-module`, soit implicitement (parce que l'intégralité du module est exportée), soit explicitement (en utilisant l'instruction {{jsxref("Statements/export", "export")}}), ce qui suit insére `monExport` dans la portée courante.
+Étant donné un objet ou une valeur nommé(e) `monExport` qui est exporté(e) depuis le module `mon-module`, soit implicitement (parce que l'intégralité du module est exportée), soit explicitement (en utilisant l'instruction {{jsxref("Statements/export", "export")}}), ce qui suit insère `monExport` dans la portée courante.
 
 ```js
 import { monExport } from "/modules/mon-module.js";
@@ -73,7 +73,7 @@ import { machin, truc } from "/modules/mon-module.js";
 
 ### Importer un élément exporté avec un alias
 
-Vous pouvez renommer un export lors de l'importation. Par exemple, ce qui suit insére `nomCourt` dans la portée courante.
+Vous pouvez renommer un export lors de l'importation. Par exemple, ce qui suit insère `nomCourt` dans la portée courante.
 
 ```js
 import { nomDExportDeModuleVraimentVraimentLong as nomCourt } from "/modules/mon-module.js";

diff --git a/files/ja/web/api/customevent/customevent/index.md b/files/ja/web/api/customevent/customevent/index.md
@@ -1,6 +1,9 @@
 ---
-title: CustomEvent()
+title: "CustomEvent: CustomEvent() コンストラクター"
+short-title: CustomEvent()
 slug: Web/API/CustomEvent/CustomEvent
+l10n:
+  sourceCommit: 53b1989260054e651bcf001bacee9b843b8ca9c8
 ---
 
 {{APIRef("DOM")}}
@@ -9,16 +12,15 @@ slug: Web/API/CustomEvent/CustomEvent
 
 ## 構文
 
-```js
+```js-nolint
 new CustomEvent(type)
 new CustomEvent(type, options)
 ```
 
 ### 引数
 
 - `type`
-  - : イベントの名前を表す文字列です。
-    大文字と小文字を区別し、ブラウザーは常に `customevent` を設定します。
+  - : イベントの名前を表す文字列です。イベント名は大文字小文字を区別します。
 - `options` {{optional_inline}}
   - : オブジェクトで、 {{domxref("Event/Event", "Event()")}} で定義されるプロパティに加えて、以下のプロパティを指定することができます。
     - `detail` {{optional_inline}}
@@ -33,19 +35,19 @@ new CustomEvent(type, options)
 
 ```js
 // カスタムイベントを作成
-const catFound = new CustomEvent('animalfound', {
+const catFound = new CustomEvent("animalfound", {
   detail: {
-    name: 'cat'
-  }
+    name: "cat",
+  },
 });
-const dogFound = new CustomEvent('animalfound', {
+const dogFound = new CustomEvent("animalfound", {
   detail: {
-    name: 'dog'
-  }
+    name: "dog",
+  },
 });
 
 // 適切なイベントリスナーを追加
-obj.addEventListener('animalfound', (e) => console.log(e.detail.name));
+obj.addEventListener("animalfound", (e) => console.log(e.detail.name));
 
 // イベントの配信
 obj.dispatchEvent(catFound);

diff --git a/files/ja/web/api/customevent/detail/index.md b/files/ja/web/api/customevent/detail/index.md
@@ -1,6 +1,9 @@
 ---
-title: CustomEvent.detail
+title: "CustomEvent: detail プロパティ"
+short-title: detail
 slug: Web/API/CustomEvent/detail
+l10n:
+  sourceCommit: 53b1989260054e651bcf001bacee9b843b8ca9c8
 ---
 
 {{APIRef("DOM")}}
@@ -15,19 +18,19 @@ slug: Web/API/CustomEvent/detail
 
 ```js
 // カスタムイベントを作成
-const catFound = new CustomEvent('animalfound', {
+const catFound = new CustomEvent("animalfound", {
   detail: {
-    name: 'cat'
-  }
+    name: "cat",
+  },
 });
-const dogFound = new CustomEvent('animalfound', {
+const dogFound = new CustomEvent("animalfound", {
   detail: {
-    name: 'dog'
-  }
+    name: "dog",
+  },
 });
 
 // 適切なイベントリスナーを追加
-obj.addEventListener('animalfound', (e) => console.log(e.detail.name));
+obj.addEventListener("animalfound", (e) => console.log(e.detail.name));
 
 // イベントの配信
 obj.dispatchEvent(catFound);

diff --git a/files/ja/web/api/customevent/index.md b/files/ja/web/api/customevent/index.md
@@ -1,6 +1,8 @@
 ---
 title: CustomEvent
 slug: Web/API/CustomEvent
+l10n:
+  sourceCommit: b280ea1234452ff553caa466bf532a66ba51db01
 ---
 
 {{APIRef("DOM")}}
@@ -16,18 +18,16 @@ slug: Web/API/CustomEvent
 - {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}
   - : `CustomEvent` を生成します。
 
-## プロパティ
+## インスタンスプロパティ
 
-_親である {{domxref("Event")}} インターフェイスからプロパティを継承しています。_
+_親である {{domxref("Event")}} インターフェイスから継承したプロパティがありますます。_
 
-- {{domxref("CustomEvent.detail")}} {{readonlyinline}}
+- {{domxref("CustomEvent.detail")}} {{ReadOnlyInline}}
   - : イベントが初期化されたときに渡された何らかのデータを返します。
 
-<em>このインターフェイスは親である {{domxref("Event")}} からプロパティを継承します</em>
+## インスタンスメソッド
 
-## メソッド
-
-_親である {{domxref("Event")}} インターフェイスからメソッドを継承しています。_
+_親である {{domxref("Event")}} インターフェイスから継承したメソッドがあります。_
 
 - {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}}
   - : `CustomEvent` オブジェクトを初期化します。イベントが既に配信されている場合、このメソッドは何も行いません。

diff --git a/files/ja/web/api/customevent/initcustomevent/index.md b/files/ja/web/api/customevent/initcustomevent/index.md
@@ -1,6 +1,9 @@
 ---
-title: CustomEvent.initCustomEvent()
+title: "CustomEvent: initCustomEvent() メソッド"
+short-title: initCustomEvent()
 slug: Web/API/CustomEvent/initCustomEvent
+l10n:
+  sourceCommit: 53b1989260054e651bcf001bacee9b843b8ca9c8
 ---
 
 {{APIRef("DOM")}}{{Deprecated_header}}
@@ -19,8 +22,8 @@ slug: Web/API/CustomEvent/initCustomEvent
 
 ## 構文
 
-```js
-event.initCustomEvent(type, canBubble, cancelable, detail);
+```js-nolint
+event.initCustomEvent(type, canBubble, cancelable, detail)
 ```
 
 ### 引数

diff --git a/files/ja/web/api/devicemotionevent/acceleration/index.md b/files/ja/web/api/devicemotionevent/acceleration/index.md
@@ -0,0 +1,43 @@
+---
+title: "DeviceMotionEvent: acceleration プロパティ"
+short-title: acceleration
+slug: Web/API/DeviceMotionEvent/acceleration
+l10n:
+  sourceCommit: 53b1989260054e651bcf001bacee9b843b8ca9c8
+---
+
+{{APIRef("Device Orientation Events")}}
+
+**`acceleration`** プロパティは、端末によって記録された加速度の量を[メートル毎秒毎秒 (m/s²)](https://ja.wikipedia.org/wiki/メートル毎秒毎秒)単位で返します。
+{{DOMxRef("DeviceMotionEvent.accelerationIncludingGravity")}} とは異なり、加速度値は重力の影響を含みません。
+
+> **メモ:** ハードウェアが加速度データから重力を除去する方法を知らない場合、{{DOMxRef("DeviceMotionEvent")}} にこの値が存在しないことがあります。この場合、代わりに {{DOMxRef("DeviceMotionEvent.accelerationIncludingGravity")}} を使用する必要があります。
+
+## 値
+
+`acceleration` プロパティは 3 軸の加速度に関する情報を提供するオブジェクトです。それぞれの軸は自分自身でプロパティを使って表します。
+
+- `x`
+  - : 西から東へ向かう軸である X 軸の加速度を表します。
+- `y`
+  - : 南から北へ向かう軸である Y 軸の加速度を表します。
+- `z`
+  - : 下から上へ向かう軸である Z 軸の加速度を表します。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{DOMxRef("DeviceMotionEvent.accelerationIncludingGravity")}}
+- {{DOMxRef("window.devicemotion_event", "devicemotion") }} イベント
+- {{DOMxRef("window.deviceorientation_event", "deviceorientation") }} イベント
+- {{DOMxRef("DeviceOrientationEvent")}}
+- {{DOMxRef("LinearAccelerationSensor")}}
+- [端末の方向の検出](/ja/docs/Web/API/Device_orientation_events/Detecting_device_orientation)
+- [方向および動きとして示されるデータ](/ja/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained)
diff --git a/files/ja/web/api/devicemotionevent/accelerationincludinggravity/index.md b/files/ja/web/api/devicemotionevent/accelerationincludinggravity/index.md
@@ -0,0 +1,44 @@
+---
+title: "DeviceMotionEvent: accelerationIncludingGravity プロパティ"
+short-title: accelerationIncludingGravity
+slug: Web/API/DeviceMotionEvent/accelerationIncludingGravity
+l10n:
+  sourceCommit: 53b1989260054e651bcf001bacee9b843b8ca9c8
+---
+
+{{APIRef("Device Orientation Events")}}
+
+**`accelerationIncludingGravity`** プロパティは、端末が記録した加速度を[メートル毎秒毎秒 (m/s²)](https://ja.wikipedia.org/wiki/メートル毎秒毎秒)単位で返します。重力の影響を補正する {{DOMxRef("DeviceMotionEvent.acceleration")}} とは異なり、この値はユーザーによって発生させられた端末の加速度と、重力によって発生させられた加速度に反対の加速度の合計値です。言い換えれば、これは [g-force](https://en.wikipedia.org/wiki/G-Force) を測定します。実際には、この値は[加速度計](ja.wikipedia.org/wiki/加速度計)によって測定された生データを表します。
+
+この値は {{DOMxRef("DeviceMotionEvent.acceleration")}} ほど有益な値ではありません。しかし、ジャイロスコープを持たない端末など、加速度データから重力を解除できない端末では、この値しか利用できない場合があります。
+
+> **メモ:** `accelerationIncludingGravity` の名前は誤解を招く可能性があります。このプロパティは重力の影響を含めるために加速度を表します。例えば、機器が水平な画面に横たわり、画面が上向きになっている場合、重力は Z 軸に沿って -9.8 となり、`acceleration.z` は 0、`accelerationIncludingGravity.z` は 9.8 となります。同様に、機器が水平で画面を上に向けて自由落下している場合、重力は Z 軸に沿って -9.8 となり、`acceleration.z` は -9.8、`accelerationIncludingGravity.z` は 0 となります。
+
+## 値
+
+`accelerationIncludingGravity` プロパティは、3 軸の加速度に関する情報を指定されたオブジェクトです。それぞれの軸は、自分自身でプロパティを使って表します。
+
+- `x`
+  - : 西から東へ向かう軸である X 軸の加速度を表します。
+- `y`
+  - : 南から北へ向かう軸である Y 軸の加速度を表します。
+- `z`
+  - : 下から上へ向かう軸である Z 軸の加速度を表します。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{DOMxRef("DeviceMotionEvent.acceleration")}}
+- {{DOMxRef("window.devicemotion_event", "devicemotion") }} イベント
+- {{DOMxRef("window.deviceorientation_event", "deviceorientation") }} イベント
+- {{DOMxRef("DeviceOrientationEvent")}}
+- {{DOMxRef("Accelerometer")}}
+- [端末の方向の検出](/ja/docs/Web/API/Device_orientation_events/Detecting_device_orientation)
+- [方向および動きとして示されるデータ](/ja/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained)
diff --git a/files/ja/web/api/devicemotionevent/devicemotionevent/index.md b/files/ja/web/api/devicemotionevent/devicemotionevent/index.md
@@ -0,0 +1,49 @@
+---
+title: "DeviceMotionEvent: DeviceMotionEvent() コンストラクター"
+short-title: DeviceMotionEvent()
+slug: Web/API/DeviceMotionEvent/DeviceMotionEvent
+l10n:
+  sourceCommit: 339595951b78774e951b1a9d215a6db6b856f6b2
+---
+
+{{APIRef("Device Orientation Events")}}
+
+**`DeviceMotionEvent()`** コンストラクターは、新しい {{DOMxRef("DeviceMotionEvent")}} オブジェクトを作成します。
+
+## 構文
+
+```js-nolint
+new DeviceMotionEvent(type)
+new DeviceMotionEvent(type, options)
+```
+
+### 引数
+
+- `type`
+  - : 文字列で、このイベントの名前が入ります。
+    大文字小文字の区別があり、ブラウザーは常に `devicemotion` に設定します。
+- `options` {{Optional_Inline}}
+  - : オブジェクトで、_{{domxref("Event/Event", "Event()")}} に定義されているプロパティに加えて_、以下のプロパティを持つことができます。
+    - `acceleration`
+      - : {{domxref("DeviceMotionEventAcceleration")}} オブジェクトで、端末の加速度を X、Y、Z の 3 軸で表します。
+        加速度は [m/s²](https://ja.wikipedia.org/wiki/メートル毎秒毎秒) で表されます。
+    - `accelerationIncludingGravity`
+      - : {{domxref("DeviceMotionEventAcceleration")}} オブジェクトで、端末の加速度を X、Y、Z の 3 軸と、重力の影響で表します。
+        加速度は [m/s²](https://ja.wikipedia.org/wiki/メートル毎秒毎秒) で表されます。
+    - `rotationRate`
+      - : {{domxref("DeviceMotionEventRotationRate")}} オブジェクトで、端末の向きの変化率をアルファ、ベータ、ガンマの 3 方向の軸で表します。
+        回転率は秒あたりの角度で表されます。
+    - `interval` {{Optional_Inline}}
+      - : 端末からデータを取得する時間間隔をミリ秒単位で表します。既定値では `0` です。
+
+### 返値
+
+新しい {{domxref("DeviceMotionEvent")}} オブジェクトです。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
diff --git a/files/ja/web/api/devicemotionevent/index.md b/files/ja/web/api/devicemotionevent/index.md
@@ -32,7 +32,7 @@ l10n:
 ## 例
 
 ```js
-window.addEventListener('devicemotion', (event) => {
+window.addEventListener("devicemotion", (event) => {
   console.log(`${event.acceleration.x} m/s2`);
 });
 ```

diff --git a/files/ja/web/api/devicemotionevent/interval/index.md b/files/ja/web/api/devicemotionevent/interval/index.md
@@ -0,0 +1,32 @@
+---
+title: "DeviceMotionEvent: interval プロパティ"
+short-title: interval
+slug: Web/API/DeviceMotionEvent/interval
+l10n:
+  sourceCommit: 53b1989260054e651bcf001bacee9b843b8ca9c8
+---
+
+{{APIRef("Device Orientation Events")}}
+
+**`DeviceMotionEvent.interval`** プロパティは、基盤となるハードウェアからデータを取得する間隔をミリ秒単位で返します。これを使用して、モーションイベントの粒度を決定することができます。
+
+## 値
+
+時間間隔をミリ秒で表します。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{DOMxRef("DeviceMotionEvent")}}
+- {{DOMxRef("window.devicemotion_event", "devicemotion") }} イベント
+- {{DOMxRef("window.deviceorientation_event", "deviceorientation") }} イベント
+- {{DOMxRef("DeviceOrientationEvent")}}
+- [端末の方向の検出](/ja/docs/Web/API/Device_orientation_events/Detecting_device_orientation)
+- [方向および動きとして示されるデータ](/ja/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained)