钩子文档

nav_menu_submenu_css_class

💡 云策文档标注

概述

nav_menu_submenu_css_class 是一个 WordPress 过滤器,用于修改应用于菜单列表元素的 CSS 类。它允许开发者在生成导航菜单子菜单时动态调整 CSS 类数组。

关键要点

  • 过滤器名称:nav_menu_submenu_css_class
  • 参数:$classes(CSS 类数组)、$args(wp_nav_menu() 参数对象)、$depth(菜单项深度)
  • 用途:在 Walker_Nav_Menu::start_lvl() 中调用,用于控制子菜单的 CSS 类
  • 版本:自 WordPress 4.8.0 引入

代码示例

function wpdocs_custom_dropdown_class( $classes ) {
    $classes[] = 'dropdown';
    return $classes;
}
add_filter( 'nav_menu_submenu_css_class', 'wpdocs_custom_dropdown_class' );

📄 原文内容

Filters the CSS class(es) applied to a menu list element.

Parameters

$classesstring[]
Array of the CSS classes that are applied to the menu <ul> element.
$argsstdClass
An object of wp_nav_menu() arguments.
$depthint
Depth of menu item. Used for padding.

Source

$class_names = implode( ' ', apply_filters( 'nav_menu_submenu_css_class', $classes, $args, $depth ) );

Changelog

Version Description
4.8.0 Introduced.

User Contributed Notes