#yepnope.js#
A Conditional Script Loader For Your Polyfills, or Regressive Enhancement With Style.
A small script loader to help use feature detection to load exactly the scripts that your user needs, not just all the scripts that you think they might need.
More docs, etc at: https://yepnopejs.com
By:
Alex Sexton - AlexSexton [at] gmail
Ralph Holzmann - RalphHolzmann [at] gmail
Follow: @SlexAxton and @ralphholzmann on Twitter for more updates.
##A simple example (assuming modernizr is there):##
yepnope([
{
test : Modernizr.indexeddb,
yep : ['/js/indexeddb-wrapper.js', '/css/coolbrowser.css'],
nope : ['/js/polyfills/lawnchair.js', '/js/cookies.js', '/css/oldbrowser.css']
}
]);
Any forks and stuff are welcome.
##Current Released Version##
1.5.3
(NOTE:: there were some problems with 1.5.0 in IE, we strongly suggest an upgrade to 1.5.3)
Changes in 1.5+ :
- Scripts with the same url don't reexecute, but their callbacks fire in the correct order.
- The
complete
function behaves much more like thecallback
function with respect to 'recursive yepnope'. - CSS load callbacks were taken out by default and put in an official plugin. Too few people used it. Old code will still work, callbacks just fire immediately on CSS (unless css load plugin is included).
- We exposed
yepnope.injectJs
andyepnope.injectCss
in order to give you direct access to the injection functions. - We added the ability to use key/value pairs in prefixes.
- We added a builtin prefix for overriding the global
yepnope.errorTimeout
with a specific timeout per script.yepnope('timeout=5000!script.js');
- We smarten'd up detection of CSS files even if there are query parameters (without the use of the
css
prefix plugin) - We added the ability to write filters and prefixes that add arbitrary attributes on the eventual script and link tags.
- We removed the old and busted
demo/
folder since we just use thetests
folder for everything. - We just assume you have uglifyjs if you're running our
compress
script.
NOTE: the code in the github repository is considered in development. Use at your own risk. The download buttons will link to our current release version.
##License##
All of the yepnope specific code is under the WTFPL license. Which means it's also MIT and BSD (or anything you want). However, the inspired works are subject to their own licenses.
All contributions to yepnope should be code that you wrote, and will be subject to the Dojo CLA. By sending a pull request, you agree to this. All commits thus far have also been committed under this license.
##Thanks##
Dave Artz - A.getJS was a huge code-inspiration for our loader. So he's responsible for a ton of awesome techniques here.
Kyle Simpson - He is the creator of LABjs of which a lot of this is inspired by.
Stoyan Stefanov - His work on resource preloading has been awesome: (https://www.phpied.com/preload-cssjavascript-without-execution/)[https://www.phpied.com/preload-cssjavascript-without-execution/]
Steve Souders - His evangelism and work in the space (ControlJS) have brought light to the issues at hand, he is the father of front-end performance.
Paul Irish - Thanks or whatever.