15.3.2. 自定义导航菜单

要自定义导航菜单的内容,使用menu元素及其item子元素。menu元素为左边的导航菜单添加一个小节。每个item元素会被渲染成菜单中的一个链接。

Example 15.3. 在站点描述符中创建菜单项

<project name="Sample Project">
  ...
  <body>

    <menu name="Sample Project">
      <item name="Introduction" href="index.html"/>
      <item name="News" href="news.html"/>
      <item name="Features" href="features.html"/>
      <item name="Installation" href="installation.html"/>
      <item name="Configuration" href="configuration.html"/>
      <item name="FAQ" href="faq.html"/>
    </menu>
    ...
  </body>
</project>


菜单项可以嵌套。如果嵌套了菜单项,你就会在导航菜单中创建一个折叠菜单。下述例子添加了一个指向/developer/index.html的"Developer Resources"链接。当用户查看这个Developer Resources页面的时候,其下的菜单项会被展开。

Example 15.4. 站点菜单添加链接

<project name="Sample Project">
  ...
  <body>
    ...
    <menu name="Sample Project">
      ...
      <item name="Developer Resources" href="/developer/index.html" collapse="true">
        <item name="System Architecture" href="/developer/architecture.html"/>
        <item name="Embedder's Guide" href="/developer/embedding.html"/>
      </item>
    </menu>
    ...
  </body>
</project>


当一个菜单项的collapse属性被设置成true的时候,Maven会折叠该菜单项,直至用户浏览了该特定页面。在前面的例子中,如果用户不查看Developer Resources页面,Maven就不会显示System Architecture和Embedder's Guide链接;它只会显示一个指向 Developer Resources链接的箭头。当用户查看Developer Resources页面的时候,其包含的链接会被打开,箭头变成朝下方向。