WordPress自定义Walker_Nav_Menu仅显示顶级链接失败问题

核心原因 #

你只在start_el方法里判断了$depth === 0，但没阻止WordPress Walker类的递归遍历逻辑。默认情况下，Walker会通过display_element方法递归处理所有子菜单元素，即使你在start_el里跳过非顶级项，子元素依然会被传入start_el执行，最终导致子链接被输出。

另外，可能你的start_el逻辑存在漏洞：比如只写了if ($depth === 0)时的输出代码，但没有明确在depth > 0时直接返回，导致后续代码（如果有的话）依然会处理子元素。

正确的自定义Walker实现 #

要彻底只显示顶级菜单，需要同时重写display_element（阻止递归）和start_el/end_el（控制输出）：

class simple_header extends Walker_Nav_Menu {
    // 处理菜单元素开始标签
    public function start_el( &$output, $item, $depth = 0, $args = null, $id = 0 ) {
        // 非顶级菜单直接跳过
        if ( $depth !== 0 ) return;

        $active_class = $item->current ? ' header__nav-menu-li--active' : '';
        $output .= '<li class="header__nav-menu-li' . $active_class . '">';

        $link_active_class = $item->current ? ' link-header--active' : '';
        $output .= sprintf(
            '<a href="%s" class="header__nav-menu-anchor link-header%s">%s</a>',
            esc_url( $item->url ),
            $link_active_class,
            esc_html( $item->title )
        );
    }

    // 处理菜单元素结束标签
    public function end_el( &$output, $item, $depth = 0, $args = null ) {
        // 仅顶级菜单闭合li标签
        if ( $depth === 0 ) {
            $output .= '</li>';
        }
    }

    // 重写递归逻辑，只处理顶级元素
    public function display_element( $element, &$children_elements, $max_depth, $depth, $args, &$output ) {
        // 将max_depth设为0，阻止遍历子元素
        if ( $depth === 0 ) {
            parent::display_element( $element, $children_elements, 0, $depth, $args, $output );
        }
    }
}

额外注意 #

调用wp_nav_menu时，确保正确传入自定义Walker，同时可以显式设置depth参数强化限制：

wp_nav_menu( array(
    'theme_location' => '你的菜单位置',
    'walker' => new simple_header(),
    'depth' => 0,
    'container' => false, // 根据你的需求调整容器
) );

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