wordpress3之wp_nav_menu参数详解

2010年11月19日

wordpress3以后的版本增加了在后台添加导航菜单的功能，需要用到wp_nav_menu函数，最近在制作一个新模板，整理了wp_nav_menu参数详解，备用。

首先，要确认你的模板支持wp_nav_menu函数，如果不支持可以在 functions.php 里添加以下代码：

if (function_exists(‘add_theme_support’)) {
 //开启导航菜单主题支持
 add_theme_support(‘nav-menus’);
 //注册一个导航菜单
 register_nav_menus( array( ‘primary’ => __( ‘Primary Navigation’, ‘primary’ ) ) );
}
//没有在后台设置导航菜单时调用的函数
function the_main_nav() {
?>
 <div id=”menu”>
  <ul id=”nav”>
   <li><a <?php if (is_home()) echo ” class=\”current\”"; ?> href=”<? php bloginfo(‘url’); ?>/”>Home</a></li>
   <?php wp_list_cats(‘style=list’); ?>
  </ul>
 </div>
<?php } ?>

wp_nav_menu参数详解：

$menu_args = array(
//最外层容器的标签名，默认div
‘container’ => ‘div’,
//最外层容器的class名
‘container_class’ => ‘mainNavBlock’,
//最外层容器的id名
‘container_id’ => ‘menu’,
//导航菜单ul标签的class名
‘menu_class’ => ‘mainNav’,
//导航菜单ul标签的id名
‘menu_id’ => “nav”,
//是否打印，默认是true，如果想将导航的代码作为赋值使用，可设置为false
‘echo’ => true,
//备用的导航菜单函数，用于没有在后台设置导航时调用
‘fallback_cb’ => ‘the_main_nav’,
//显示在导航a标签之前
‘before’ => ‘<p>’,
//显示在导航a标签之后
‘after’ => ‘</p>’,
//显示在导航链接名之前
‘link_before’ => ‘<em>’,
//显示在导航链接名之后
‘link_after’ => ‘</em>’,
//显示的菜单层数，默认0，0是显示所有层
‘depth’ => 0,
//调用一个对象定义显示导航菜单
‘walker’ => new Walker_Nav_Menu(),
//指定显示的导航名，如果没有设置，则显示第一个
‘theme_location’ => ‘primary’,
);
//打印导航菜单
wp_nav_menu( $menu_args );

接下来，就可以在模板中使用添加导航菜单的功能了。