apply_filters( 'nav_menu_link_attributes', array $atts, WP_Post $item, stdClass $args, int $depth )

Filters the HTML attributes applied to a menu item’s anchor element.

Parameters

$atts

(array) The HTML attributes applied to the menu item's <a> element, empty strings are ignored.

  • 'title'
    (string) Title attribute.
  • 'target'
    (string) Target attribute.
  • 'rel'
    (string) The rel attribute.
  • 'href'
    (string) The href attribute.
  • 'aria-current'
    (string) The aria-current attribute.

$item

(WP_Post) The current menu item.

$args

(stdClass) An object of wp_nav_menu() arguments.

$depth

(int) Depth of menu item. Used for padding.

More Information

  • The filter permits full control over what HTML attributes are added to menus generated with the WP Menu API.
  • This filter runs per nav item, vs providing a list of all nav elements at once.
  • Note that the callback function must return a value after it is finished processing or the result will be empty.

Source

File: wp-includes/class-walker-nav-menu.php

View on Trac

Changelog

Version Description
4.1.0 The $depth parameter was added.
3.6.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/nav_menu_link_attributes