普通的Wordpress菜单如下所示:


博客|关于我们|联系方式


但是我在这些链接下看到了很多带有说明的页面:


我们的博客|关于我们
|联系
....认识我们... |阅读更多|基本信息|联系表格


如何实现?

(我希望它成为我所有主题的核心功能,所以请没有插件,我只想知道如何完成)

#1 楼

导航菜单需要一个自定义的walker。

基本上,您可以在'walker'选项中添加参数wp_nav_menu()并调用增强类的实例:

wp_nav_menu(
    array (
        'menu'            => 'main-menu',
        'container'       => FALSE,
        'container_id'    => FALSE,
        'menu_class'      => '',
        'menu_id'         => FALSE,
        'depth'           => 1,
        'walker'          => new Description_Walker
    )
);


Description_Walker扩展了Walker_Nav_Menu并更改了函数start_el( &$output, $item, $depth, $args )以查找$item->description

一个基本示例: ,也可以按照@nevvermind的评论,继承父对象start_el函数的所有功能,然后将描述附加到$output

/**
 * Create HTML list of nav menu items.
 * Replacement for the native Walker, using the description.
 *
 * @see    https://wordpress.stackexchange.com/q/14037/
 * @author fuxia
 */
class Description_Walker extends Walker_Nav_Menu
{
    /**
     * Start the element output.
     *
     * @param  string $output Passed by reference. Used to append additional content.
     * @param  object $item   Menu item data object.
     * @param  int $depth     Depth of menu item. May be used for padding.
     * @param  array|object $args    Additional strings. Actually always an 
                                     instance of stdClass. But this is WordPress.
     * @return void
     */
    function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 )
    {
        $classes     = empty ( $item->classes ) ? array () : (array) $item->classes;

        $class_names = join(
            ' '
        ,   apply_filters(
                'nav_menu_css_class'
            ,   array_filter( $classes ), $item
            )
        );

        ! empty ( $class_names )
            and $class_names = ' class="'. esc_attr( $class_names ) . '"';

        $output .= "<li id='menu-item-$item->ID' $class_names>";

        $attributes  = '';

        ! empty( $item->attr_title )
            and $attributes .= ' title="'  . esc_attr( $item->attr_title ) .'"';
        ! empty( $item->target )
            and $attributes .= ' target="' . esc_attr( $item->target     ) .'"';
        ! empty( $item->xfn )
            and $attributes .= ' rel="'    . esc_attr( $item->xfn        ) .'"';
        ! empty( $item->url )
            and $attributes .= ' href="'   . esc_attr( $item->url        ) .'"';

        // insert description for top level elements only
        // you may change this
        $description = ( ! empty ( $item->description ) and 0 == $depth )
            ? '<small class="nav_desc">' . esc_attr( $item->description ) . '</small>' : '';

        $title = apply_filters( 'the_title', $item->title, $item->ID );

        $item_output = $args->before
            . "<a $attributes>"
            . $args->link_before
            . $title
            . '</a> '
            . $args->link_after
            . $description
            . $args->after;

        // Since $output is called by reference we don't need to return anything.
        $output .= apply_filters(
            'walker_nav_menu_start_el'
        ,   $item_output
        ,   $item
        ,   $depth
        ,   $args
        );
    }
}


示例输出:


现在启用wp-admin/nav-menus.php中的description字段即可编辑此字段。如果您不喜欢WP,请直接将完整的帖子内容丢进去。



进一步阅读:


相关的错误
具有不同标记和格式的类似示例
启用菜单管理屏幕中的描述框以编程方式
收集项目描述以供以后使用

就这样。

评论


如果对您的继承!=重写整个方法,则保持相同的名称,请尝试以下操作:公共函数start_el(&$ output,$ item,$ depth,$ args){parent :: start_el($ output,$ item,$深度,$ args); $ output。= sprintf('%s ',esc_html($ item-> description)); }

–nevvermind
2011-12-14 13:15



@nevvermind您至少应检查说明中是否包含某些内容。 ;)在示例代码中,描述的位置只是说明解决方案的最简单方法。如果需要使描述成为锚点,则必须重新构建整个功能。

– fuxia♦
2011-12-16在10:38

是的,毫无疑问,您必须编写整个方法,但是对于需要(例如...)附加该方法的人来说,这可能会节省很多头痛。这都是WP的错。啊!

–nevvermind
2011-12-16 14:47

很好,我在此答案中使用了一些修改,可能是如果我错过了一些东西可以使它变得更好,谢谢。

– Alpha
2012年8月28日14:24



我实际上需要的是wp_nav_menu,但是我需要更改“ container_class”参数以适合我的特定用例,在某些情况下,我在某种情况下将主菜单换成了另一个菜单,但是需要使类与CSS保持一致。

– D. Dan
18年1月25日在15:15

#2 楼

从WordPress 3.0开始,您不再需要自定义的Walker!
walker_nav_menu_start_el过滤器,请参见https://developer.wordpress.org/reference/hooks/walker_nav_menu_start_el/
示例:
 function add_description_to_menu($item_output, $item, $depth, $args) {

   if (strlen($item->description) > 0 ) {
      // append description after link
      $item_output .= sprintf('<span class="description">%s</span>', esc_html($item->description));
    
      // or.. insert description as last item inside the link ($item_output ends with "</a>{$args->after}")
      // $item_output = substr($item_output, 0, -strlen("</a>{$args->after}")) . sprintf('<span class="description">%s</span >', esc_html($item->description)) . "</a>{$args->after}";
   }   
   return $item_output;
}
add_filter('walker_nav_menu_start_el', 'add_description_to_menu', 10, 4);
 


评论


真好!我使用的是@toscho的nav walker解决方案,但这更干净,更易于维护,这应该是公认的答案,更好的做法。

–罗纳德
15年7月8日在10:29

#3 楼

这并不比其他建议好或坏。只是不同而已。

与其使用@toscho建议的描述字段,还可以在每个菜单项的“标题”字段中填写所需的文本,然后使用此CSS:

.menu-item a:after { content: attr(title); }

使用jQuery附加它也很容易,但是文本具有观赏性,以至于CSS似乎很合适。

#4 楼

您还可以在菜单中的导航标签之后编写一个<span>元素,并使用以下CSS规则更改其display设置(默认情况下为inline):

span {display:block}


评论


嗯,这是一个简单易用的解决方案,但是如果您将跨度设置为阻塞,为什么还要使用跨度呢? xhtml / html4不允许链接中包含块元素,但是html5允许,因此只需使用div,而无需任何CSS!

–詹姆斯·米奇(James Mitch)
13年5月5日在21:02