nav_menu_css_class WordPress Filter Hook
The nav_menu_css_class hook is used to add custom CSS classes to a menu item's list item element (LI). This is useful for adding custom styles to specific menu items.
apply_filters( 'nav_menu_css_class', string[] $classes , WP_Post $menu_item , stdClass $args , int $depth ) #
Filters the CSS classes applied to a menu item’s list item element.
Parameters
- $classes
(string[])Array of the CSS classes that are applied to the menu item's
<li>element.- $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
This filter hook called by the WordPress Walker_Nav_Menu class.
Usage in WP 3.0 / 3.1+ / 4.1+:
<?php
/* WP 3.0+ */
function filter_handler( $classes , $item ) { ...... }
add_filter( 'nav_menu_css_class', 'filter_handler', 10, 2 );
/* WP 3.1+ */
function filter_handler( $classes , $item, $args ) { ...... }
add_filter( 'nav_menu_css_class', 'filter_handler', 10, 3 );
/* WP 4.1+ */
function filter_handler( $classes, $item, $args, $depth ) { ...... }
add_filter( 'nav_menu_css_class', 'filter_handler', 10, 4 );
?>
Source
Changelog
| Version | Description |
|---|---|
| 4.1.0 | The $depth parameter was added. |
| 3.0.0 | Introduced. |