クイックリンク

MDN はページへのクイックリンクの追加をサポートしています。つまり、これらはMDN内外のページへのリンクの階層リストを含むこともあるボックスです。この記事ではクイックリンクボックスの生成法を記します。

ページには、左側のサイドバーに表示されるクイックリンクボックスが1つしかない場合があります。 このサイドバーは、オプションで、サイドバーの上部にある「このサイドバーを隠す」リンクをクリックすることで、ユーザーが非表示にすることができます。

クイックリンクの文法

ページのクイックリンクは、ID "Quick_Links" を持つ<section>ブロックを作成することによって提供されます。 次に、セクション内のクイックリンクボックスに入るコンテンツを配置します。 これらは<ol>順序付きリスト(任意にネストされたもの)としてフォーマットする必要があります。 これは、エディタツールバーの番号付きリストボタンを使用して行うことができます。 たとえば、このページには、いくつかの便利なページにつながるクイックリンクボックスがあります。 そのHTMLは次のようになります。

<section id="Quick_Links">
  <ol>
    <li><a href="http://docs.ckeditor.com/">CKEditor documentation site</a></li>
    <li><a href="http://mxr.mozilla.org/">MXR: Mozilla source cross-reference</a></li>
    <li><a href="#">Style guides</a>
      <ol>
        <li><a href="http://www.economist.com/research/StyleGuide/">The Economist style guide</a></li>
        <li><a href="http://www.amazon.com/gp/product/0226104036/">The Chicago manual of style</a></li>
        <li><a href="http://www.answers.com/library/Dictionary">Answers.com dictionary</a></li>
        <li><a href="http://www.wsu.edu/~brians/errors/">Common Errors in English</a></li>
      </ol>
    </li>
  </ol>
</section>

注目すべき重要事項:

  • リストは順序付きリストでなければなりません。 順序なしリストは正しく機能しません
  • ネストされたリストは、そのフォルダのリンクである名前を指定した後、同じ<li>ブロックの別の順序付きリストをフォルダのタイトルリンクとして指定することができます。

クイックリンクを生成するマクロを使用する

クイックリンクを生成するには、マクロを使用する必要があります。 複数のページで同じクイックリンクを使用する必要がある場合は、マクロに変換する必要があります。 たとえば、このページでは、EditorGuideQuicklinksマクロを使用してクイックリンクボックスを作成します。 MDNエディタガイドの他のすべてのページも同様です。

あなたのマクロは、必要に応じて単純なものでも複雑なものでもかまいません。 上記のQuicklinks の文法と同様のHTMLを出力するだけです。

標準クイックリンクマクロ

ここにクイックリンクを生成する私たちの標準マクロがあります。

CSSRef
CSSリファレンスページの標準クイックリンクを作成します。
HTMLRef
HTMLリファレンスページの標準クイックリンクを作成します。
MakeSimpleQuicklinks
MDN上のページのリストが与えられた場合、このマクロは、ページのタイトルをリンクテキストとして使用し、その概要をツールチップとして使用するクイックリンクボックスを作成します。 これは階層リストを作成しません。
QuickLinksWithSubpages
現在のページ(または指定したページ)の子を宛先として使用して、クイックリンクのセットを作成します。 これにより、最大2レベルの階層リストが作成されます。 ページのタイトルをリンクテキストとして使用し、その概要をツールチップとして表示します。

ドキュメントのタグと貢献者

このページの貢献者: Wind1808, wbamberg, Uemmra3
最終更新者: Wind1808,