jQuery & jQuery UI Documentation

jQuery & jQuery UI

Downloading jQuery

Contents

About The Code

The code itself is written rather cleanly in an attempt to self-document. If you've spotted some areas of code that could be improved, please feel free to discuss it on the Development mailing list. All input is gladly appreciated!

All of the code is available in two formats:

  • Compressed (which allows you to have a significantly smaller file size) and
  • Uncompressed (good for debugging and to understand what is behind the magic).

If you're interested in downloading Plugins developed by jQuery contributors, please visit the Plugins page.

jQuery is provided under the following MIT and GPL licenses.

CDN Hosted jQuery

A number of large enterprises provide hosted copies of jQuery on existing CDN networks that are available for public use. Below are links to the CDN-hosted copies of jQuery that you may hotlink to.

Download jQuery

This is the recommended version of jQuery to use for your application. The code in here should be stable and usable in all modern browsers.

The minified versions, while having a larger file size than the packed versions (note: packed version is not available in current release), are generally the best versions to use on production deployments. The packed versions require non-trivial client-side processing time to uncompress (unpack) the code whereas the minified versions do not. The packed versions of jQuery will take less time to download than the minified or uncompressed versions; however, each time the library is loaded (initially or from the browser cache) it will need to be uncompressed which will cause a non-trivial delay in the execution of any jQuery code each time it is loaded.

Current Release

Past Releases

jQuery Git - An Instant WIP Build For Testing

This work-in-progress build (known as jQuery Git) is generated once a minute from the jQuery Git repository. It is provided as a convenience for anyone that wants to help test changes in the next version of jQuery.

When reporting issues with WIP builds of jQuery, please make sure you include the date the snapshot was generated (it is listed at the top of the file).

Linking to WIP builds directly from the CDN is not advised, as the file is constantly refreshed and will change from minute to minute as new commits are made to the repository.

WARNING: Do NOT use jQuery Git in a production system or live application! It is not tested. It is not stable. It will probably blow up on you unexpectedly. You have been warned! If in doubt, stop and use the current release.

Build From Git

Note: The following is quite advanced. If you wish to just use a more-recent version of jQuery, please try the WIP build.

All source code is kept under Git revision control, which you can browse online. There's a download link available for any file or directory, if you only want to download a portion of the jQuery code.

If you have access to Git, you can connect to the repository here:

git clone git://github.com/jquery/jquery.git

You can also check out a specific version of jQuery from GitHub at:

git clone git://github.com/jquery/jquery.git
git checkout <version>
e.g. git checkout 1.2.6

If you want to build your own copy of jQuery from the Git repository, you will need to build it.

Note: The jQuery UI code is in its own Git repository:

git clone git://github.com/jquery/jquery-ui.git

Build Requirements

jQuery currently requires the following components to be installed:

  • A build system (either make or ant works):
    • make: Available on most Unix-based system (Unix, BSD, OSX, Cygwin)
    • ant: Available on any platform with JDK and ANT installed
  • java: A copy of Java, version 1.6.0 or later (required to build the minified version of jQuery).

Build Process

You will now need to use the build system that you chose previously - either make or ant.

If you're using make:

  • To create jQuery: make
    • This will create jquery.js and jquery.min.js in the dist directory

If you're using ant:

  • To create jQuery: ant
    • This will create jquery.js and jquery.min.js in the dist directory