云策 WordPress 开发者社区

钩子文档

nav_menu_attr_title

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

概述

nav_menu_attr_title 是一个 WordPress 过滤器钩子，用于修改导航菜单项的标题属性（title attribute）。它允许开发者在菜单项输出时自定义或过滤其 attr_title 值。

关键要点

  • 过滤器钩子名称：nav_menu_attr_title
  • 主要用途：过滤导航菜单项的标题属性（attr_title），常用于自定义菜单项的工具提示文本
  • 参数：$item_title（字符串类型），表示菜单项的标题属性值
  • 引入版本：WordPress 3.0.0
  • 相关函数：在 wp_setup_nav_menu_item() 和 WP_Customize_Nav_Menu_Item_Setting::value_as_wp_post_nav_menu_item() 中被调用，用于设置菜单项属性
📄 原文内容

Filters a navigation menu item’s title attribute.

Parameters

$item_titlestring
The menu item title attribute.

Source

$menu_item->attr_title = ! isset( $menu_item->attr_title ) ? apply_filters( 'nav_menu_attr_title', $menu_item->post_excerpt ) : $menu_item->attr_title;

View all references View on Trac View on GitHub

Used by Description
WP_Customize_Nav_Menu_Item_Setting::value_as_wp_post_nav_menu_item()wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

Get the value emulated into a WP_Post and set up as a nav_menu_item.
wp_setup_nav_menu_item()wp-includes/nav-menu.php

Decorates a menu item object with the shared navigation menu item properties.

Changelog

Version Description
3.0.0 Introduced.