nav_menu_link_attributes WordPress Filter Hook
The nav_menu_link_attributes hook is used to filter the attributes applied to a menu item's anchor element.
apply_filters( 'nav_menu_link_attributes', array $atts , WP_Post $menu_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.
- 'title'
- $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.
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
Changelog
| Version | Description |
|---|---|
| 4.1.0 | The $depth parameter was added. |
| 3.6.0 | Introduced. |