云策 WordPress 开发者社区

钩子文档

wp_nav_menu_{$menu->slug}_items

查看官方原文 ↗
💡 云策文档标注

概述

wp_nav_menu_{$menu->slug}_items 是一个 WordPress 过滤器钩子，用于修改特定导航菜单的 HTML 列表内容。它允许开发者在菜单输出前自定义菜单项，基于菜单的 slug 进行过滤。

关键要点

  • 这是一个动态过滤器钩子，名称中包含菜单的 slug，例如 wp_nav_menu_main-menu_items。
  • 接收两个参数：$items（菜单项的 HTML 列表内容）和 $args（包含 wp_nav_menu() 参数的对象）。
  • 可用于添加、移除或修改导航菜单中的项目，实现高度定制化。
  • 与 wp_nav_menu() 函数紧密相关，常用于主题或插件开发中。

代码示例

$items = apply_filters( "wp_nav_menu_{$menu->slug}_items", $items, $args );

注意事项

  • 钩子名称中的 {$menu->slug} 是动态部分，需根据实际菜单 slug 替换。
  • 参数 $args 包含 wp_nav_menu() 的所有可用参数，如 menu_class、depth 等，便于基于上下文调整菜单。
  • 自 WordPress 3.0.0 版本引入，确保在兼容版本中使用。
📄 原文内容

Filters the HTML list content for a specific navigation menu.

Description

See also

Parameters

$itemsstring
The HTML list content for the menu items.
$argsstdClass
An object containing wp_nav_menu() arguments.

More Arguments from wp_nav_menu( … $args )

Array of nav menu arguments.

  • menu int|string|WP_Term
    Desired menu. Accepts a menu ID, slug, name, or object.
  • menu_class string
    CSS class to use for the ul element which forms the menu.
    Default 'menu'.
  • menu_id string
    The ID that is applied to the ul element which forms the menu.
    Default is the menu slug, incremented.
  • container string
    Whether to wrap the ul, and what to wrap it with.
    Default 'div'.
  • container_class string
    Class that is applied to the container.
    Default ‘menu-{menu slug}-container’.
  • container_id string
    The ID that is applied to the container.
  • container_aria_label string
    The aria-label attribute that is applied to the container when it’s a nav element.
  • fallback_cb callable|false
    If the menu doesn’t exist, a callback function will fire.
    Default is 'wp_page_menu'. Set to false for no fallback.
  • before string
    Text before the link markup.
  • after string
    Text after the link markup.
  • link_before string
    Text before the link text.
  • link_after string
    Text after the link text.
  • echo bool
    Whether to echo the menu or return it. Default true.
  • depth int
    How many levels of the hierarchy are to be included.
    0 means all. Default 0.
    Default 0.
  • walker object
    Instance of a custom walker class.
  • theme_location string
    Theme location to be used. Must be registered with register_nav_menu() in order to be selectable by the user.
  • items_wrap string
    How the list items should be wrapped. Uses printf() format with numbered placeholders. Default is a ul with an id and class.
  • item_spacing string
    Whether to preserve whitespace within the menu’s HTML.
    Accepts 'preserve' or 'discard'. Default 'preserve'.

Source

$items = apply_filters( "wp_nav_menu_{$menu->slug}_items", $items, $args );

View all references View on Trac View on GitHub

Used by Description
wp_nav_menu()wp-includes/nav-menu-template.php

Displays a navigation menu.

Changelog

Version Description
3.0.0 Introduced.