Skip to content

Commit

Permalink
ja: Convert noteblocks to GFM Alerts (part 9)
Browse files Browse the repository at this point in the history
This PR converts the noteblocks for the Japanese locale to GFM Alerts syntax, using a [conversion script](https://github.com/queengooborg/mdn-toolkit/blob/main/upgrade-noteblock.js). This is part 9. Note: manual adjustments have also been made to correct some issues, including capitalization, syntax, duplicated keywords and more.
  • Loading branch information
queengooborg authored and mfuji09 committed Jul 29, 2024
1 parent d207397 commit 9e3c61c
Show file tree
Hide file tree
Showing 100 changed files with 240 additions and 120 deletions.
3 changes: 2 additions & 1 deletion files/ja/web/api/eventtarget/eventtarget/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,8 @@ l10n:

**`EventTarget()`** コンストラクターは、新しい {{domxref("EventTarget")}} オブジェクトのインスタンスを作成します。

> **メモ:** このコンストラクターを明示的に呼び出すことは、非常にまれです。ほとんどの場合、このコンストラクターは {{domxref("EventTarget")}} から派生したオブジェクトのコンストラクターの中で、 [`super`](/ja/docs/Web/JavaScript/Reference/Operators/super) キーワードによって使用されます。
> [!NOTE]
> このコンストラクターを明示的に呼び出すことは、非常にまれです。ほとんどの場合、このコンストラクターは {{domxref("EventTarget")}} から派生したオブジェクトのコンストラクターの中で、 [`super`](/ja/docs/Web/JavaScript/Reference/Operators/super) キーワードによって使用されます。
## 構文

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/eventtarget/removeeventlistener/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ l10n:

[イベントリスナー](/ja/docs/Web/API/EventTarget/addEventListener#イベントリスナーのコールバック)が {{domxref("EventTarget")}} の他のリスナーのイベント処理中に外された場合、イベントによって起動させることはありません。しかし、再接続は可能です。

> **警告:** リスナーが _capture_ フラグを設定したものと設定しないものの 2 つ登録されている場合、それぞれを別々に取り外す必要があります。キャプチャするリスナーを取り外しても、同じリスナーのキャプチャしないバージョンには影響しませんし、その逆も同様です。
> [!WARNING]
> リスナーが _capture_ フラグを設定したものと設定しないものの 2 つ登録されている場合、それぞれを別々に取り外す必要があります。キャプチャするリスナーを取り外しても、同じリスナーのキャプチャしないバージョンには影響しませんし、その逆も同様です。
イベントリスナーを取り外すには、 {{domxref("AbortSignal")}} を {{domxref("EventTarget/addEventListener()", "addEventListener()")}} に渡して、後でそのシグナルを所有するコントローラーで {{domxref("AbortController/abort()", "abort()")}} を呼び出して行うことも可能です。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ l10n:

**`ExtendableCookieChangeEvent()`** コンストラクターは、{{domxref("ServiceWorkerRegistration/cookiechange_event", "ServiceWorkerRegistration.oncookiechange()")}} に渡されるイベント型である新しい {{domxref("ExtendableCookieChangeEvent")}} オブジェクトを生成します。このコンストラクターは、変更イベントが発生するとブラウザーによって呼ばれます。

> **メモ:** このコンストラクターは、通常は製品のウェブサイトでは必要ありません。主な使用法は、このイベントのインスタンスが必要なテストです。
> [!NOTE]
> このコンストラクターは、通常は製品のウェブサイトでは必要ありません。主な使用法は、このイベントのインスタンスが必要なテストです。
## 構文

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/extendablecookiechangeevent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@ l10n:
- Cookie が新規作成され、すぐに削除されます。この場合の `type``"deleted"` です。
- Cookie が削除されます。この場合の `type``"deleted"` です。

> **メモ:** 同じ名前・ドメイン・パスの他の Cookie が挿入されることにより置き換えられる Cookie は無視され、変更イベントを発生させません。
> [!NOTE]
> 同じ名前・ドメイン・パスの他の Cookie が挿入されることにより置き換えられる Cookie は無視され、変更イベントを発生させません。
{{InheritanceDiagram}}

Expand Down
12 changes: 8 additions & 4 deletions files/ja/web/api/extendableevent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,15 @@ l10n:

{{domxref("ExtendableEvent.waitUntil","waitUntil()")}} が `ExtendableEvent` ハンドラーの外で呼び出された場合、ブラウザーは `InvalidStateError` 例外を発生させます。 また、複数の呼び出しが積み重なり、その結果のプロミスが[存続期間延長プロミス](https://w3c.github.io/ServiceWorker/#extendableevent-extend-lifetime-promises)のリストに追加されることにも注意してください。

> **メモ:** 上記の段落で説明した振る舞いは、Firefox 43 で修正されました([Firefox バグ 1180274](https://bugzil.la/1180274) を参照)。
> [!NOTE]
> 上記の段落で説明した振る舞いは、Firefox 43 で修正されました([Firefox バグ 1180274](https://bugzil.la/1180274) を参照)。
このインターフェイスは、 {{domxref("Event")}} インターフェイスを継承しています。

{{InheritanceDiagram}}

> **メモ:** このインターフェイスは、グローバルスコープが {{domxref("ServiceWorkerGlobalScope")}} の場合にのみ使用できます。 {{domxref("Window")}} または別の種類のワーカーのスコープの場合は使用できません。
> [!NOTE]
> このインターフェイスは、グローバルスコープが {{domxref("ServiceWorkerGlobalScope")}} の場合にのみ使用できます。 {{domxref("Window")}} または別の種類のワーカーのスコープの場合は使用できません。
## コンストラクター

Expand All @@ -41,7 +43,8 @@ _親である {{domxref("Event")}} からメソッドを継承しています。

コードスニペットは、サービスワーカーが使用するキャッシュのバージョン管理のベストプラクティスも示しています。 この例ではキャッシュは 1 つしかありませんが、同じアプローチを複数のキャッシュに使用できます。 キャッシュの一括指定識別子を特定のバージョン管理されたキャッシュ名にマップします。

> **メモ:** Chrome では、ログ文は、chrome://serviceworker-internals を介してアクセスされる関連サービスワーカーの "Inspect" インターフェイスを介して表示されます。
> [!NOTE]
> Chrome では、ログ文は、chrome://serviceworker-internals を介してアクセスされる関連サービスワーカーの "Inspect" インターフェイスを介して表示されます。
```js
const CACHE_VERSION = 1;
Expand Down Expand Up @@ -82,7 +85,8 @@ self.addEventListener("install", (event) => {
});
```

> **メモ:** リソースをフェッチするとき、リソースが {{glossary("CORS")}} をサポートしていないサーバーから提供される可能性がある場合は、`{mode: 'no-cors'}` を使用することが非常に重要です。 この例では、 [www.chromium.org](https://www.chromium.org/) は CORS をサポートしていません。
> [!NOTE]
> リソースをフェッチするとき、リソースが {{glossary("CORS")}} をサポートしていないサーバーから提供される可能性がある場合は、`{mode: 'no-cors'}` を使用することが非常に重要です。 この例では、 [www.chromium.org](https://www.chromium.org/) は CORS をサポートしていません。
## 仕様書

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/extendableevent/waituntil/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@ l10n:

`waitUntil()` メソッドは、最初はイベントコールバック内で呼び出す必要がありますが、その後、すべてのプロミスが解決するまで、複数回呼び出すことができます。

> **メモ:** 上記の段落で説明した動作は、 Firefox 43 で修正されました([Firefox バグ 1180274](https://bugzil.la/1180274) を参照)。
> [!NOTE]
> 上記の段落で説明した動作は、 Firefox 43 で修正されました([Firefox バグ 1180274](https://bugzil.la/1180274) を参照)。
## 構文

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/fenced_frame_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,8 @@ Supports-Loading-Mode: fenced-frame

{{domxref("Navigator.runAdAuction()")}} などの {{domxref("FencedFrameConfig")}} を作成する一部の API 機能([Protected Audience API](https://developer.chrome.com/docs/privacy-sandbox/fledge/))や {{domxref("WindowSharedStorage. selectURL()")}} ([共有ストレージ API](/ja/docs/Web/API/Shared_Storage_API))、他にも {{domxref("Fence.reportEvent()")}} のような機能は、[プライバシーサンドボックス登録プロセス](/ja/docs/Web/Privacy/Privacy_sandbox/Enrollment)にウェブサイトを登録するよう要求されます。これを行わないと、 API 呼び出しはコンソールの警告とともに失敗します。

> **メモ:** Chrome では、登録しなくてもフレームコードをローカルでテストすることができます。ローカルテストを許可するには、以下の Chrome 開発者フラグを有効にしてください。
> [!NOTE]
> Chrome では、登録しなくてもフレームコードをローカルでテストすることができます。ローカルテストを許可するには、以下の Chrome 開発者フラグを有効にしてください。
>
> `chrome://flags/#privacy-sandbox-enrollment-overrides`
Expand Down
6 changes: 4 additions & 2 deletions files/ja/web/api/file_system_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,8 @@ l10n:

それぞれのハンドルが自身の機能を提供し、どっちを使っているかによって少し違いがあります(詳細は、[インターフェイス](#%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%95%E3%82%A7%E3%82%A4%E3%82%B9)の節を参照してください)。ファイルのデータや、選択されたディレクトリーの情報(子を含む)にアクセスできます。この API により、ウェブに欠けていた潜在的な機能への道が開きます。それでも、セキュリティは API の設計時に最大限考慮するべきことであり、ファイルやディレクトリーのデータへのアクセスはユーザーが特に許可しない限り禁止されています(これは、ユーザーから見えない[オリジンプライベートファイルシステム](#オリジンプライベートファイルシステム)の場合とは異なります)。

> **メモ:** API の機能を使う際に投げられる可能性がある例外は、仕様書での定義に沿って関連するページに一覧が載っています。しかし、 API と下層のオペレーティングシステムの相互作用により、状況はより複雑になります。[仕様書でエラーの対応関係を一覧にする](https://github.com/whatwg/fs/issues/57)ための提案がなされており、ここに有用な関連情報があります。
> [!NOTE]
> API の機能を使う際に投げられる可能性がある例外は、仕様書での定義に沿って関連するページに一覧が載っています。しかし、 API と下層のオペレーティングシステムの相互作用により、状況はより複雑になります。[仕様書でエラーの対応関係を一覧にする](https://github.com/whatwg/fs/issues/57)ための提案がなされており、ここに有用な関連情報があります。
> **メモ:** {{domxref("FileSystemHandle")}} をベースとするオブジェクトは、{{domxref("IndexedDB API", "IndexedDB", "", "nocode")}} のデータベースのインスタンスにシリアライズしたり、{{domxref("window.postMessage", "postMessage()")}} を介して転送したりできます。
Expand Down Expand Up @@ -210,7 +211,8 @@ onmessage = async (e) => {
};
```

> **メモ:** 仕様書の以前のバージョンでは、{{domxref("FileSystemSyncAccessHandle.close()", "close()")}}、{{domxref("FileSystemSyncAccessHandle.flush()", "flush()")}}、{{domxref("FileSystemSyncAccessHandle.getSize()", "getSize()")}}、{{domxref("FileSystemSyncAccessHandle.truncate()", "truncate()")}} は人間工学に反して非同期メソッドとされていました。これは現在では[変更されています](https://github.com/whatwg/fs/issues/7)が、まだ非同期バージョンをサポートしているブラウザーもあります。
> [!NOTE]
> 仕様書の以前のバージョンでは、{{domxref("FileSystemSyncAccessHandle.close()", "close()")}}、{{domxref("FileSystemSyncAccessHandle.flush()", "flush()")}}、{{domxref("FileSystemSyncAccessHandle.getSize()", "getSize()")}}、{{domxref("FileSystemSyncAccessHandle.truncate()", "truncate()")}} は人間工学に反して非同期メソッドとされていました。これは現在では[変更されています](https://github.com/whatwg/fs/issues/7)が、まだ非同期バージョンをサポートしているブラウザーもあります。
## 仕様書

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,8 @@ OPFS がユーザーから見えるファイルシステムと異なる点をま

メインスレッドから OPFS にアクセスする場合は、非同期の {{jsxref("Promise")}} ベースの API を使用します。ファイル({{domxref("FileSystemFileHandle")}})とディレクトリー({{domxref("FileSystemDirectoryHandle")}})のハンドルにアクセスするには、 {{domxref("FileSystemDirectoryHandle.getFileHandle()")}} と {{domxref("FileSystemDirectoryHandle.getDirectoryHandle()")}} をそれぞれ、 OPFS ルート(および作成された子ディレクトリー)を表す {{domxref("FileSystemDirectoryHandle")}} オブジェクト上で呼び出します。

> **メモ:** 上記のメソッドに `{ create: true }` を渡すと、ファイルやフォルダー内が存在しない場合に作成されます。
> [!NOTE]
> 上記のメソッドに `{ create: true }` を渡すと、ファイルやフォルダー内が存在しない場合に作成されます。
```js
// ファイルとフォルダー内の階層を作成
Expand Down Expand Up @@ -122,7 +123,8 @@ for await (let name of directoryHandle.keys()) {

同期的にファイルにアクセスするには、 {{domxref("FileSystemFileHandle.createSyncAccessHandle()")}} を通常の {{domxref("FileSystemFileHandle")}} に対して呼び出します。

> **メモ:** 名前に "Sync" とあるにもかかわらず、`createSyncAccessHandle()` メソッド自体は非同期です。
> [!NOTE]
> 名前に "Sync" とあるにもかかわらず、`createSyncAccessHandle()` メソッド自体は非同期です。
```js
const opfsRoot = await navigator.storage.getDirectory();
Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/filelist/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/API/FileList

この型のオブジェクトは、 HTML の {{HTMLElement("input")}} 要素の `files` プロパティで返されます。これにより、 `<input type="file">` 要素で選択されているファイルのリストにアクセスすることができます。また、ドラッグ&ドロップ API を使用している場合は、ウェブコンテンツにドロップされたファイルのリストにも使用されます。使用方法の詳細は [`DataTransfer`](/ja/docs/Web/API/DataTransfer) オブジェクトを見てください。

> **メモ:** Gecko 1.9.2 より前は、input 要素は一度に 1 つのファイルだけ選択することができます。すなわち、 FileList に入るファイルは 1 つだけです。 Gecko 1.9.2 から、 input 要素の multiple 属性が true の場合、 FileList に複数のファイルが入ります。
> [!NOTE]
> Gecko 1.9.2 より前は、input 要素は一度に 1 つのファイルだけ選択することができます。すなわち、 FileList に入るファイルは 1 つだけです。 Gecko 1.9.2 から、 input 要素の multiple 属性が true の場合、 FileList に複数のファイルが入ります。
## ファイルリストの使用

Expand Down
6 changes: 4 additions & 2 deletions files/ja/web/api/filereader/readasdataurl/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ l10n:

`readAsDataURL` メソッドは、指定された{{domxref("Blob")}} または {{domxref("File")}} の内容を読み込むために使用されます。読み込み操作が終了すると、{{domxref("FileReader.readyState", "readyState")}} が `DONE` となり、{{domxref("FileReader/loadend_event", "loadend")}} が発生します。このとき、{{domxref("FileReader.result", "result")}} 属性には、ファイルのデータを表す、base64 エンコーディングされた [data: URL](/ja/docs/Web/HTTP/Basics_of_HTTP/Data_URLs) の文字列が格納されます。

> **メモ:** blob の {{domxref("FileReader.result","result")}} は、先に Base64 でエンコードされたデータの前にある Data-URL の宣言を削除しておかないと、直接 Base64 としてデコードすることができません。 Base64 でエンコードされた文字列のみを受け取る場合は、先に結果から `data:*/*;base64,` を削除しておく必要があります。
> [!NOTE]
> blob の {{domxref("FileReader.result","result")}} は、先に Base64 でエンコードされたデータの前にある Data-URL の宣言を削除しておかないと、直接 Base64 としてデコードすることができません。 Base64 でエンコードされた文字列のみを受け取る場合は、先に結果から `data:*/*;base64,` を削除しておく必要があります。
## 構文

Expand Down Expand Up @@ -105,7 +106,8 @@ function previewFiles() {
}
```

> **メモ:** Internet Explorer 10 以前では [`FileReader()`](/ja/docs/Web/API/FileReader) コンストラクターに対応していません。十分な互換性が必要とされるときは、[画像プレビューのクロスブラウザー対応ソリューション](https://mdn.dev/archives/media/attachments/2012/07/09/3699/2c8cb1e94f0ee05b22c1c30a3790c70d/crossbrowser_image_preview.html)または[もっと強力な例](https://mdn.dev/archives/media/attachments/2012/07/09/3698/391aef19653595a663cc601c42a67116/image_upload_preview.html)を参照してください。
> [!NOTE]
> Internet Explorer 10 以前では [`FileReader()`](/ja/docs/Web/API/FileReader) コンストラクターに対応していません。十分な互換性が必要とされるときは、[画像プレビューのクロスブラウザー対応ソリューション](https://mdn.dev/archives/media/attachments/2012/07/09/3699/2c8cb1e94f0ee05b22c1c30a3790c70d/crossbrowser_image_preview.html)または[もっと強力な例](https://mdn.dev/archives/media/attachments/2012/07/09/3698/391aef19653595a663cc601c42a67116/image_upload_preview.html)を参照してください。
## 仕様書

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/filereader/readastext/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ l10n:

> **メモ:** {{domxref("Blob.text()")}} メソッドは、ファイルをテキストとして読み取るための新しいプロミスベースの API です。
> **メモ:** このメソッドは、ファイルの内容全体をメモリーに読み込みますので、巨大なファイルには適していません。巨大なファイルには [`readAsArrayBuffer()`](/ja/docs/Web/API/FileReader/readAsArrayBuffer) の方が適しています。
> [!NOTE]
> このメソッドは、ファイルの内容全体をメモリーに読み込みますので、巨大なファイルには適していません。巨大なファイルには [`readAsArrayBuffer()`](/ja/docs/Web/API/FileReader/readAsArrayBuffer) の方が適しています。
## 構文

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/filereadersync/filereadersync/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,8 @@ function readFile(blob) {
}
```

> **メモ:** このスニペットは {{domxref("Worker")}} の中で使用しなければなりません。同期インターフェイスはメインスレッドでは使用することができないからです。
> [!NOTE]
> このスニペットは {{domxref("Worker")}} の中で使用しなければなりません。同期インターフェイスはメインスレッドでは使用することができないからです。
## 仕様書

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/filereadersync/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ l10n:

{{AvailableInWorkers}}

> **警告:** このインターフェイスは、ブロックが発生する可能性がある同期 I/O を使用するため、[ワーカー](/ja/docs/Web/API/Worker)**でのみ**利用できます。
> [!WARNING]
> このインターフェイスは、ブロックが発生する可能性がある同期 I/O を使用するため、[ワーカー](/ja/docs/Web/API/Worker)**でのみ**利用できます。
## コンストラクター

Expand Down
Loading

0 comments on commit 9e3c61c

Please sign in to comment.