钩子文档

customize_nav_menu_searched_items

💡 云策文档标注

概述

customize_nav_menu_searched_items 是一个 WordPress 过滤器钩子,用于在自定义菜单搜索请求期间过滤可用的菜单项数组。它允许开发者修改搜索结果,基于搜索参数动态调整菜单项。

关键要点

  • 这是一个过滤器钩子,应用于 customize_nav_menu_searched_items,用于处理菜单项搜索。
  • 接受两个参数:$items(菜单项数组)和 $args(包含 'pagenum' 和 's' 搜索参数的数组)。
  • 在 WordPress 4.5.0 版本中引入,主要用于 WP_Customize_Nav_Menus::search_available_items_query() 方法。

📄 原文内容

Filters the available menu items during a search request.

Parameters

$itemsarray
The array of menu items.
$argsarray
Includes 'pagenum' and 's' (search) arguments.

Source

$items = apply_filters( 'customize_nav_menu_searched_items', $items, $args );

Changelog

Version Description
4.5.0 Introduced.