Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ja: Convert noteblocks to GFM Alerts (part 8) #22702

Merged
merged 1 commit into from
Jul 28, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,8 @@ createWaveShaper()
以下の例では、 AudioContext を使用して波形整形ノードを作成する基本的な使い方を示しています。
もっと完全な応用例や情報については、 [Voice-change-O-matic](https://github.com/mdn/webaudio-examples/tree/main/voice-change-o-matic) の[デモ](https://mdn.github.io/webaudio-examples/voice-change-o-matic/)を参照してください(関連コードは [app.js の 108-193 行目](https://github.com/mdn/webaudio-examples/blob/main/voice-change-o-matic/scripts/app.js#L108-L193)を参照してください)。

> **メモ:** シグモイド関数は、その自然な特性から、歪みカーブとしてよく使われます。例えば、その S 字形状は、より滑らかなサウンドを作り出すのに役立ちます。 [Stack Overflow](https://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion) に、以下のような歪み曲線のコードが掲載されていました。
> [!NOTE]
> シグモイド関数は、その自然な特性から、歪みカーブとしてよく使われます。例えば、その S 字形状は、より滑らかなサウンドを作り出すのに役立ちます。 [Stack Overflow](https://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion) に、以下のような歪み曲線のコードが掲載されていました。

```js
const audioCtx = new AudioContext();
Expand Down
15 changes: 10 additions & 5 deletions files/ja/web/api/document/cookie/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,14 @@ document.cookie = newCookie;
ドメインが指定されれば、サブドメインも常に含まれます。
初期の仕様とは対照的に、ドメイン名の前のドットは無視されますが、ブラウザーはその様なドットを含むクッキーの設定を辞退することができます。

> **メモ:** ドメインは JavaScript のオリジンと一致している*必要があります*。
> [!NOTE]
> ドメインは JavaScript のオリジンと一致している*必要があります*。
> 外部ドメインへのクッキーの設定は暗黙に無視されます。

- `;expires=date-in-GMTString-format`: クッキーの期限です。もし `expires` も `max-age` も指定されていなければ、有効期限はセッションの終了までになります。

> **警告:** ユーザーのプライバシーを考慮するのであれば、ブラウザーの有効期限の管理に頼るのではなく、ウェブアプリの実装で指定した期間の経過後にクッキーを無効化することが重要です。
> [!WARNING]
> ユーザーのプライバシーを考慮するのであれば、ブラウザーの有効期限の管理に頼るのではなく、ウェブアプリの実装で指定した期間の経過後にクッキーを無効化することが重要です。
> 多くのブラウザーはユーザーがクッキーを無期限に設定することができますが、これは安全ではありません。

- 値の形式について知りたい方は、 {{jsxref("Date.toUTCString()")}} をご覧ください。
Expand Down Expand Up @@ -73,11 +75,14 @@ document.cookie = newCookie;
これは、クッキーが他のドメインに送出されることを防ぐために、 domain 属性が存在してはいけないことも指示します。
Chrome では、 path 属性は常にオリジンになります。

> **メモ:** ダッシュは接頭辞の一部とみなされます。
> [!NOTE]
> ダッシュは接頭辞の一部とみなされます。

> **メモ:** これらのフラグは `secure` 属性と一緒の場合のみ設定できます。
> [!NOTE]
> これらのフラグは `secure` 属性と一緒の場合のみ設定できます。

> **メモ:** 上記のコードに見られるように、 `document.cookie` はネイティブの*セッター*及び*ゲッター*を持つ[アクセサープロパティ](/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty#description)であり、値を持つ [データプロパティ](/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty#description)では*ありません*。書き込んだものと読みこんだものは同じにはならず、常に JavaScript インタープリターに仲介されます。
> [!NOTE]
> 上記のコードに見られるように、 `document.cookie` はネイティブの*セッター*及び*ゲッター*を持つ[アクセサープロパティ](/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty#description)であり、値を持つ [データプロパティ](/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty#description)では*ありません*。書き込んだものと読みこんだものは同じにはならず、常に JavaScript インタープリターに仲介されます。

## 例

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

**`Document.createAttribute()`** は、新しい属性ノードを生成して返します。生成されたオブジェクトは {{domxref("Attr")}} を実装したノードです。この方法では DOM は、特定の要素にどんな種類の属性を追加できるかを強制しません。

> **メモ:** 引数に渡される文字列は小文字に変換されます。
> [!NOTE]
> 引数に渡される文字列は小文字に変換されます。

## 構文

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/document/createelement/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,8 @@ createElement(tagName, options)

新しい {{domxref("Element")}} です。

> **メモ:** 文書が {{domxref("HTMLDocument", "HTMLDocument", "", "1")}} である場合、新しい {{domxref("HTMLElement", "HTMLElement", "", "1")}} を返しますが、これが最も一般的です。それ以外の場合は新しい {{domxref("Element","Element","","1")}} を返します。
> [!NOTE]
> 文書が {{domxref("HTMLDocument", "HTMLDocument", "", "1")}} である場合、新しい {{domxref("HTMLElement", "HTMLElement", "", "1")}} を返しますが、これが最も一般的です。それ以外の場合は新しい {{domxref("Element","Element","","1")}} を返します。

## 例

Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/document/createelementns/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,8 @@ createElementNS(namespaceURI, qualifiedName, options)
</page>
```

> **メモ:** 上記の例は XHTML 文書では推奨されていないインラインスクリプトを使用しています。この部分的な例は実際には XUL 文書に埋め込んだ XHTML があるものですが、それでもこの推奨事項は適用されます。
> [!NOTE]
> 上記の例は XHTML 文書では推奨されていないインラインスクリプトを使用しています。この部分的な例は実際には XUL 文書に埋め込んだ XHTML があるものですが、それでもこの推奨事項は適用されます。

## 仕様書

Expand Down
6 changes: 4 additions & 2 deletions files/ja/web/api/document/createtouch/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,8 @@ createTouch(view, target, identifier, pageX, pageY, screenX, screenY)

### 引数

> **メモ:** すべての引数が省略可能です。
> [!NOTE]
> すべての引数が省略可能です。

- `view`
- : タッチが発生した {{DOMxRef("window")}} です。
Expand All @@ -37,7 +38,8 @@ createTouch(view, target, identifier, pageX, pageY, screenX, screenY)
- `screenY`
- : {{DOMxRef("Touch.screenY")}} の値です。

> **メモ:** このメソッドの以前のバージョンでは、以下の追加の引数を含んでいましたが、これらの引数は下記の標準のいずれにも含まれていません。従って、これらの引数は非推奨であり、使用されないと考えてください。
> [!NOTE]
> このメソッドの以前のバージョンでは、以下の追加の引数を含んでいましたが、これらの引数は下記の標準のいずれにも含まれていません。従って、これらの引数は非推奨であり、使用されないと考えてください。

- `clientX`
- : {{DOMxRef("Touch.clientX")}} の値です。
Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/document/domcontentloaded_event/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,8 @@ if (document.readyState === "loading") {
}
```

> **メモ:** ここでは競合条件はありません。 `if` チェックと `addEventListener()` 呼び出しの間に文書が読み込まれることはあり得ません。JavaScript には run-to-completion という意味づけがあります。つまり、イベントループのある特定のタイミングで文書が読み込まれていたとしても、次のサイクルまで読み込まれることはなく、その時には `doSomething` ハンドラーはすでに取り付けられており、発生します。
> [!NOTE]
> ここでは競合条件はありません。 `if` チェックと `addEventListener()` 呼び出しの間に文書が読み込まれることはあり得ません。JavaScript には run-to-completion という意味づけがあります。つまり、イベントループのある特定のタイミングで文書が読み込まれていたとしても、次のサイクルまで読み込まれることはなく、その時には `doSomething` ハンドラーはすでに取り付けられており、発生します。

### ライブサンプル

Expand Down
12 changes: 8 additions & 4 deletions files/ja/web/api/document/evaluate/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,24 +43,28 @@ evaluate(xpathExpression, contextNode, namespaceResolver, resultType, result)
- : 単一の論理値を含む結果セット。例えば、 `not()` 関数を使用した _xpath_ 式に有用です。
- `UNORDERED_NODE_ITERATOR_TYPE` (`4`)
- : 式に一致するすべてのノードを含む結果セット。結果セット内のノードは、必ずしも文書内に現れる順番とは限りません。
> **メモ:** この型の結果は、文書内のノードへの参照を格納します。
> [!NOTE]
> この型の結果は、文書内のノードへの参照を格納します。
> ノードを変更すると、イテレーターは無効になります。
> ノードを変更した後、結果を反復処理しようとするとエラーになります。
- `ORDERED_NODE_ITERATOR_TYPE` (`5`)
- : 式に一致するすべてのノードを含む結果セット。結果セット内のノードは、文書内に現れる順序と同じです。
> **メモ:** この型の結果は、文書内のノードへの参照を格納します。
> [!NOTE]
> この型の結果は、文書内のノードへの参照を格納します。
> ノードを変更すると、イテレーターは無効になります。
> ノードを変更した後、結果を反復処理しようとするとエラーになります。
- `UNORDERED_NODE_SNAPSHOT_TYPE` (`6`)
- : 式に一致するすべてのノードのスナップショットを格納した結果セット。結果セット内のノードは、必ずしも文書内のノードと同じ順序ではありません。
> **メモ:** この型の結果はスナップショットで、基本的に一致するノードのリストです。
> [!NOTE]
> この型の結果はスナップショットで、基本的に一致するノードのリストです。
> スナップショットノードを変更することで、文書に変更を加えることができます。
> 文書を変更してもスナップショットは無効にはなりません。
> しかし、文書が変更された場合、スナップショットは文書の現在の状態と一致しないことがあります。
> ノードが移動されたり、変更されたり、追加されたり、除去されたりすることがあるからです。
- `ORDERED_NODE_SNAPSHOT_TYPE` (`7`)
- : 式に一致するすべてのノードのスナップショットを含む結果セット。結果セット内のノードは、文書内に現れる順序と同じです。
> **メモ:** この型の結果はスナップショットで、基本的に一致するノードのリストです。
> [!NOTE]
> この型の結果はスナップショットで、基本的に一致するノードのリストです。
> スナップショットノードを変更することで、文書に変更を加えることができます。
> 文書を変更してもスナップショットは無効にはなりません。
> しかし、文書が変更された場合、スナップショットは文書の現在の状態と一致しないことがあります。
Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/document/execcommand/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,8 @@ execCommand(aCommandName, aShowDefaultUI, aValueArgument)
- `useCSS` {{Deprecated_inline}}

- : 生成するマークアップに HTML タグと CSS のどちらを使用するかを切り替えます。引数として true または false の真偽値が必要です。
> **メモ:** この引数は論理が逆です(つまり、`false` で CSS が使用され、`true` で HTML が使用される)。これは `styleWithCSS` に置き換えられ、非推奨になりました。
> [!NOTE]
> この引数は論理が逆です(つまり、`false` で CSS が使用され、`true` で HTML が使用される)。これは `styleWithCSS` に置き換えられ、非推奨になりました。

- `styleWithCSS`
- : `useCSS` コマンドを置き換えるものです。`true` はマークアップ時に `style` 属性が生成または変更され、false では書式要素が生成されます。
Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/document/exitfullscreen/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,8 @@ document.onclick = (event) => {
};
```

> **メモ:** もっと完全な例については、[`Element.requestFullscreen()` の例](/ja/docs/Web/API/Element/requestFullscreen#%E4%BE%8B)をご覧ください。
> [!NOTE]
> もっと完全な例については、[`Element.requestFullscreen()` の例](/ja/docs/Web/API/Element/requestFullscreen#%E4%BE%8B)をご覧ください。

## 仕様書

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

**`forms`** は {{domxref("Document")}} インターフェイスの読み取り専用プロパティで、文書内に含まれるすべての {{HTMLElement("form")}} を列挙した {{domxref("HTMLCollection")}} を返します。

> **メモ:** 同様に、{{domxref("HTMLFormElement.elements")}} プロパティを使用すると、フォームコンポーネントのユーザー入力要素のリストにアクセスすることができます。
> [!NOTE]
> 同様に、{{domxref("HTMLFormElement.elements")}} プロパティを使用すると、フォームコンポーネントのユーザー入力要素のリストにアクセスすることができます。

## 値

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

このプロパティは読み取り専用ですが、変更されても(厳格モードでも)例外を投げません。セッターは何もしないので、無視されます。

> **メモ:** このプロパティは非推奨であり、文書が全画面モードになっているかどうかは、 {{DOMxRef("Document.fullscreenElement")}} が `null` ではないことで確認することができます。
> [!NOTE]
> このプロパティは非推奨であり、文書が全画面モードになっているかどうかは、 {{DOMxRef("Document.fullscreenElement")}} が `null` ではないことで確認することができます。

## 返値

Expand Down
6 changes: 4 additions & 2 deletions files/ja/web/api/document/getelementbyid/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,15 +12,17 @@ l10n:

ID を持たない要素にアクセスする必要がある場合は、 {{domxref("Document.querySelector", "querySelector()")}} で何らかの{{Glossary("CSS selector", "セレクター")}}を使用して要素を検索することができます。

> **メモ:** ID は文書内で固有である必要があります。単一の文書内で 2 つ以上の要素が同じ ID であった場合、このメソッドは最初に見つかった要素を返します。
> [!NOTE]
> ID は文書内で固有である必要があります。単一の文書内で 2 つ以上の要素が同じ ID であった場合、このメソッドは最初に見つかった要素を返します。

## 構文

```js-nolint
getElementById(id)
```

> **メモ:** メソッド名における `"Id"` の部分は、関数のコードに対して正しくなければなりません。 `getElementByID()` は自然に見えるかもしれませんが、正しくなく動作しません。
> [!NOTE]
> メソッド名における `"Id"` の部分は、関数のコードに対して正しくなければなりません。 `getElementByID()` は自然に見えるかもしれませんが、正しくなく動作しません。

### 引数

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

{{domxref("document")}} オブジェクトに対して呼び出したときは、ルートノードを含む文書全体が検索されます。任意の要素に対して {{domxref("Element.getElementsByClassName", "getElementsByClassName()")}} を呼び出すこともできます。その場合は、指定されたルート要素下の指定されたクラス名を持つ要素だけを返します。

> **警告:** これは生きた {{domxref("HTMLCollection")}} です。DOM の変更は、その都度配列に反映されます。この配列で選択された要素がセレクターに該当しなくなった場合は、 自動的に除去されます。反復処理する際には、このことに注意しましょう。
> [!WARNING]
> これは生きた {{domxref("HTMLCollection")}} です。DOM の変更は、その都度配列に反映されます。この配列で選択された要素がセレクターに該当しなくなった場合は、 自動的に除去されます。反復処理する際には、このことに注意しましょう。

## 構文

Expand Down
6 changes: 4 additions & 2 deletions files/ja/web/api/document/getelementsbytagnamens/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,13 @@ getElementsByTagNameNS(namespace, name)

見つかった要素の生きた {{DOMxRef("NodeList")}}(但し下記のメモを参照)で、ツリーに現れる順です。

> **メモ:** W3C の仕様書では返値は `NodeList` であるとされていますが、Firefox ではこのメソッドは {{DOMxRef("HTMLCollection")}} を返します。
> [!NOTE]
> W3C の仕様書では返値は `NodeList` であるとされていますが、Firefox ではこのメソッドは {{DOMxRef("HTMLCollection")}} を返します。
> Opera は `NodeList` を返しますが、 `namedItem` メソッドを実装しているので、 `HTMLCollection` と同様になります。2012 年 1 月時点で、 WebKit ブラウザーのみが純粋な `NodeList` の値を返します。
> 詳しくは [bug 14869](https://bugzil.la/14869) を参照してください。

> **メモ:** 現在、このメソッドの引数は大文字と小文字を区別しますが、 Firefox 3.5 以前は大文字と小文字を区別していませんでした。
> [!NOTE]
> 現在、このメソッドの引数は大文字と小文字を区別しますが、 Firefox 3.5 以前は大文字と小文字を区別していませんでした。
> 詳しくは [Firefox 3.6 の開発者リリースノート](/ja/docs/Mozilla/Firefox/Releases/3.6#dom)および {{domxref("Element.getElementsByTagNameNS")}} のブラウザーの互換性のメモをご覧ください。

## 例
Expand Down
3 changes: 2 additions & 1 deletion files/ja/web/api/document/hasfocus/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ l10n:
**`hasFocus()`** は {{domxref("Document")}} インターフェイスのメソッドで、文書または文書内の何れかの要素がフォーカスを持っているかどうかを示す論理値を返します。
このメソッドは、文書内のアクティブな要素がフォーカスを持っているかどうかを特定するために使用することができます。

> **メモ:** 文書を見ている時、文書内でフォーカスを持つ要素は常に[アクティブ要素](/ja/docs/Web/API/Document/activeElement)ですが、アクティブ要素がフォーカスを持っているとは限りません。
> [!NOTE]
> 文書を見ている時、文書内でフォーカスを持つ要素は常に[アクティブ要素](/ja/docs/Web/API/Document/activeElement)ですが、アクティブ要素がフォーカスを持っているとは限りません。
> 例えば、フォアグラウンドになっていないポップアップウィンドウ内のアクティブ要素はフォーカスを持ちません。

## 構文
Expand Down
Loading