nav_menu_css_class

Filter Hook

Description

Filters the CSS classes applied to a menu item's list item element.

Hook Information

File Location	`wp-includes/class-walker-nav-menu.php` View on GitHub
Hook Type	Filter
Line Number	`194`

Hook Parameters

Type	Name	Description
`string[]`	`$classes`	Array of the CSS classes that are applied to the menu item's ` ` element.
`WP_Post`	`$menu_item`	The current menu item object.
`stdClass`	`$args`	An object of wp_nav_menu() arguments.
`int`	`$depth`	Depth of menu item. Used for padding.

Usage Examples

Basic Usage

<?php
// Hook into nav_menu_css_class
add_filter('nav_menu_css_class', 'my_custom_filter', 10, 4);

function my_custom_filter($classes, $menu_item, $args, $depth) {
    // Your custom filtering logic here
    return $classes;
}

Source Code Context

wp-includes/class-walker-nav-menu.php:194 - How this hook is used in WordPress core

<?php
 189  		 * @param string[] $classes   Array of the CSS classes that are applied to the menu item's `<li>` element.
 190  		 * @param WP_Post  $menu_item The current menu item object.
 191  		 * @param stdClass $args      An object of wp_nav_menu() arguments.
 192  		 * @param int      $depth     Depth of menu item. Used for padding.
 193  		 */
 194  		$class_names = implode( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $menu_item, $args, $depth ) );
 195  
 196  		/**
 197  		 * Filters the ID attribute applied to a menu item's list item element.
 198  		 *
 199  		 * @since 3.0.1

PHP Documentation

<?php
/**
		 * Filters the CSS classes applied to a menu item's list item element.
		 *
		 * @since 3.0.0
		 * @since 4.1.0 The `$depth` parameter was added.
		 *
		 * @param string[] $classes   Array of the CSS classes that are applied to the menu item's `<li>` element.
		 * @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.
		 */

Quick Info

Hook Type: Filter
Parameters: 4
File: wp-includes/class-walker-nav-menu.php

Links

WordPress Docs View Source Code Search Examples

Related Hooks

Related hooks will be displayed here in future updates.