API イベントサブページのテンプレート
メモ: この説明文全体を削除してから公開してください
ページの先頭部分:
ページ上部の先頭部分は、「ページのメタデータ」を定義するために使用します。 値は、個々のイベントに応じて適切に書き換える必要があります。
md
---
title: "インターフェイス名: <イベント名> イベント"
slug: Web/API/インターフェイス名/イベント名_event
page-type: web-api-event
status:
- experimental
- deprecated
- non-standard
browser-compat: path.to.feature.NameOfTheEvent_event
---
- title
-
タイトルの見出しは、ページの最上部に表示されます。 形式は "インターフェイス名: イベント名 イベント" です。 例えば、 Element インターフェイスの animationcancel イベントには
Window: animationcancel イベント
というタイトルを付けます。 - slug
-
https://developer.mozilla.org/ja/docs/
の後にくる URL の末尾です。 これはWeb/API/インターフェイス名/イベント名_event
のような形式になります。 - page-type
-
page-type
キーは、 Web/API イベントでは常にweb-api-event
です。 - status
-
(適切な)技術の状態のキーを入れてください。 experimental、deprecated、non-standard (標準化過程にない場合)
- browser-compat
-
プレースホルダーの値
path.to.feature.NameOfTheEvent_event
を ブラウザー互換性データリポジトリー にあるイベントのクエリー文字列に置き換えてください。 ツールチェインが自動的に互換性セクションと仕様書セクションのためにキーを使用します({{Compat}}
と{Specifications}}
マクロを置き換えます)。なお、先にブラウザー互換性データリポジトリーにイベントのエントリーを作成/更新する必要があり、このエントリーに仕様書の情報を入れておくことが必要です。 これを行うためのガイドを参照してください。
ページ先頭のマクロ
コンテンツセクションの上部(ページの先頭部分のすぐ下)には、いくつかのマクロ呼び出しが現れます。 以下のアドバイスに従って、更新または削除してください。
-
{{SeeCompatTable}}
— これは これは実験的な機能です。 のバナーを生成し、この技術が実験的であることを示します。 もし、あなたが文書化している技術が実験的なものでないなら、これを削除すべきです。 実験的なもので、その技術が Firefox の設定で隠されている場合は、 Firefox での実験的な機能 ページにもそのためのエントリーを記入する必要があります。 -
{{Deprecated_Header}}
— これは 非推奨 バナーを生成し、この技術の使用を避けるべきであることを示します。 そうではない場合は、マクロ呼び出すを削除することができます。 -
{{SecureContext_Header}}
— これは 安全なコンテキスト バナーを生成し、この技術が安全なコンテキストでのみ利用できることを示します。 そうではない場合は、マクロ呼び出すを削除することができます。 そうである場合は、安全なコンテキストに制限されている機能ページ内の項目も記入してください。 -
{{APIRef("GroupDataName")}}
— これをクリックすると、現在のページに関連するすばやく参照できるリンクを表示する左側のリファレンスサイドバーが生成されます。 例えば、 WebVR API の中の各ページは同じサイドバーを持ち、そこでこの API の別なページにアクセスできます。 API に適したサイドバーを生成するには、GitHub リポジトリーにGroupData
エントリーを追加し、マクロ呼び出しの中で GroupDataName の代わりにそのエントリーの名前を記載する必要があります。 この方法については、 API リファレンスのサイドバーガイドを参照してください。 - このページをコピーする際には、
{{MDNSidebar}}
マクロを外すのを忘れないでください。
親オブジェクトのリンク
親オブジェクトの「イベント」セクションから、この新しいページへのリンクを追加してください。
例えば Element: wheel イベントは Element
Events からリンクされます。
親オブジェクトに「イベント」セクションがない場合は、追加してください。 これが新しい「クラス」のイベントであれば、イベントリファレンスから親のこの節へのリンクを追加する必要があります。
公開する前に、この説明文全体を削除することを忘れないでください
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。
概要の段落 - まず、イベントの名前、それがどのインターフェイスに属しているか、そしてそれが何をするものなのかを述べます。 これはできれば 1、2 の短い文にすべきです。 対応する API リファレンスページのプロパティの概要から、この大部分をコピーすることができます。
構文
このイベント名を addEventListener()
のようなメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
js
addEventListener("NameOfTheEvent", (event) => {});
onNameOfTheEvent = (event) => {};
イベント型
イベントが特殊な型で ある場合、その継承性についても言及してください。そうでない場合は、一般的なイベントであることを示します。
一般的な Event
です。
または、例えば、
XRSessionEvent
(en-US) です。 Event
から継承しています。
イベントのプロパティ
イベントが単なる一般的な Event
でない場合、そのイベントが持つ追加のプロパティを挙げてください。
以下の一覧のプロパティに加え、親インターフェースである Event
のプロパティも使用可能です。
session
(en-US) 読取専用-
このイベントが参照する
XRSession
(en-US) です。
解説
(概要には長すぎて)追加のテキストを提供したい場合、解説セクションを追加してください。 追加の情報を提供するために、
イベントの発生
および
用途
のヘッダーを入れることができます。
例
ページ内に例が 1 つしかない場合でも、複数形の "Examples" を使用することに留意してください。
説明的な見出し
それぞれの例には、その例を説明する H3 見出し (###
) がなければなりません。見出しは例が何を行っているかを説明するものであるべきです。例えば、「単純な例」というのは例について何も説明していないので、良い見出しとは言えません。見出しは簡潔であるべきです。より詳しい説明をする場合は、見出しの後の段落を使用してください。
詳しくは、コード例を追加する方法のガイドをご覧ください。
メモ: 他のページで紹介されている例にリンクしたい場合もあるでしょう。
シナリオ 1: このページにいくつかの例があり、別のページにさらにいくつかの例がある場合。
このページのそれぞれの例に H3 見出し (###
) を記載し、最後に H3 見出し (###
) に「その他の例」というテキストを入れ、その下に他のページの例へのリンクを貼ることができます。例えば次のようにします。
md
## 例
### Fetch API の使用
Fetch の例
### その他の例
他のページにある他の例へのリンク
シナリオ 2: このページには何も例がなく、他のページにだけある場合。
H3 の見出しは追加せず、 H2 の見出し「例」の下に直接リンクを追加してください。例えば次のようにします。
md
## 例
この API の例については、[fetch() のページ](https://example.org)を参照してください。
仕様書
No specification found
No specification data found for path.to.feature.NameOfTheEvent_event
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- この API に関連する
- 有用と思われるリンクの
- リストを記載してください