函数文档

_nav_menu_item_id_use_once()

💡 云策文档标注

概述

_nav_menu_item_id_use_once() 是一个 WordPress 函数,用于防止菜单项 ID 被重复使用,确保每个菜单项 ID 的唯一性。

关键要点

  • 函数接受两个参数:$id(字符串,必需)和 $item(对象,必需),返回一个字符串。
  • 通过静态数组 $_used_ids 跟踪已使用的菜单项 ID,如果 $item->ID 已存在,则返回空字符串;否则,将其添加到数组并返回原 $id。
  • 此函数在 WordPress 3.0.1 版本中引入,主要用于内部菜单处理,避免 ID 冲突。

代码示例

function _nav_menu_item_id_use_once( $id, $item ) {
	static $_used_ids = array();

	if ( in_array( $item->ID, $_used_ids, true ) ) {
		return '';
	}

	$_used_ids[] = $item->ID;

	return $id;
}

📄 原文内容

Prevents a menu item ID from being used more than once.

Parameters

$idstringrequired
$itemobjectrequired

Return

string

Source

function _nav_menu_item_id_use_once( $id, $item ) {
	static $_used_ids = array();

	if ( in_array( $item->ID, $_used_ids, true ) ) {
		return '';
	}

	$_used_ids[] = $item->ID;

	return $id;
}

Changelog

Version Description
3.0.1 Introduced.