nav_menu_item_attributes filter-hookWP 6.3.0

Filters the HTML attributes applied to a menu's list item element.

Usage

add_filter( 'nav_menu_item_attributes', 'wp_kama_nav_menu_item_attributes_filter', 10, 4 );

/**
 * Function for `nav_menu_item_attributes` filter-hook.
 * 
 * @param array    $li_atts   The HTML attributes applied to the menu item's `<li>` element, empty strings are ignored.
 * @param WP_Post  $menu_item The current menu item object.
 * @param stdClass $args      An object of wp_nav_menu() arguments.
 * @param int      $depth     Depth of menu item. Used for padding.
 *
 * @return array
 */
function wp_kama_nav_menu_item_attributes_filter( $li_atts, $menu_item, $args, $depth ){

	// filter...
	return $li_atts;
}
$li_atts(array)

The HTML attributes applied to the menu item's <li> element, empty strings are ignored.

  • class(string)
    HTML CSS class attribute.

  • id(string)
    HTML id attribute.
$menu_item(WP_Post)
The current menu item object.
$args(stdClass)
An object of wp_nav_menu() arguments.
$depth(int)
Depth of menu item. Used for padding.

Changelog

Since 6.3.0 Introduced.

Where the hook is called

Walker_Nav_Menu::start_el()
nav_menu_item_attributes
wp-includes/class-walker-nav-menu.php 210
$li_atts       = apply_filters( 'nav_menu_item_attributes', $li_atts, $menu_item, $args, $depth );

Where the hook is used in WordPress

Usage not found.