よく使われるマクロ

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

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

リンク

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

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

    例:

    1. 用語の名前 (例えば "HTML")
    2. 用語の名前の代わりに記事内に表示するテキスト (これはあまり使用するべきではありません)。 Optional
    3. この引数が指定されており 0 以外である場合、用語集へのリンクに使われるカスタムスタイルが適用されません。Optional
  • anch - ページ内の節へのリンクを生成

リファレンス内のページへのリンク

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

  • cssxref は、CSS リファレンスのページにリンクします。
    例: {{CSSxRef("cursor")}} の結果は cursor になります
  • domxref は DOM リファレンス内のページにリンクします。最後にカッコを入れると、関数名のようにリンクが表示されます。たとえば、{{DOMxRef("document.getElementsByName()")}} は document.getElementsByName() になります。{{DOMxRef("Node")}} は Node になります
  • event は DOM イベントリファレンスのページにリンクします。たとえば、{{Event("change")}} は change になります
  • 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番めの引数が次の記事を指します。

コードのサンプル

Live サンプル

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

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

汎用の書式

API 文書のためのインラインインジケーター

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

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

isCustomObject読取専用
true の場合、オブジェクトはカスタムオブジェクトであることを示します。
parameterXOptional
ごにょごにょごにょ...

状態と互換性についての表示

インラインインジケーター (追加引数なし)

標準外のもの

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")}}

例

テンプレートバッジ

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

ページまたはセクションのヘッダーを示すインジケーター

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

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

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

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

    これは実験的な機能です。本番で使用する前にブラウザー実装状況をチェックしてください。

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

註: この機能は Web Workers 内で利用可能です。