_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
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. |