钩子文档

nav_menu_submenu_attributes

💡 云策文档标注

概述

nav_menu_submenu_attributes 是一个 WordPress 过滤器,用于修改菜单列表元素的 HTML 属性。它允许开发者在生成导航菜单子菜单时自定义其属性。

关键要点

  • 过滤器名称:nav_menu_submenu_attributes
  • 参数:$atts(HTML 属性数组)、$args(wp_nav_menu() 参数对象)、$depth(菜单项深度)
  • 用途:在 Walker_Nav_Menu::start_lvl() 中调用,用于控制子菜单列表的 HTML 属性
  • 版本:从 WordPress 6.3.0 开始引入

代码示例

$atts = apply_filters( 'nav_menu_submenu_attributes', $atts, $args, $depth );

📄 原文内容

Filters the HTML attributes applied to a menu list element.

Parameters

$attsarray
The HTML attributes applied to the <ul> element, empty strings are ignored.

  • class string
    HTML CSS class attribute.

$argsstdClass
An object of wp_nav_menu() arguments.
$depthint
Depth of menu item. Used for padding.

Source

$atts       = apply_filters( 'nav_menu_submenu_attributes', $atts, $args, $depth );

Changelog

Version Description
6.3.0 Introduced.