apply_filters( 'nav_menu_css_class', string[] $classes, WP_Post $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.

$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

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

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

View on Trac

Changelog

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

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