WordPress复现Three.js魔方效果报Cannot read property 'fn'未定义错误
魔方效果复现的报错排查思路
先搞懂报错为啥会出现
这个Cannot read property 'fn' of undefined根本不是Three.js本身的问题,出错位置是jQuery魔方插件的代码逻辑里——这类jQuery插件的通用写法是$.fn.cube = function() { ... },如果执行这行代码的时候拿到的$是undefined,就会抛出这个错。哪怕你在页面源码里看到jQuery、three.js、魔方插件、初始化代码的标签顺序完全正确,也可能因为WordPress的脚本加载规则、全局变量冲突导致拿到的jQuery实例是空值。
分步排查修复
- 先快速定位问题
打开浏览器控制台,分别输入window.jQuery和window.$执行验证:如果前者能正常返回jQuery版本号,后者返回undefined,就实锤是WordPress默认开启的jQuery无冲突模式导致的——老插件不认WP的规则,直接拿全局$当jQuery用,拿到空值自然报错。 - 把
functions.php里的脚本注册逻辑改对
你现在的注册代码存在三个明显的疏漏:一是给独立运行的three.js加了没必要的jQuery依赖,WP会强制调整它的位置到jQuery后面,容易打乱加载顺序;二是给魔方插件漏加了three.js的前置依赖,WP不会自动保证three.js在魔方插件之前加载;三是没指定脚本在页脚加载,很容易因为头部区域的其他脚本冲突出问题。
调整后的正确注册写法:// Three.js 是独立库,不需要依赖jQuery,统一放页脚加载 wp_register_script( 'threejs', 'https://cdnjs.cloudflare.com/ajax/libs/three.js/r123/three.min.js', [], 'r123', true ); // 魔方插件必须等jQuery、three.js都加载完才能执行 wp_register_script( 'cubejs', get_stylesheet_directory_uri() . '/assets/libs/jquery.cube.threejs.min.js', ['jquery', 'threejs'], '1.0', true ); // 自定义初始化代码,必须等魔方插件加载完才能执行 wp_register_script( 'cubeCode', get_stylesheet_directory_uri() . '/assets/js/cube.js', ['cubejs'], '1.0', true ); // 统一加载所有脚本 wp_enqueue_script('threejs'); wp_enqueue_script('cubejs'); wp_enqueue_script('cubeCode'); - 给老插件做轻量适配
不用修改第三方魔方插件的源码,只要在主题的assets/js目录下加个几行代码的适配脚本,在魔方插件执行之前把jQuery实例绑回全局$就行:
把这个脚本注册成魔方插件的最前置依赖,确保魔方代码运行时,全局// 适配老jQuery插件的全局变量绑定 window.$ = window.jQuery.noConflict();$已经指向有效的jQuery实例,不会再出现读取空值fn属性的报错。 - 最后排查全局冲突
如果调整完还是报错,就去浏览器源码面板找到魔方插件第21行的位置打个断点,触发断点的时候检查上下文里的window.jQuery是不是被其他插件、主题自带的旧版jQuery覆盖成了无效值。碰到这类冲突,只要禁用对应冲突脚本,或者调整脚本加载优先级就能解决。
内容的提问来源于stack exchange,提问作者Tasos
相关产品推荐
相关产品推荐

