このページには MDN で使うために作られた汎用のマクロがたくさん掲載されています。これらのマクロの使い方については、 マクロの使い方 と リンクを生成するマクロ を見てください。 その他のマクロ には、めったに使われないマクロ、特殊な文脈でのみ使われるマクロ、使用が推奨されないマクロについての情報が書かれています。また、MDNで使用できるマクロの完全な一覧もあります。
CSS スタイルガイドも見てください。
リンク
単一のハイパーリンクを作成する
一般的に、単なるリンクを作成するためにマクロを使う必要はありません。エディターインターフェイスにある リンク ボタンを使えば、リンクを作成できます。
Glossary
マクロは MDN 用語集の中の指定した用語のエントリへのリンクを作成するのに使います。このマクロは、1つの必須の引数または2つの任意の引数を受け付けます。例:
- 用語の名前 (例えば "HTML")
- 用語の名前の代わりに記事内に表示するテキスト (これはあまり使用するべきではありません)。 Optional
- この引数が指定されており 0 以外である場合、用語集へのリンクに使われるカスタムスタイルが適用されません。Optional
{{Glossary("HTML")}}
の表示は HTML となり、{{Glossary("CSS", "カスケーディングスタイルシート")}}
の表示は カスケーディングスタイルシート となり、{{Glossary("HTML", "", 1)}}
の表示は HTML となります。
anch
- ページ内の節へのリンクを生成{{anch("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
になります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 レスポンスステータスコードにリンクします。
バグへのリンク
複数のページからなるガイドのためのナビゲーション補助
Previous
、Next
、PreviousNext
は、一連の記事の中でのナビゲーションコントロールを提供します。一方向用のテンプレートでは、 前の または 次の 記事の Wiki 位置を指す1つの引数が必要です。PreviousNext
については、前の記事、次の記事を指す 2つの引数を取ります。最初の引数が前の記事を指し、2番めの引数が次の記事を指します。
コードのサンプル
Live サンプル
EmbedLiveSample
はコードサンプルの出力をページに埋め込むのに使います。解説は Live サンプルのページにありますLiveSampleLink
はコードサンプルの出力を含むページへのリンクを作成します。解説は Live サンプルのページにあります
サイドバーの生成
ほぼすべての大きなページの集まりについて、雛形があります。典型的には、リファレンス、ガイド、チュートリアルでメインページに戻るためのリンク (パンくずリストではできないことがある) を提供し、記事を適切なカテゴリに配置します。
汎用の書式
API 文書のためのインラインインジケーター
optional_inline
と ReadOnlyInline
は API 文書の中で通常、オブジェクトのプロパティまたは関数の引数のリストを記述するのに使われます。
用法: {{optional_inline()}}
または {{ReadOnlyInline}}
. 例:
isCustomObject
読取専用true
の場合、オブジェクトはカスタムオブジェクトであることを示します。parameterX
Optional- ごにょごにょごにょ...
状態と互換性についての表示
インラインインジケーター (追加引数なし)
標準外のもの
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}}
deprecated_header
:{{Deprecated_Header}}
非推奨
この機能はウェブ標準から削除されました。まだ対応しているプラウザーがあるかもしれませんが、ゆくゆくはなくなるものです。使用を避け、できれば既存のコードを更新してください。このページの下部にあるブラウザーの対応を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。deprecated_header
with parameter:{{Deprecated_Header("gecko5")}}
非推奨 Gecko 5 (Firefox 5 / Thunderbird 5 / SeaMonkey 2.2)
この機能はウェブ標準から削除されました。まだ対応しているプラウザーがあるかもしれませんが、ゆくゆくはなくなるものです。使用を避け、できれば既存のコードを更新してください。このページの下部にあるブラウザーの対応を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。obsolete_header
:{{Obsolete_Header}}
廃止
この機能は廃止されました。まだいくつかのブラウザーで動作するかもしれませんが、いつ削除されてもおかしくないので、使わないようにしましょう。obsolete_header
with parameter:{{Obsolete_Header("gecko30")}}
ブラウザーに依存しない領域 (HTML、API、JS、CSS など) でこの引数を使用しないでくださいGecko 30 で廃止 (Firefox 30 / Thunderbird 30 / SeaMonkey 2.27 / Firefox OS 1.4)
この機能は廃止されました。まだいくつかのブラウザーで動作するかもしれませんが、いつ削除されてもおかしくないので、使わないようにしましょう。secureContext_header
:{{SecureContext_Header}}
安全なコンテキスト用
この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
ウェブワーカーで使用できる機能であることを示す
AvailableInWorkers
マクロは、その機能がウェブワーカーのコンテキストで有効であることを示すためのローカライズされた注記ボックスを挿入するのに使われます。