yepnope.js使用详解及示例分享
yepnope.js的一个典型实例:
yepnope({
test:Modernizr.geolocation,
yep:'normal.js',
nope:['polyfill.js','wrapper.js']
});
此实例表示如果Modernizr.geolocation为真的时候加载normal.js,为假则加载polyfill.js及wrapper.js。
yepnope完整语法:
yepnope([{
test:/*boolean(ish)输入条件*/,
yep:/*array(ofstrings)|string-条件为真时加载的资源*/,
nope:/*array(ofstrings)|string-条件为假时加载的资源*/,
both:/*array(ofstrings)|string-条件无论真假都加载*/,
load:/*array(ofstrings)|string-条件无论真假都加载*/,
callback:/*function(testResult,key)|object{key:fn}回调函数*/,
complete:/*function加载完成后执行的函数*/
},...]);
为什么使用yepnope:
Gzip后只有1.6K比大多数的资源加载器都小
可以加载CSS及JS
yepnope通过了作者能找到的所有的浏览器的测试
yepnope完全分离资源加载和执行,这样你可以控制资源的执行顺序
提供友好的API和促进资源的逻辑组合
模块化设计,你可以自己扩充功能(见稍后的Prefixes及filters)
鼓励按需加载资源
集成在Modernizr中
默认总是按照资源列表(你所提供的文件列表顺序)顺序执行
可处理资源回退(fallback),且仍优先并行下载依赖的脚本,看下代码更容易理解:
yepnope([
{
load:'http://ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js',
complete:function(){
if(!window.jQuery){
yepnope('local/jquery.min.js');
}
}
},
{
load:'jquery.plugin.js',
complete:function(){
jQuery(function(){
jQuery('div').plugin();
});
}
}
]);
而其他加载器则可能必须这样处理:
someLoader('http://ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js',function(){
if(!window.jQuery){
someLoader('local/jquery.min.js','jquery.plugin.js');
/*注意这点和yepnope的区别,yepnope加载失败后仅需重新加载备用资源即可,不会影响依赖此资源的其他文件执行*/
}else{
someLoader('jquery.plugin.js');
}
});
yepnope的不足
并不总是最快的,像labjs等优化后可能加载速度优于yepnope,但需要根据你的实际情况考虑使用哪个加载器
需要给资源设置一定的缓存头(这一点很重要)
并不像RequireJS等类库有自己的生成工具及丰富的API,yepnope仅实现了基本加载器功能
默认总是按照你提供的资源列表顺序执行,这一点有可能会影响速度
yepnope使用实例:
直接传入字符串
yepnope('/url/to/your/script.js');
传入一个Object对象
yepnope({
load:'/url/to/your/script.js'
});
回调函数实例(回调函数中url表示加载的资源文件名;result表示test参数的结果;key表示使用keymaping时候的文件名缩写)
yepnope({
test:window.JSON,
load:'/url/to/your/script.js',
callback:function(url,result,key){
//wheneverthisruns,yourscripthasjustexecuted.
alert('script.jshasloaded!');
}
});
complete函数实例
yepnope({
test:window.JSON,
nope:'json2.js',
complete:function(){
vardata=window.JSON.parse('{"json":"string"}');
}
});
Keymaping实例
yepnope({
test:Modernizr.geolocation,
yep:{
'rstyles':'regular-styles.css'
},
nope:{
'mstyles':'modified-styles.css',
'geopoly':'geolocation-polyfill.js'
},
callback:function(url,result,key){
if(key==='geopoly'){
alert('Thisisthegeolocationpolyfill!');
}
}
});
当然回调函数你还可以这样写:
yepnope({
test:Modernizr.geolocation,
yep:{
'rstyles':'regular-styles.css'
},
nope:{
'mstyles':'modified-styles.css',
'geopoly':'geolocation-polyfill.js'
},
callback:{
'rstyles':function(url,result,key){
alert('Thisistheregularstyles!');
},
'mstyles':function(url,result,key){
alert('Thisisthemodifiedstyles!');
},
'geopoly':function(url,result,key){
alert('Thisisthegeolocationpolyfill!');
}
},
complete:function(){
alert('Everythinghasloadedinthistestobject!');
}
});
yepnope官方提供的3个Prefixes
css!Prefix:可以加载任何后缀的文件作为css文件
yepnope('css!mystyles.php?version=1532');
preload!Prefix:预加载资源到缓存中,但不执行(下次load时候才执行)
yepnope({
load:'preload!jquery.1.5.0.js',
callback:function(url,result,key){
window.jQuery;//undefined
yepnope(jquery.1.5.0.js);
window.jQuery;//object
}
});
ie!Prefix(es):判断是否IE浏览器(除ie!外,还支持ie5,ie6,ie7,ie8,ie9,iegt5,iegt6,iegt7,iegt8,ielt7,ielt8,及ielt9这几种Prefix)
yepnope({
load:['normal.js','ie6!ie7!ie-patch.js']//ie6orie7only(onpatch)
});