よく使われるマクロ

このページには MDN で使うために作られた汎用のマクロがたくさん掲載されています。これらのマクロの使い方については、 マクロの使い方 と リンクを生成するマクロ を見てください。 その他のマクロ (en-US) には、めったに使われないマクロ、特殊な文脈でのみ使われるマクロ、使用が推奨されないマクロについての情報が書かれています。また、MDNで使用できるマクロの完全な一覧もあります。

CSS スタイルガイドも見てください。

一般的に、単なるリンクを作成するためにマクロを使う必要はありません。エディターインターフェイスにある リンク ボタンを使えば、リンクを作成できます。

• Glossary マクロは MDN 用語集の中の指定した用語のエントリへのリンクを作成するのに使います。このマクロは、1つの必須の引数または2つの任意の引数を受け付けます。

  例:

  1. 用語の名前 (例えば "HTML")
  2. 用語の名前の代わりに記事内に表示するテキスト (これはあまり使用するべきではありません)。 省略可
  3. この引数が指定されており 0 以外である場合、用語集へのリンクに使われるカスタムスタイルが適用されません。省略可
  • {{Glossary("HTML")}} の表示は HTML となり、
  • {{Glossary("CSS", "カスケーディングスタイルシート")}} の表示は カスケーディングスタイルシート となり、
  • {{Glossary("HTML", "", 1)}} の表示は HTML となります。
• anch - ページ内の節へのリンクを生成
  • {{anch("Linking to pages in references")}}

  • デモ: Linking to pages in references

いろいろなマクロがあり、MDN の指定したリファレンスエリア内のページへのリンクを作成することができます。

• cssxref は、CSS リファレンスのページにリンクします。
  例: {{CSSxRef("cursor")}} の結果は cursor になります
• domxref は DOM リファレンス内のページにリンクします。最後にカッコを入れると、関数名のようにリンクが表示されます。たとえば、{{DOMxRef("document.getElementsByName()")}} は document.getElementsByName() になります。{{DOMxRef("Node")}} は Node になります
• event は DOM イベントリファレンスのページにリンクします。たとえば、{{Event("change")}} は change (en-US) になります
• HTMLElement は HTML リファレンスの HTML 要素にリンクします
• htmlattrxref は HTML 属性にリンクします。属性のみを指定する場合はグローバル属性の、属性名と要素名を指定する場合は特定の要素に関連付けられた属性の説明にリンクします。たとえば、{{HTMLAttrxRef("lang")}} は lang のリンクを生成します。{{HTMLAttrxRef("type","input")}} は type のリンクを生成します。
• jsxref は JavaScript リファレンスのページにリンクします。
• SVGAttr は特定の SVG 属性にリンクします。たとえば、{{SVGAttr("d")}} は d のリンクを生成します。
• SVGElement は SVG リファレンスの SVG 要素にリンクします。
• HTTPHeader は HTTP ヘッダーにリンクします。
• HTTPMethod は HTTP リクエストメソッドにリンクします。
• HTTPStatus は HTTP レスポンスステータスコードにリンクします。

• バグ
  • bug を使うと、 bugzilla.mozilla.org に登録されているバグへのリンクを簡単に作ることができます。文法は {{Bug(123456)}} です。 バグ 123456 のようなリンクになります。
  • WebkitBug は WebKit バグのデータベースへのリンクを挿入します。例えば {{WebkitBug(31277)}} は {WebkitBug(31277)}} のようになります。

Previous、Next、PreviousNext は、一連の記事の中でのナビゲーションコントロールを提供します。一方向用のテンプレートでは、 前の または 次の 記事の Wiki 位置を指す1つの引数が必要です。PreviousNext については、前の記事、次の記事を指す 2つの引数を取ります。最初の引数が前の記事を指し、2番めの引数が次の記事を指します。

• EmbedLiveSample はコードサンプルの出力をページに埋め込むのに使います。解説は Live サンプルのページにあります
• LiveSampleLink はコードサンプルの出力を含むページへのリンクを作成します。解説は Live サンプルのページにあります

ほぼすべての大きなページの集まりについて、雛形があります。典型的には、リファレンス、ガイド、チュートリアルでメインページに戻るためのリンク (パンくずリストではできないことがある) を提供し、記事を適切なカテゴリに配置します。

• CSSRef は CSS リファレンスページのサイドバーを生成します
• HTMLRef は HTML リファレンスページのサイドバーを生成します
• APIRef は Web API リファレンスページのサイドバーを生成します

optional_inline と ReadOnlyInline は API 文書の中で通常、オブジェクトのプロパティまたは関数の引数のリストを記述するのに使われます。

用法: {{optional_inline()}} または {{ReadOnlyInline}}. 例:

isCustomObject読取専用

true の場合、オブジェクトはカスタムオブジェクトであることを示します。

parameterX省略可

ごにょごにょごにょ...

標準外のもの

non-standard_inline は、その API が標準化されておらず、また標準化の予定もないことを示すインラインマークを付けます。

構文

{{Non-standard_Inline}}

例

• アイコン:

実験的なもの

experimental_inline は、その API が広く実装されておらず、また将来変更される可能性があることを示すインラインマークを付けます。

構文

{{Experimental_Inline}}

例

• アイコン:

これらのマクロにパラメータを指定する場合は、"html", "js", "css", "gecko",のうちの1つにバージョン番号を加えたものとなります。

非推奨のもの

deprecated_inline はインラインの非推奨(deprecated) マークを付け、その API が公式には非推奨であり、使用を控えるべきであることを示します。注: 非推奨 (deprecated) が意味するのは、その項目はもう使用されるべきではないが、まだ機能するものであることです。もう機能しないものを示す用語としては、廃止 (obsolete) を使ってください。

ブラウザー特有の記述 (HTML, API, JS, CSS, …) では、引数を使用しないでください。

構文

{{Deprecated_Inline}} または {{Deprecated_Inline("gecko5")}}

例

• アイコン:
• バッジ: 非推奨 Gecko 5

廃止

obsolete_inline はインラインの廃止 (obsolete) マークを付け、例えばその関数、メソッド、またはプロパティ等を使用してはいけないことを示します。

ブラウザー特有の記述 (HTML, API, JS, CSS, …) では、引数を使用しないでください。

構文

{{Obsolete_Inline}} または {{Obsolete_Inline("js1.8.5")}}

例

• アイコン:
• バッジ: JavaScript 1.8.5 で廃止

これらのマクロはほとんど WebAPI ページで使われます。Creating new badges に新しいバッジを作成するための情報があります。

これらのテンプレートが示すのは、上記の対応するインラインマークと同じものです。テンプレートはリファレンスページのメインページタイトルの (または、パンくずリストがあるならばその) 直下に置きます。ページ内のセクションをマークアップすることもできます。

• non-standard_header: {{Non-standard_Header}}

  非標準

  この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。

• 実験的な機能を説明するページでは SeeCompatTable を使用する必要があります。例: {{SeeCompatTable}}

  Experimental

  これは実験的な機能です。
  本番で使用する前にブラウザー互換性一覧表をチェックしてください。

• deprecated_header: {{Deprecated_Header}}

  非推奨

  この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

• deprecated_header with parameter: {{Deprecated_Header("gecko5")}}

  非推奨 Gecko 5 (Firefox 5 / Thunderbird 5 / SeaMonkey 2.2)

  この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

  ブラウザーに依存しない領域 (HTML、API、JS、CSS など) でこの引数を使用しないでください
• obsolete_header: {{Obsolete_Header}}

  廃止

  この機能は廃止されました。まだいくつかのブラウザーで動作するかもしれませんが、いつ削除されてもおかしくないので、使わないようにしましょう。

• obsolete_header with parameter: {{Obsolete_Header("gecko30")}}

  Gecko 30 で廃止 (Firefox 30 / Thunderbird 30 / SeaMonkey 2.27 / Firefox OS 1.4)

  この機能は廃止されました。まだいくつかのブラウザーで動作するかもしれませんが、いつ削除されてもおかしくないので、使わないようにしましょう。

  ブラウザーに依存しない領域 (HTML、API、JS、CSS など) でこの引数を使用しないでください
• secureContext_header: {{SecureContext_Header}}

  安全なコンテキスト用

  この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

AvailableInWorkers マクロは、その機能がウェブワーカーのコンテキストで有効であることを示すためのローカライズされた注記ボックスを挿入するのに使われます。