要自定义导航菜单的内容,使用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页面的时候,其包含的链接会被打开,箭头变成朝下方向。