0

0

如何在WordPress中正确禁用或移除默认加载的jQuery脚本

DDD

DDD

发布时间:2025-12-03 08:15:15

|

452人浏览过

|

来源于php中文网

原创

如何在wordpress中正确禁用或移除默认加载的jquery脚本

本教程旨在指导WordPress用户如何正确禁用或移除网站默认加载的jQuery脚本,以解决因重复加载、版本冲突或性能问题(如从Google CDN加载缓慢)导致的困扰。核心在于理解WordPress脚本管理的“句柄”概念,并使用`wp_deregister_script('jquery')`这一正确方法,而非常见的`jquery-js`,同时提供替换自定义jQuery的方案及重要注意事项。

引言:为何需要禁用WordPress默认的jQuery?

WordPress在默认情况下会加载jQuery库,这通常是为了确保主题和插件能够正常运行。然而,在某些场景下,用户可能希望禁用或替换这个默认加载的jQuery,主要原因包括:

  1. 性能优化: 默认加载的jQuery可能来自远程CDN(如Google CDN),如果CDN响应速度慢或网络条件不佳,会导致页面加载时间显著增加。
  2. 避免冲突: 自定义主题或某些插件可能已经包含了自己的jQuery版本,导致网站上同时加载多个jQuery实例,这不仅浪费带宽,还可能引发版本冲突,导致脚本错误。
  3. 版本控制: 开发者可能需要特定版本的jQuery来满足项目需求,而WordPress默认加载的版本可能不符合要求。

当您发现网站加载了多余的jQuery,或者默认jQuery加载缓慢时,正确地禁用它并按需加载自己的版本就显得尤为重要。

理解WordPress脚本管理:句柄的重要性

WordPress通过一套称为“脚本和样式表管理系统”的机制来处理前端资源。在这个系统中,每个脚本和样式表都被赋予一个唯一的“句柄”(handle)。当您需要对某个脚本进行操作(如禁用、注册、排队)时,必须使用其正确的句柄。

对于WordPress默认加载的jQuery,其内部句柄是jquery。许多用户在尝试禁用时,可能会误用jquery-js或jquery.js等变体,导致操作无效。这是因为jquery-js并非WordPress内部识别的jQuery句柄。

正确的禁用方法:使用wp_deregister_script('jquery')

要正确禁用WordPress默认加载的jQuery,您需要使用wp_deregister_script()函数,并传入正确的句柄jquery。此操作应在wp_enqueue_scripts动作钩子中执行,并建议添加条件判断,确保只在前端禁用,避免影响后台管理界面。

羚珑
羚珑

京东推出的一站式AI图像处理平台

下载

以下是实现此功能的代码示例,您需要将其添加到当前活动主题的functions.php文件中:

代码解释:

  • custom_remove_default_jquery():这是一个自定义函数,用于执行禁用操作。
  • if (!is_admin()):这个条件判断非常重要,它确保只有在非WordPress管理后台的页面(即网站前端)才会执行wp_deregister_script('jquery')。这是为了避免禁用jQuery后导致WordPress管理界面出现功能问题。
  • wp_deregister_script('jquery'):这是核心函数调用,它会告诉WordPress取消注册名为jquery的脚本。一旦取消注册,WordPress就不会再将这个脚本排队加载到页面中。
  • add_action('wp_enqueue_scripts', 'custom_remove_default_jquery');:这行代码将您的自定义函数挂载到wp_enqueue_scripts动作钩子上。这个钩子是WordPress在准备加载所有前端脚本和样式时触发的,是管理前端脚本的最佳时机。

可选:禁用后如何加载自己的jQuery?

在禁用WordPress默认jQuery之后,如果您的网站仍然依赖jQuery(例如,主题或插件的某些功能需要),您需要手动注册并排队加载您自己的jQuery版本。这通常涉及以下步骤:

  1. 准备您的jQuery文件: 可以是来自您选择的CDN(如Cloudflare CDN、jsDelivr CDN)的URL,也可以是您上传到主题目录的本地文件。
  2. 使用wp_enqueue_script()函数: 在禁用默认jQuery的同一个函数中(或者另一个紧随其后的函数),使用wp_enqueue_script()来加载您的自定义jQuery。

以下是一个加载自定义jQuery的示例代码:

代码解释:

  • wp_enqueue_script('jquery', 'YOUR_JQUERY_URL', array(), 'VERSION', true);:
    • 第一个参数'jquery':保持句柄为jquery至关重要。这样,任何依赖于jquery句柄的脚本(例如wp_enqueue_script('my-script', 'my-script.js', array('jquery')))仍然能够找到并正确加载您的自定义jQuery。
    • 第二个参数'YOUR_JQUERY_URL':替换为您的jQuery文件的完整URL,可以是CDN链接或主题目录下的相对路径。
    • 第三个参数array():这是一个依赖数组。如果您的jQuery文件依赖于其他脚本才能运行,可以在这里列出它们的句柄。对于jQuery本身,通常没有外部依赖。
    • 第四个参数'VERSION':脚本的版本号。这有助于缓存管理。
    • 第五个参数true:如果设置为true,脚本将在页脚加载(即在

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2587

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1619

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1506

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1417

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1447

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.7万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 7.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号