侧边栏
MDN 支持在页面中添加侧边栏;这些框是包含到 MDN 上的其他页面或站外页面链接的可分层列表。本文描述了如何创建侧边栏。
侧边栏语法
页面的侧边栏是通过创建一个 ID 为“Quick_links”的 <section>
块来提供的。然后,将要放入侧边栏框中的内容放在 section 内。这些链接需要格式化为 <ol>
有序列表(可以嵌套)。你可以通过使用编辑器工具栏中的编号列表按钮来实现这一点。例如,你的侧边栏 HTML 可能如下所示:
html
<section id="Quick_links">
<ol>
<li><a href="http://docs.ckeditor.com/">CKEditor 文档站点</a></li>
<li>
<a href="http://mxr.mozilla.org/">MXR:Mozilla 源代码交叉引用</a>
</li>
<li class="toggle">
<details>
<summary>风格指南</summary>
<ol>
<li>
<a href="http://www.economist.com/research/StyleGuide/"
>经济学人风格指南</a
>
</li>
<li>
<a href="https://www.amazon.com/gp/product/0226104036/"
>芝加哥风格手册</a
>
</li>
<li>
<a href="http://www.answers.com/library/Dictionary"
>Answers.com 字典</a
>
</li>
<li>
<a href="http://www.wsu.edu/~brians/errors/">英语中的常见错误</a>
</li>
</ol>
</details>
</li>
</ol>
</section>
需要注意的重要事项:
使用宏创建侧边栏
值得注意的是,你可以(而且通常应该)使用宏来生成侧边栏。每当你需要在多个页面上使用相同的侧边栏集时,你都应该将它们转换为宏。
你的宏可以是简单或复杂的(若有必要);它需要输出类似于上面的侧边栏语法中所示的 HTML。
标准侧边栏宏
这里列出了我们用于生成侧边栏的标准宏。
CSSRef
-
生成 CSS 参考页面的标准侧边栏。
-
生成 HTML 参考页面的标准侧边栏。
QuickLinksWithSubpages
-
使用当前页面(或指定页面)的子页面作为目标创建一组侧边栏。这将创建最多两层的分层列表。页面的标题将被用作链接文本,摘要则被用作提示。