WordPress导航菜单中如何为特定<li>元素添加自定义data属性

现有DOMDocument实现的优化（保留你当前的技术栈） #

你当前代码的核心问题是无差别遍历所有li节点，实际上不需要全量遍历，只要通过定位规则直接命中目标节点即可：

• 定位逻辑优化点：
  • 先加菜单位置判断，避免在非目标位置的菜单（比如侧边栏、移动端菜单）上跑解析逻辑，减少不必要的性能消耗
  • 用XPath替代全量遍历所有li，直接根据类名/ID匹配目标节点，命中后再加属性，找不到就直接返回原HTML
  • 补全DOMDocument加载时的编码兼容处理，避免中文乱码、HTML5标签解析报错

优化后的代码：

function booking_menu_atts( $items, $args ) {
    // 仅当渲染主导航时执行逻辑，按需替换成你自己的菜单位置标识
    if ( 'primary' !== $args->theme_location ) {
        return $items;
    }

    $dom = new DOMDocument();
    // 屏蔽HTML解析警告、兼容UTF-8编码
    libxml_use_internal_errors(true);
    $dom->loadHTML(mb_convert_encoding($items, 'HTML-ENTITIES', 'UTF-8'));
    libxml_clear_errors();

    // 初始化XPath解析器
    $xpath = new DOMXPath($dom);
    // 精准匹配目标li：替换成你自己的目标类名
    $target_li = $xpath->query('//li[contains(@class, "your-unique-booking-class")]')->item(0);

    // 仅命中目标节点时添加自定义属性
    if ( $target_li ) {
        $target_li->setAttribute('data-agent','any');
        $target_li->setAttribute('data-hide-panel','yes');
    }

    return $dom->saveHTML();
}
add_filter('wp_nav_menu_items', 'booking_menu_atts', 10, 2);

定位提示：如果你知道目标li的固定ID（格式一般为menu-item-XX），可以直接用$target_li = $dom->getElementById('menu-item-你的菜单项ID')替代XPath查询，定位精度更高，不会因为类名修改失效。

更推荐的WordPress原生实现（无HTML解析，性能更高） #

WordPress提供了专门针对菜单项li属性的钩子nav_menu_item_attr，不需要把整个菜单HTML转成DOM节点再解析回来，直接在生成li标签的阶段匹配目标项、追加属性，是官方推荐的实现方式。
实现代码：

function add_attr_to_target_menu_item( $attr, $item, $args, $depth ) {
    // 匹配规则1：固定菜单项ID（后台菜单编辑页可查看每个项的ID）
    // if ( 123 !== (int)$item->ID ) return $attr;

    // 匹配规则2：靠菜单项绑定的自定义类匹配
    $target_class_list = ['your-unique-booking-class']; // 替换成目标类名
    if ( !array_intersect( $target_class_list, (array)$item->classes ) ) {
        return $attr;
    }

    // 命中目标项后追加自定义属性
    $attr['data-agent'] = 'any';
    $attr['data-hide-panel'] = 'yes';

    return $attr;
}
add_filter( 'nav_menu_item_attr', 'add_attr_to_target_menu_item', 10, 4 );

• 这种方案的灵活性：
  • 可以直接用菜单项的唯一ID做匹配，完全不受类名、菜单结构调整的影响
  • 可以直接读取菜单项绑定的类数组，和前端实际输出的类名完全一致，不会有匹配偏差
  • 支持跨场景匹配：比如按菜单项指向的页面ID、自定义分类ID匹配，哪怕后期调整菜单项的类、修改菜单顺序，只要指向的内容不变，属性就会正确生效
  • 完全避免DOM解析的兼容问题（比如中文乱码、HTML5标签解析警告、半开标签导致的解析异常）

代码修正提示：你原来的钩子注册写的是3个回调参数，但wp_nav_menu_items钩子实际只支持2个传入参数，多余的参数不会被填充值，之前的代码运行时第三参数实际为空，属于无效配置。

内容的提问来源于stack exchange，提问作者Victorious