改进你的WordPress导航菜单(输出标题描述)

最后更新时间为 2018年7月18日

在WordPress 3.0中增加了自定义菜单功能，如果你在WordPress后台（外观>菜单）创建一个菜单，你可以在主题中使用wp_nav_menu()函数来显示这些菜单。但是像图中这种带描述的导航菜单还无法简单实现，本文将教你改变WordPress默认的菜单输出结构，打造个性的导航菜单。

首先我们先看下默认的输出结构：

<ul id="menu-main">
    <li><a href="#">首页</a></li>
    <li><a href="#">关于</a></li>
    <li><a href="#">联系</a></li>
    <li><a href="#">博客</a></li>
</ul>

默认的结构根本不可能输出我们想要的效果，所以我们需要改变输出的结果：

<ul id="menu-main">
     <li><a href="#"><strong>首页</strong><span>Home</span></a></li>
     <li><a href="#"><strong>关于</strong><span>About</span></a></li>
     <li><a href="#"><strong>联系</strong><span>Contact</span></a></li>
     <li><a href="#"><strong>博客</strong><span>Blog</span></a></li>
</ul>

准备工作

我们要做的第一件事就是到菜单页面，你会发现每个菜单项都有一个“标题属性”，了解网页都知道这是用来显示鼠标移到链接上后的提示性文字，首先把你希望显示的文字先填上~

自定义walker类编辑输出结构

WordPress使用一个特殊的“Walker”类来遍历数据记录并显示出来。幸运的是，我们可以很轻松的创建属于我们自己的“Walker”类从而改变菜单的输出结构。

打开你主题文件中的function.php文件，并添加如下代码：

class description_walker extends Walker_Nav_Menu {
    function start_el(&$output, $item, $depth, $args) {
        global $wp_query;
        $indent = ( $depth ) ? str_repeat( "\t", $depth ) : '';
    
        $class_names = $value = '';
    
        $classes = empty( $item->classes ) ? array() : (array) $item->classes;
        $classes[] = 'menu-item-' . $item->ID;
    
        $class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item, $args ) );
        $class_names = ' class="' . esc_attr( $class_names ) . '"';
    
        $id = apply_filters( 'nav_menu_item_id', 'menu-item-'. $item->ID, $item, $args );
        $id = strlen( $id ) ? ' id="' . esc_attr( $id ) . '"' : '';
    
        $output .= $indent . '';
        
        $prepend = '';
        $append = '';
        $description  = ! empty( $item->attr_title ) ? '' . esc_attr( $item->attr_title ) . '' : '';

        if($depth != 0) {
            $description = $append = $prepend = "";
            $attributes  = ! empty( $item->attr_title ) ? ' title="'  . esc_attr( $item->attr_title ) .'"' : '';
        }
        $attributes .= ! empty( $item->target )     ? ' target="' . esc_attr( $item->target     ) .'"' : '';
        $attributes .= ! empty( $item->xfn )        ? ' rel="'    . esc_attr( $item->xfn        ) .'"' : '';
        $attributes .= ! empty( $item->url )        ? ' href="'   . esc_attr( $item->url        ) .'"' : '';
    
        $item_output = $args->before;
        $item_output .= '';
        $item_output .= $args->link_before . $prepend . apply_filters( 'the_title', $item->title, $item->ID ) . $append;
        $item_output .= $description . $args->link_after;
        $item_output .= '';
        $item_output .= $args->after;
    
        $output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args );
    }
}

那么这个类做了什么呢？这个类在WordPress默认的walker代码（位于wp-includes/nav-menu-template.php）基础上添加了几行代码。现在这个walker会检测是否是顶级菜单，如果是就会输出带有描述的菜单结构。

添加回调函数

现在我们创建了一个自定义的walker类，我们还要做的就是告诉WordPress去使用我们的walker替代默认的。这步非常简单，只要为 wp_nav_menu() 添加walker参数即可：

<?php wp_nav_menu( array('walker' => new description_walker())); ?>

好了，最后为你的菜单添加CSS样式，一起来制作个性的导航菜单吧~