如何为WordPress的wp_nav_menu()函数添加dropdown类至<li>标签

我有如下静态导航菜单结构，其中带下拉菜单的<li>标签需要添加dropdown类来实现下拉效果：

<ul>
<li>
<a href="#hero">Home</a></li>
      <li><a href="blog.html">Blog</a></li>
      <li class="dropdown"><a href="#"><span>Drop Down</span> <i class="bi bi-chevron-down dropdown-indicator"></i></a>
        <ul>
          <li><a href="#">Drop Down 1</a></li>
          <li class="dropdown"><a href="#"><span>Deep Drop Down</span> <i class="bi bi-chevron-down dropdown-indicator"></i></a>
            <ul>
              <li><a href="#">Deep Drop Down 1</a></li>
            </ul>
          </li>
          <li><a href="#">Drop Down 2</a></li>
        </ul>
      </li>
</ul>

目前我使用WordPress的wp_nav_menu()函数调用名为main-menu的动态导航菜单，代码如下：

<?php
if ( has_nav_menu( 'main-menu' ) ) :
    wp_nav_menu( array(
        'theme_location' => 'main-menu',
        'items_wrap'     => '%3$s',
        'add_li_class'   => '',
        'container' => ''
    ));
endif;
?>

请问怎么修改这个函数，让包含子菜单的<li>自动加上dropdown类，实现和静态菜单一致的下拉效果？

解决方案 #

要实现这个效果，你需要自定义一个菜单遍历器（Walker）类，通过它判断菜单项是否包含子菜单，给对应的<li>标签添加dropdown类，同时同步处理下拉箭头的输出。

1. 添加自定义Walker类到主题functions.php #

打开主题的functions.php文件，加入以下代码：

class Custom_Nav_Walker extends Walker_Nav_Menu {
    // 输出单个菜单项的<li>标签
    function start_el(&$output, $item, $depth = 0, $args = null, $id = 0) {
        $classes = empty( $item->classes ) ? array() : (array) $item->classes;
        
        // 给有子菜单的菜单项追加dropdown类
        if (in_array('menu-item-has-children', $item->classes)) {
            $classes[] = 'dropdown';
        }
        
        $class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item, $args, $depth ) );
        $class_names = $class_names ? ' class="' . esc_attr( $class_names ) . '"' : '';
        
        $output .= "<li$class_names>";
        
        $atts = array();
        $atts['href'] = ! empty( $item->url ) ? $item->url : '';
        $atts['title'] = ! empty( $item->title ) ? $item->title : '';
        
        // 拼接菜单项HTML，给有子菜单的项添加下拉箭头
        $item_output = $args->before;
        $item_output .= '<a' . $this->attributes( $atts ) . '>';
        $item_output .= $args->link_before . apply_filters( 'the_title', $item->title, $item->ID ) . $args->link_after;
        
        if (in_array('menu-item-has-children', $item->classes)) {
            $item_output .= ' <span>' . $item->title . '</span> <i class="bi bi-chevron-down dropdown-indicator"></i>';
        }
        
        $item_output .= '</a>';
        $item_output .= $args->after;
        
        $output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args );
    }
}

2. 修改wp_nav_menu的调用代码 #

把原来的调用代码替换为以下版本，启用自定义遍历器：

<?php
if ( has_nav_menu( 'main-menu' ) ) :
    wp_nav_menu( array(
        'theme_location' => 'main-menu',
        'items_wrap'     => '%3$s',
        'container'      => '',
        'walker'         => new Custom_Nav_Walker() // 启用自定义菜单遍历器
    ));
endif;
?>

关键说明 #

• WordPress会自动给带子女菜单的菜单项添加menu-item-has-children类，我们以此为判断依据，给<li>追加dropdown类。
• 如果需要调整下拉箭头的HTML结构，直接修改自定义Walker类中对应代码段即可，确保和静态菜单结构匹配。
• 该方法支持多级下拉菜单，深层子菜单也会自动添加dropdown类。

内容的提问来源于stack exchange，提问作者Roberto Nevilis