用途:为 WordPress 插件或主题中的 JavaScript 集成提供参考,覆盖脚本注册与入队、PHP 向 JS 传值、AJAX 模式、Heartbeat API、jQuery 用法与加载策略。
主要能力:使用 wp_enqueue_script 管理脚本依赖,禁止直接输出 script 标签;通过 wp_localize_script 传值(值会被转为字符串),复杂数据改用 wp_add_inline_script 配合 wp_json_encode;支持 wp_set_script_translations 做脚本国际化;列出 jquery、wp-api-fetch、wp-element、wp-data、wp-hooks、wp-i18n、wp-util、underscore、backbone 等内置句柄;WordPress 6.3+ 支持 defer/async 加载策略。
AJAX:请求经 wp-admin/admin-ajax.php,注册 wp_ajax_{action} 与 wp_ajax_nopriv_{action},用 check_ajax_referer 校验 nonce,返回 wp_send_json_success/error(内部调用 wp_die)。现代方案可用 wp.apiFetch 或原生 Fetch 配合 REST API。
Heartbeat:浏览器每 15-120 秒触发 tick,客户端用 heartbeat-send/heartbeat-tick 事件,服务端用 heartbeat_received 过滤器,可用于文章锁定、自动保存、会话管理与轮询通知。
限制与注意:jQuery 处于 noConflict 模式,$ 不可全局使用,需用 IIFE 包裹;wp_localize_script 不适合非字符串数据;wp_send_json_* 之后不应再输出;公开 AJAX 需注册 nopriv 钩子;避免从 CDN 加载 jQuery。具体版本与平台要求资料未提供。