在WordPress
3.0中增加了自定义菜单功能,如果你在WordPress后台(外观>菜单)创建一个菜单,你可以在主题中使用wp_nav_menu()
函数来显示这些菜单。但是像图中这种带描述的导航菜单还无法简单实现,本文将教你改变WordPress默认的菜单输出结构,打造个性的导航菜单。
首先我们先看下默认的输出结构:
<ul id="menu-main"> <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> </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 . ‘<li‘ . $id . $value . $class_names .‘>‘; $prepend = ‘<strong>‘; $append = ‘</strong>‘; $description = ! empty( $item->attr_title ) ? ‘<span>‘ . esc_attr( $item->attr_title ) . ‘</span>‘ : ‘‘; 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 .= ‘<a‘. $attributes .‘>‘; $item_output .= $args->link_before . $prepend . apply_filters( ‘the_title‘, $item->title, $item->ID ) . $append; $item_output .= $description . $args->link_after; $item_output .= ‘</a>‘; $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样式,一起来制作个性的导航菜单吧~