:JQuery

{{Short description|JavaScript software library}}

{{lowercase title}}

{{Use mdy dates|date=September 2021}}

{{Infobox software

| name = jQuery

| logo = 220px

| author = John Resig

| developer = [https://jquery.org/team/ The jQuery Team]

| released = {{start date and age|2006|08|26}}

| latest release version = 3.7.1

| latest release date = ({{start date and age|2023|08|28}}){{Cite web|url=https://blog.jquery.com/2023/08/28/jquery-3-7-1-released-reliable-table-row-dimensions/|title=jQuery 3.7.1 Released: Reliable Table Row Dimensions | Official jQuery Blog|date=August 28, 2023}}

| latest preview version = 4.0.0-beta.2

| latest preview date = {{start date and age|2024|07|17}}{{Cite web|url=https://blog.jquery.com/2024/07/17/second-beta-of-jquery-4-0-0/|title=Second Beta of jQuery 4.0.0 | Official jQuery Blog|date=July 17, 2024}}

| programming language = JavaScript

| platform = See {{Section link||Browser support}}

| genre = JavaScript library

| license = MIT

| website = {{URL|https://jquery.com}}

| size = 27–274 KB{{Cite web|title=Open-source Libraries and File Sizes - PageCDN|url=https://pagecdn.com/public-cdn/lib-sizes|access-date=2020-07-21| website=pagecdn.com|language=en}}

}}

jQuery is a JavaScript library designed to simplify HTML DOM tree traversal and manipulation, as well as event handling, CSS animations, and Ajax.{{cite web|url=http://jquery.com/|title=jQuery: The write less, do more, JavaScript library|publisher=The jQuery Project|access-date=29 April 2010}} It is free, open-source software using the permissive MIT License.{{cite web|url=https://github.com/jquery/jquery/blob/master/LICENSE.txt|title=jQuery Project License|publisher=jQuery Foundation|access-date=2017-03-11}} {{as of|August 2022}}, jQuery is used by 77% of the 10 million most popular websites.{{cite web |title=Usage of JavaScript libraries for websites |url=https://w3techs.com/technologies/overview/javascript_library/all |url-status=live |archive-url=https://web.archive.org/web/20191115172736/https://w3techs.com/technologies/overview/javascript_library |archive-date=2019-11-15 |access-date=2019-11-15 |website=W3Techs |language=en-US |quote=jQuery (74.1%) is 3.7 times more popular than Bootstrap (19.9%).}} Web analysis indicates that it is the most widely deployed JavaScript library by a large margin, having at least three to four times more usage than any other JavaScript library.{{cite web|url=https://libscore.com/#libs|title=Libscore|archive-url=https://web.archive.org/web/20170219042532/https://libscore.com/|archive-date=2017-02-19|access-date=2017-02-11|quote=Top scripts are 1. jQuery (692,981 sites); 2. jQuery UI (193,680 sites); 3. Facebook SDK (175,369 sites); 4. Twitter Bootstrap JS (158,288 sites); 5. Modernizr (155,503 sites).}}

jQuery's syntax is designed to make it easier to navigate a document, select DOM elements, create animations, handle events, and develop Ajax applications. jQuery also provides capabilities for developers to create plug-ins on top of the JavaScript library. This enables developers to create abstractions for low-level interaction and animation, advanced effects and high-level, theme-able widgets. The modular approach to the jQuery library allows the creation of powerful dynamic web pages and Web applications.

The set of jQuery core features—DOM element selections, traversal, and manipulation—enabled by its selector engine (named "Sizzle" from v1.3), created a new "programming style", fusing algorithms and DOM data structures. This style influenced the architecture of other JavaScript frameworks like YUI v3 and Dojo, later stimulating the creation of the standard Selectors API."[https://www.w3.org/TR/selectors-api/#queryselector Selectors API Level 1, W3C Recommendation]" (21 February 2013). This standard turned what was jQuery "helper methods" into JavaScript-native ones, and the wide use of jQuery stimulated the [https://caniuse.com/queryselector fast adoption] of querySelector/querySelectorAll into main Web browsers.

Microsoft and Nokia bundle jQuery on their platforms.{{cite web |url=http://jquery.com/blog/2008/09/28/jquery-microsoft-nokia/ |title=jQuery, Microsoft, and Nokia |date=2008-09-28 |last=Resig |first=John |publisher=jQuery |work=jQuery Blog |access-date=2009-01-29 }} Microsoft includes it with Visual Studio{{cite web |url=https://weblogs.asp.net/scottgu/jquery-and-microsoft |title=jQuery and Microsoft |last=Guthrie |first=Scott |work=ScottGu's Blog |date=2008-09-28 |access-date=2019-04-15 }} for use within Microsoft's ASP.NET AJAX and ASP.NET MVC frameworks while Nokia has integrated it into the Web Run-Time widget development platform.{{cite web|url=http://wiki.forum.nokia.com/index.php/Guarana_UI:_a_jQuery-Based_UI_Library_for_Nokia_WRT|title=Guarana UI: A jQuery Based UI Library for Nokia WRT|work=Forum Nokia|archive-url=https://web.archive.org/web/20110816054350/http://www.developer.nokia.com/Community/Wiki/Guarana_UI:_a_jQuery-Based_UI_Library_for_Nokia_WRT|archive-date=2011-08-16|url-status=dead|access-date=2010-03-30}}

Overview

jQuery, at its core, is a Document Object Model (DOM) manipulation library. The DOM is a tree-structure representation of all the elements of a Web page. jQuery simplifies the syntax for finding, selecting, and manipulating these DOM elements. For example, jQuery can be used for finding an element in the document with a certain property (e.g. all elements with the h1 tag), changing one or more of its attributes (e.g. color, visibility), or making it respond to an event (e.g. a mouse click).

jQuery also provides a paradigm for event handling that goes beyond basic DOM element selection and manipulation. The event assignment and the event callback function definition are done in a single step in a single location in the code. jQuery also aims to incorporate other highly used JavaScript functionality (e.g. fade ins and fade outs when hiding elements, animations by manipulating CSS properties).

The principles of developing with jQuery are:

  • Separation of JavaScript and HTML: The jQuery library provides simple syntax for adding event handlers to the DOM using JavaScript, rather than adding HTML event attributes to call JavaScript functions. Thus, it encourages developers to completely separate JavaScript code from HTML markup.
  • Brevity and clarity: jQuery promotes brevity and clarity with features like "chainable" functions and shorthand function names.
  • Elimination of cross-browser incompatibilities: The JavaScript engines of different browsers differ slightly so JavaScript code that works for one browser may not work for another. Like other JavaScript toolkits, jQuery handles all these cross-browser inconsistencies and provides a consistent interface that works across different browsers.
  • Extensibility: New events, elements, and methods can be easily added and then reused as a plugin.

History

jQuery was originally created in January 2006 at BarCamp NYC by John Resig, influenced by Dean Edwards' earlier cssQuery library.{{cite book | last=York | first=Richard | title=Beginning JavaScript and CSS Development with jQuery | page=28 | publisher=Wiley | isbn=978-0-470-22779-4 | year=2009 | url=https://books.google.com/books?id=L9otyT4crSQC&pg=PA515}}{{cite web

| url=https://www.slideshare.net/jeresig/history-of-jquery

| title=History of jQuery

| date=2007-10-31

| last=Resig|first=John

| access-date=2019-04-15}} It is currently maintained by a team of developers led by Timmy Willison (with the jQuery selector engine, Sizzle, being led by Richard Gibson).{{Cite web|url=https://jquery.org/team/|title=The jQuery Team|website=jquery.com|publisher=JS Foundation|language=en-US|access-date=2019-05-22|quote=Team: Timmy Willison (jQuery Core Lead), Richard Gibson (Sizzle Lead, jQuery Core).}}

jQuery was originally licensed under the CC BY-SA 2.5, and relicensed to the MIT License in 2006.[https://blog.jquery.com/2006/05/27/jquery-under-the-mit-license/ jquery-under-the-mit-license] on jquery.org (2006) At the end of 2006, it was dual-licensed under GPL and MIT licenses.[https://web.archive.org/web/20100301130833/http://jquery.org/license license] on jquery.org (archived 2010) As this led to some confusion, in 2012 the GPL was dropped and is now only licensed under the MIT license.{{Cite web |last= |first= |date=2012-09-10 |title=jQuery Licensing Changes |url=https://blog.jquery.com/2012/09/10/jquery-licensing-changes/ |access-date= |website=jQuery Blog |language=en}}

= Popularity =

  • In 2015, jQuery was used on 62.7% of the top 1 million websites (according to BuiltWith), and 17% of all Internet websites.{{Cite web|url=https://www.maxcdn.com/blog/maxscale-jquery/|title=Handling 15,000 requests per second: The Growth Behind jQuery|date=20 June 2015|website=www.maxcdn.com|publisher=MaxCDN|language=en-US|access-date=2018-07-02|archive-date=July 2, 2018|archive-url=https://web.archive.org/web/20180702093146/https://www.maxcdn.com/blog/maxscale-jquery/|url-status=dead}}
  • In 2017, jQuery was used on 69.2% of the top 1 million websites (according to Libscore).
  • In 2018, jQuery was used on 78% of the top 1 million websites.{{Cite web|url=https://trends.builtwith.com/javascript/jQuery|title=jQuery Usage Statistics (Dec 2019)|date=2019-12-31|website=trends.builtwith.com|language=en|url-status=dead|archive-url=https://web.archive.org/web/20200221204800/https://trends.builtwith.com/javascript/jQuery|archive-date=2020-02-21|access-date=2020-02-21}}
  • In 2019, jQuery was used on 80% of the top 1 million websites (according to BuiltWith), and 74.1% of the top 10 million (per W3Techs).
  • In 2021, jQuery was used on 77.8% of the top 10 million websites (according to W3Techs).{{Cite web|url=https://w3techs.com/technologies/overview/javascript_library|title=Usage Statistics and Market Share of JavaScript Libraries (February 2020)|date=2020-02-21|website=W3Techs|url-status=live|archive-url=https://web.archive.org/web/20200221205251/https://w3techs.com/technologies/overview/javascript_library|archive-date=2020-02-21|access-date=2020-02-21}}

Features

jQuery includes the following features:

  • DOM element selections using the multi-browser open source selector engine Sizzle, a spin-off of the jQuery project{{cite web |title=jQuery 1.3 and the jQuery Foundation |url=https://blog.jquery.com/2009/01/14/jquery-13-and-the-jquery-foundation/ |last=Resig |first=John |date=2009-01-14 |work=jQuery Blog | access-date=2009-05-04 }}
  • DOM manipulation based on CSS selectors that uses elements' names and attributes, such as id and class, as criteria to select nodes in the DOM
  • Events
  • Effects and animations
  • Ajax
  • Deferred and Promise objects to control asynchronous processing
  • JSON parsing
  • Extensibility through plug-ins
  • Utilities, such as feature detection
  • Compatibility methods that are natively available in modern browsers, but need fallbacks for old browsers, such as jQuery.inArray() and jQuery.each().
  • Cross-browser support

=Browser support=

jQuery 3.0 and newer supports "current−1 versions" (meaning the current stable version of the browser and the version that preceded it) of Firefox (and ESR), Chrome, Safari, and Edge as well as Internet Explorer 9 and newer. On mobile it supports iOS 7 and newer, and Android 4.0 and newer.[//jquery.com/browser-support/ Browser Support | jQuery]

Distribution

The jQuery library is typically distributed as a single JavaScript file that defines all its interfaces, including DOM, Events, and Ajax functions. It can be included within a Web page by linking to a local copy or by linking to one of the many copies available from public servers. jQuery has a content delivery network (CDN) hosted by MaxCDN.{{cite web|url=https://code.jquery.com/|title=jQuery CDN|first=jQuery Foundation -|last=jquery.org}} Google in Google Hosted Libraries service and Microsoft host the library as well.{{cite web|url=https://code.google.com/apis/ajaxlibs/documentation/#jquery |title=Google Libraries API - Developer's Guide |access-date=March 11, 2012}}{{cite web | url=https://docs.microsoft.com/en-us/aspnet/ajax/cdn/overview | title=Microsoft Ajax Content Delivery Network | publisher=Microsoft Corporation | work=ASP.net | access-date=2019-04-15}}

Example of linking a copy of the library locally (from the same server that hosts the Web page):

Example of linking a copy of the library from jQuery's public CDN:

src="https://code.jquery.com/jquery-3.5.1.min.js"

integrity="sha256-9/aliU8dGd2tb6OSsuzixeV4y/faTqgFtohetphbbj0="

crossorigin="anonymous">

Interface

=Functions=

jQuery provides two kinds of functions, static utility functions and jQuery object methods. Each has its own usage style.

Both are accessed through jQuery's main identifier: jQuery. This identifier has an alias named $.{{Cite web|url=https://api.jquery.com/jQuery/|title=jQuery() {{!}} jQuery API Documentation|last=js.foundation|first=JS Foundation -|website=api.jquery.com|language=en-US|access-date=2018-07-02}} All functions can be accessed through either of these two names.

== jQuery methods ==

The jQuery function is a factory for creating a jQuery object that represents one or more DOM nodes. jQuery objects have methods to manipulate these nodes. These methods (sometimes called commands), are chainable as each method also returns a jQuery object.

Access to and manipulation of multiple DOM nodes in jQuery typically begins with calling the $ function with a CSS selector string. This returns a jQuery object referencing all the matching elements in the HTML page. $("div.test"), for example, returns a jQuery object with all the div elements that have the class test. This node set can be manipulated by calling methods on the returned jQuery object.

== Static utilities ==

These are utility functions and do not directly act upon a jQuery object. They are accessed as static methods on the jQuery or $ identifier. For example, $.ajax() is a static method.

=No-conflict mode=

jQuery provides a $.noConflict() function, which relinquishes control of the $ name. This is useful if jQuery is used on a Web page also linking another library that demands the $ symbol as its identifier. In no-conflict mode, developers can use jQuery as a replacement for $ without losing functionality.{{cite web|url=http://api.jquery.com/jquery.noconflict/| title=jQuery.noConflict() jQuery API Documentation}}

=Typical start-point=

Typically, jQuery is used by putting initialization code and event handling functions in $(handler). This is triggered by jQuery when the browser has finished constructing the DOM for the current Web page.

$(function () {

// This anonymous function is called when the page has completed loading.

// Here, one can place code to create jQuery objects, handle events, etc.

});

or

$(fn); // The function named fn, defined elsewhere, is called when the page has loaded.

Historically, $(document).ready(callback) has been the de facto idiom for running code after the DOM is ready. However, since jQuery 3.0, developers are encouraged to use the much shorter $(handler) signature instead.{{cite web|url=https://jquery.com/upgrade-guide/3.0/#deprecated-document-ready-handlers-other-than-jquery-function|title=jQuery Core 3.0 Upgrade Guide - jQuery|first=jQuery Foundation -|last=jquery.org}}

=Chaining=

jQuery object methods typically also return a jQuery object, which enables the use of method chains:

$('div.test')

.on('click', handleTestClick)

.addClass('foo');

This line finds all div elements with class attribute test , then registers an event handler on each element for the "click" event, then adds the class attribute foo to each element.

Certain jQuery object methods retrieve specific values (instead of modifying a state). An example of this is the val() method, which returns the current value of a text input element. In these cases, a statement such as $('#user-email').val() cannot be used for chaining as the return value does not reference a jQuery object.

=Creating new DOM elements=

Besides accessing existing DOM nodes through jQuery, it is also possible to create new DOM nodes, if the string passed as the argument to $() factory looks like HTML. For example, the below code finds an HTML select element, and creates a new option element with the value VAG and the label Volkswagen, which is then appended to the select menu:

$('select#car-brands')

.append($('

.prop(value,"VAG")

.text('Volkswagen')

);

=Ajax=

It is possible to make Ajax requests (with cross-browser support) with $.ajax() to load and manipulate remote data.

$.ajax({

type: 'POST',

url: '/process/submit.php',

data: {

name : 'John',

location : 'Boston',

},

}).then(function(msg) {

alert('Data Saved: ' + msg);

}).catch(function(xmlHttpRequest, statusText, errorThrown) {

alert(

'Your form submission failed.\n\n'

+ 'XML Http Request: ' + JSON.stringify(xmlHttpRequest)

+ ',\nStatus Text: ' + statusText

+ ',\nError Thrown: ' + errorThrown);

});

This example posts the data name=John and location=Boston to /process/submit.php on the server. When this request finishes the success function is called to alert the user. If the request fails it will alert the user to the failure, the status of the request, and the specific error.

The above example uses the .then() and .catch() methods to register callbacks that run when the response has completed. These promise callbacks must be used due to the asynchronous nature of Ajax requests.

jQuery plug-ins

jQuery's architecture allows developers to create plug-in code to extend its function. There are thousands of jQuery plug-ins available on the Web{{cite web|title=Plugins|url=https://plugins.jquery.com/|publisher=The jQuery Project|access-date=2019-04-15}} that cover a range of functions, such as Ajax helpers, Web services, datagrids, dynamic lists, XML and XSLT tools, drag and drop, events, cookie handling, and modal windows.

An important source of jQuery plug-ins is the plugins sub-domain of the jQuery Project website. The plugins in this subdomain, however, were accidentally deleted in December 2011 in an attempt to rid the site of spam.{{cite web|url=https://blog.jquery.com/2011/12/08/what-is-happening-to-the-jquery-plugins-site/#pluginstldr|title=What Is Happening To The jQuery Plugins Site?|work=jQuery Blog|access-date=22 April 2015}} The new site is a GitHub-hosted repository, which required developers to resubmit their plugins and to conform to new submission requirements.{{cite web|url=https://github.com/jquery/plugins.jquery.com|title=jquery/plugins.jquery.com|work=GitHub|access-date=22 April 2015}} jQuery provides a "Learning Center" that can help users understand JavaScript and get started developing jQuery plugins.{{cite web|title=jQuery Learning Center|url=http://learn.jquery.com/|publisher=jQuery Foundation |access-date=2014-07-02}}

Release history

class="wikitable sortable"
Version

! Initial release

! Latest update

! Minified size (KB)

! Additional notes

1.0

| {{start date|2006|08|26}}

|

|

| First stable release

1.1

| {{start date|2007|01|14}}

|

|

|

1.2

| {{start date|2007|09|10}}

| 1.2.6

| 54.5

|

1.3

| {{start date|2009|01|14}}

| 1.3.2

| 55.9

| Sizzle Selector Engine introduced into core

1.4

| {{start date|2010|01|14}}

| 1.4.4

| 76.7

|

1.5

| {{start date|2011|01|31}}

| 1.5.2

| 83.9

| Deferred callback management, ajax module rewrite

1.6

| {{start date|2011|05|03}}

| 1.6.4 ({{start date|2011|09|12}}){{cite web |title=jQuery 1.6.4 Released|url=https://blog.jquery.com/2011/09/12/jquery-1-6-4-released/ |date=12 Sep 2011 |work=jQuery Blog}}

| 89.5

| Significant performance improvements to the attr() and val() functions

1.7

| {{start date|2011|11|03}}

| 1.7.2 ({{start date|2012|03|21}}){{cite web |title=jQuery 1.7.2 Released |url=https://blog.jquery.com/2012/03/21/jquery-1-7-2-released/ |date=21 Mar 2012 |work=jQuery Blog}}

| 92.6

| New Event APIs: .on() and .off(), while the old APIs are still supported.

1.8

| {{start date|2012|08|09}}

| 1.8.3 ({{start date|2012|11|13}}){{cite web |title=jQuery 1.8.3 Released |url=https://blog.jquery.com/2012/11/13/jquery-1-8-3-released/ |date=13 Nov 2012 |work=jQuery Blog}}

| 91.4

| Sizzle Selector Engine rewritten, improved animations and $(html, props) flexibility.

1.9

| {{start date|2013|01|15}}

| 1.9.1 ({{start date|2013|02|04}}){{cite web |title=jQuery 1.9.1 Released |url=https://blog.jquery.com/2013/02/04/jquery-1-9-1-released/ |date=4 Feb 2013 |work=jQuery Blog}}

| 90.5

| Removal of deprecated interfaces and code cleanup

1.10

| {{start date|2013|05|24}}

| 1.10.2 ({{start date|2013|07|03}}){{cite web |title=jQuery 1.10.2 and 2.0.3 Released |url=https://blog.jquery.com/2013/07/03/jquery-1-10-2-and-2-0-3-released/ |date=3 Jul 2013 |work=jQuery Blog}}

| 90.9

| Incorporated bug fixes and differences reported from both the 1.9 and 2.0 beta cycles

1.11

| {{start date|2014|01|24}}

| 1.11.3 ({{start date|2015|04|28}}){{cite web |title=jQuery 1.11.3 and 2.1.4 Released – iOS Fail-Safe Edition |url=https://blog.jquery.com/2015/04/28/jquery-1-11-3-and-2-1-4-released-ios-fail-safe-edition/ |date=28 Apr 2015 |work=jQuery Blog}}

| 93.7

|

1.12

| {{start date|2016|01|08}}

| 1.12.4 ({{start date|2016|05|20}}){{cite web |title=jQuery 1.12.4 and 2.2.4 Released |url=https://blog.jquery.com/2016/05/20/jquery-1-12-4-and-2-2-4-released/ |date=20 May 2016 |work=jQuery Blog}}

| 94.9

|

2.0

| {{start date|2013|04|18}}

| 2.0.3 ({{start date|2013|07|03}})

| 81.7

| Dropped IE 6–8 support for performance improvements and reduction in filesize

2.1

| {{start date|2014|01|24}}

| 2.1.4 ({{start date|2015|04|28}})

| 82.4

|

2.2

| {{start date|2016|01|08}}

| 2.2.4 ({{start date|2016|05|20}})

| 83.6

|

3.0

| {{start date|2016|6|9}}{{cite web|url=https://www.infoq.com/news/2016/06/jQuery-3|title=Long-awaited jQuery 3.0 Brings Slim Build|last=Chesters|first=James|date=2016-06-15|publisher=infoq.com|access-date=2017-01-28}}

| 3.0.0 ({{start date|2016|6|9}})

| 84.3

| Promises/A+ support for Deferreds, $.ajax and $.when, .data() HTML5-compatible

3.1

| {{start date|2016|7|7}}

| 3.1.1 ({{start date|2016|9|23}})

| 84.7

| jQuery.readyException added, ready handler errors are now not silenced

3.2

| {{start date|2017|3|16}}{{cite web|title=jQuery 3.2.0 Is Out!|work=jQuery Blog|url=https://blog.jquery.com/2017/03/16/jquery-3-2-0-is-out/|access-date=12 March 2018|date=16 March 2017}}

| 3.2.1 ({{start date|2017|3|20}})

| 84.6

| Added support for retrieving contents of