为什么admin_body_class钩子下WP_Screen参数不全？如何给指定子页加类？

问题根因 #

你观察到的get_current_screen()属性缺失、parent_base为null的现象，完全是WordPress的钩子执行时序导致的，不是代码逻辑问题：
admin_body_class 钩子的触发时机远早于WP_Screen实例对菜单关联属性的初始化流程——WP_Screen刚被实例化的时候，只会先填充基础的页面ID、钩子名这类属性，等后续菜单匹配逻辑跑完，才会补全parent_base、parent_file这类和层级菜单相关的属性。在admin_body_class回调里直接读取这些未初始化的属性，拿到null是必然结果。

另外你现有代码有一个隐蔽的高频bug：当不满足if判断条件时，没有无条件返回$classes参数，会直接导致后台body类列表输出中断，引发全站样式异常。

可落地的两种实现方案 #

方案1：通过已加载的菜单注册表匹配目标页面（无需调整钩子时序） #

WordPress在后台加载的早期，就已经把所有注册的顶级、子菜单配置写入全局变量$submenu，这个变量的加载时机远早于admin_body_class触发点，可以直接通过这个变量收集目标顶级菜单下的所有页面slug，和当前页面ID做匹配即可。

完整可运行的代码：

add_filter('admin_body_class', 'tw_admin_body_class');
function tw_admin_body_class( $classes ) {
    // 获取当前已初始化完成的后台页面ID（这个属性在admin_body_class触发时已可用）
    $current_screen_id = get_current_screen()->id;
    global $submenu;
    // 替换为你实际注册的顶级菜单slug
    $target_top_menu_slug = 'tw-top';
    // 先把顶级菜单自身的页面纳入匹配范围
    $all_matchable_pages = [$target_top_menu_slug];

    // 收集该顶级菜单下所有子菜面对应的slug
    if (isset($submenu[$target_top_menu_slug])) {
        foreach ($submenu[$target_top_menu_slug] as $submenu_item) {
            // 子菜单数组的第三个固定元素，就是子页面的注册slug
            $all_matchable_pages[] = $submenu_item[2];
        }
    }

    // 匹配命中就追加自定义类，注意类前留空格避免和原有类名粘连
    if (in_array($current_screen_id, $all_matchable_pages)) {
        $classes .= ' raashid';
    }

    // 无论是否匹配，必须返回$classes参数
    return $classes;
}

方案2：在WP_Screen完全初始化后做标记，再给body加类 #

如果不想手动遍历菜单注册表，可以利用current_screen钩子——这个钩子触发时，WP_Screen实例已经完成了所有属性（包括你需要的parent_base）的填充，我们可以在这个时机先给当前页面打个标记，等admin_body_class触发时直接读取标记加类即可。

代码示例：

// WP_Screen完全初始化后，标记需要加自定义类的页面
add_action('current_screen', function($screen_instance) {
    if ($screen_instance->parent_base === 'tw-top') {
        $GLOBALS['tw_need_custom_body_class'] = true;
    }
});

add_filter('admin_body_class', 'tw_admin_body_class');
function tw_admin_body_class( $classes ) {
    // 读取之前打的标记，命中就加类
    if (!empty($GLOBALS['tw_need_custom_body_class'])) {
        $classes .= ' raashid';
    }
    return $classes;
}

常见踩坑提醒 #

• 不要在admin_body_class回调里直接做依赖菜单关联属性的判断，这类属性在钩子触发时还未完成初始化
• 所有admin_body_class的回调必须无条件返回传入的$classes参数，否则会破坏默认的body类输出逻辑
• 追加自定义类名时要在前面加空格，避免和原有类名粘连导致选择器失效

内容的提问来源于stack exchange，提问作者Raashid Din Dar