wordpress 插件中使用 `admin_notices` 钩子输出提示消息时，若未包裹在 `.wrap` 容器内，会导致通知全宽显示、遮挡侧边栏或脱离主内容区（`#wpbody-content`），根本原因是该钩子触发过早，此时 wordpress 管理后台主体结构尚未渲染。
在 WordPress 后台，标准的通知（如更新成功、设置保存提示）之所以能精准嵌入主内容区域，是因为它们被包裹在 zuojiankuohaophpcndiv class="wrap"> 容器中，而该容器是 WordPress 管理界面布局的核心包装器——它确保内容遵循默认栅格、留白及响应式规则，并正确位于 #wpbody-content 内部。
你当前的代码直接将 <div class="notice ..."> 输出到 admin_notices 钩子，而此钩子在 <body> 标签后、#wpcontent 或 #wpbody-content 结构生成前即被触发，因此 DOM 中通知元素会出现在 <body> 下方第一层，而非预期的管理内容区域内，造成视觉错位与样式失效（如宽度异常、z-index 冲突、无法响应 dismiss 操作等）。
✅ 正确做法：不直接在 admin_notices 中输出通知 HTML，而是通过自定义钩子 + 包裹容器进行可控注入。推荐采用以下结构：
<?php
// 1. 定义通知逻辑函数（纯输出，不依赖上下文）
function customer_admin_notice($message_type, $customer_nr = '') {
$message = '';
$type = 'success';
switch ($message_type) {
case 'customer_update_success':
$message = 'Customer updated successfully.';
break;
case 'customer_new_success':
$message = 'Customer added successfully.';
break;
case 'customer_delete_success':
$message = "Customer with number {$customer_nr} has been deleted.";
break;
case 'customer_delete_error':
$message = "No customer with number {$customer_nr} was found.";
$type = 'error';
break;
default:
return;
}
?>
<div class="notice notice-<?php echo esc_attr($type); ?> is-dismissible">
<p><?php echo esc_html($message); ?></p>
</div>
<?php
}
// 2. 创建包装器：确保通知被包裹在 .wrap 内
function customer_admin_notice_wrapper() {
// 仅在主内容区域渲染时执行（避免重复/无效输出）
if (did_action('in_admin_header') && !doing_action('admin_notices')) {
echo '<div class="wrap">';
do_action('customer_admin_notices');
echo '</div>';
}
}
// 3. 注册钩子：先挂载通知逻辑到自定义钩子，再用 admin_notices 触发包装器
add_action('customer_admin_notices', 'customer_admin_notice'); // 通知内容
add_action('admin_notices', 'customer_admin_notice_wrapper'); // 容器包装
?>? 关键说明：
- customer_admin_notices 是你自定义的动作钩子，用于解耦通知内容与容器结构；
- admin_notices 仅用于触发 customer_admin_notice_wrapper()，后者负责输出 <div class="wrap"> 并调用你的通知；
- 使用 esc_html() 和 esc_attr() 对输出内容做基础转义，防止 XSS 风险；
- switch 替代长 if/else if 提升可读性与可维护性；
- did_action('in_admin_header') 可选增强判断，确保仅在管理页头已加载后执行（进一步规避时机问题）。
⚠️ 注意事项：
- 不要在 admin_notices 回调中直接 echo 多个 .wrap，否则可能嵌套混乱；
- 若需动态控制通知显示（如仅在特定页面显示），应在 customer_admin_notice_wrapper() 中添加 get_current_screen() 判断；
- 建议配合 wp_die() 或 wp_redirect() 后的 add_settings_error() + settings_errors() 实现更规范的设置页通知流（适用于选项页面）；
- is-dismissible 类需配合 JS 手动绑定关闭逻辑（WordPress 默认不自动处理自定义通知的 dismiss），如需支持关闭，请添加 JavaScript 移除对应 DOM 节点并调用 wp.ajax.post() 记录用户偏好。
通过此方案，你的通知将严格对齐 WordPress 官方 UI 规范，正确显示在主内容区顶部，具备完整样式、交互与可访问性支持。
