Laravel中使用jQuery UI日期选择器报datepicker is not a function错误
报错核心原因
你遇到的$(...).datepicker is not a function报错,本质是两个常见的前端资源加载问题触发的,和CDN链接本身的可用性关系不大:
- 全局jQuery实例被重复覆盖:Laravel默认编译的
app.js已经内置了jQuery并绑定到全局$,但你在</body>前又同步引入了一次独立的jQuery 1.12.4脚本。这种重复引入会让最后加载的jQuery实例覆盖全局的$,而jQuery UI是绑定在第一次加载的jQuery实例上的,业务代码执行时拿到的$指向的是没有挂载datepicker方法的第二个jQuery实例,自然会抛出方法不存在的错误。 - 脚本执行时序错位:head中给
app.js加了defer属性,这类脚本会等DOM结构完全解析完成后才按顺序执行,但你在body底部写的业务初始化脚本是同步执行的,很容易出现业务代码先跑、datepicker插件还没完成挂载的时序差。
分步修复操作
- 移除重复的jQuery引入
直接删掉</body>前的两个重复引入的脚本:
从根源上避免多实例冲突的问题。<script src="https://code.jquery.com/jquery-1.12.4.js"></script> <script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js"></script> - 按正确时序配置jQuery UI加载
把jQuery UI的脚本挪到head区域,和app.js保持一致的defer属性:
defer属性的执行规则是在DOM解析完成后,按照脚本在HTML中的书写顺序执行,这样就能保证先加载app.js内置的jQuery核心,再加载jQuery UI插件,不会出现插件找不到挂载目标的问题。<!-- 保持书写顺序,defer脚本会按照书写顺序依次执行 --> <script src="{{ asset('js/app.js') }}" defer></script> <script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js" defer></script> - 校验jQuery的全局暴露配置
打开resources/js/app.js文件,确认存在jQuery全局绑定的代码,如果缺失就手动补上:
这一步是避免Laravel Mix编译配置改动后,jQuery没有正确挂到window全局对象上,导致UI插件无法挂载方法。window.$ = window.jQuery = require('jquery'); - 补充加载状态兜底
调整原来的datepicker初始化脚本,增加方法存在性判断,避免偶发时序问题触发报错:
把scriptForm区块里的代码替换成如下逻辑:document.addEventListener('DOMContentLoaded', function() { // 确认datepicker方法存在再执行初始化 if (typeof $.fn.datepicker === 'undefined') { console.error('jQuery UI 插件加载未完成,请检查资源引入'); return; } var dateFormat = "mm/dd/yy", from = $( "#from" ) .datepicker({ defaultDate: "+1w", changeMonth: true, numberOfMonths: 3 }) .on( "change", function() { to.datepicker( "option", "minDate", getDate( this ) ); }), to = $( "#to" ).datepicker({ defaultDate: "+1w", changeMonth: true, numberOfMonths: 3 }) .on( "change", function() { from.datepicker( "option", "maxDate", getDate( this ) ); }); function getDate( element ) { var date; try { date = $.datepicker.parseDate( dateFormat, element.value ); } catch( error ) { date = null; } return date; } })
额外注意点
- 把原来用协议相对路径的jQuery UI CSS链接改成带完整HTTPS前缀的形式,避免本地开发或内网环境下出现资源加载失败:
<link rel="stylesheet" href="https://code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css"> - 打开浏览器开发者工具的Network面板,确认所有jQuery、jQuery UI的资源请求都返回200状态码,没有被广告拦截插件、网络防火墙拦截——很多时候配置逻辑正确,实际资源因为拦截根本没加载下来,也会触发相同的报错。
内容的提问来源于stack exchange,提问作者Mahmoud Diab
相关产品推荐
相关产品推荐

