JQuery/en: Difference between revisions
Updating to match new version of source page |
Updating to match new version of source page |
||
| (46 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
<languages/> |
<languages /> |
||
{{DISPLAYTITLE:jQuery}} |
{{DISPLAYTITLE:jQuery{{#translation:}}}} |
||
__NOTOC__ |
__NOTOC__ |
||
We have been shipping the '''jQuery''' JavaScript library with MediaWiki since the 1.17 release. |
|||
'''[[w:jQuery|jQuery]]''' is a {{ll|JavaScript|JavaScript}} library designed to simplify cross-browser development. |
|||
MediaWiki has included jQuery since version 1.16. |
|||
==Version== |
==Version== |
||
{| class="wikitable plainlinks |
{| class="wikitable plainlinks" |
||
|+ MediaWiki versions with the jQuery version used |
|||
! MediaWiki |
|||
|- |
|||
! jQuery |
|||
! scope="col" | MediaWiki |
|||
! Notes |
|||
! scope="col" | jQuery |
|||
! scope="col" | Notes |
|||
|- |
|- |
||
| {{Plainlist| |
|||
| {{ll|MediaWiki 1.25}} |
|||
* {{ll|MediaWiki 1.45}} |
|||
| jQuery 1.11.2 |
|||
* {{ll|MediaWiki 1.44}} |
|||
| {{git|d898e80fc5933172e5ed48bd53001591727666cc}} |
|||
* {{ll|MediaWiki 1.43}} |
|||
* {{ll|MediaWiki 1.42}} |
|||
* {{ll|MediaWiki 1.41}} |
|||
* {{ll|MediaWiki 1.40}}}} |
|||
|jQuery 3.7.1 |
|||
|{{git|I144069ce80127692b5c0ff91c4e55383f4013e2f}} |
|||
|- |
|- |
||
| {{ll|MediaWiki 1.39}} |
|||
|jQuery 3.6.1 |
|||
|{{git|Ic67517cc8abe683697a0e631d0ff449eaa6e24ea}} |
|||
|- style="vertical-align: top" |
|||
| {{plainlist| |
|||
* {{ll|MediaWiki 1.38}} |
|||
* {{ll|MediaWiki 1.37}} |
|||
* {{ll|MediaWiki 1.36}}}} |
|||
| jQuery 3.6.0 |
|||
| Including jQuery Migrate v3.3.2 |
|||
|- style="vertical-align: top" |
|||
| {{plainlist| |
|||
* {{ll|MediaWiki 1.35}} |
|||
* {{ll|MediaWiki 1.34}} |
|||
}} |
|||
| jQuery 3.4.1 |
|||
| Including jQuery Migrate v3.1.0 |
|||
|- style="vertical-align: top" |
|||
| {{plainlist| |
|||
* {{ll|MediaWiki 1.33}} |
|||
* {{ll|MediaWiki 1.32}} |
|||
}} |
|||
|jQuery 3.3.1 |
|||
| Including jQuery Migrate v3.0.1 |
|||
|- style="vertical-align: top" |
|||
| {{plainlist| |
|||
* {{ll|MediaWiki 1.31}} |
|||
* {{ll|MediaWiki 1.30}} |
|||
* {{ll|MediaWiki 1.29}} |
|||
}} |
|||
|jQuery 3.2.1 |
|||
| Including jQuery Migrate v3.0.0. See also {{ll|Manual:$wgUsejQueryThree|$wgUsejQueryThree}} (removed in MW 1.31) and {{task|T124742}}. |
|||
|- style="vertical-align: top" |
|||
| {{plainlist| |
|||
* {{ll|MediaWiki 1.28}} |
|||
* {{ll|MediaWiki 1.27}} |
|||
* {{ll|MediaWiki 1.26}} |
|||
* {{ll|MediaWiki 1.25}} |
|||
* {{ll|MediaWiki 1.24|MediaWiki 1.24.3}} |
|||
}} |
|||
| jQuery 1.11.3 |
|||
| {{git|d898e80fc5933172e5ed48bd53001591727666cc}}, {{git|acfa9695}} |
|||
|- style="vertical-align: top" |
|||
| {{ll|MediaWiki 1.24|MediaWiki 1.24.2}} |
|||
| jQuery 1.11.2 |
|||
| |
|||
|- style="vertical-align: top" |
|||
| {{ll|MediaWiki 1.24}} |
| {{ll|MediaWiki 1.24}} |
||
| jQuery 1.11.1 |
| jQuery 1.11.1 |
||
| {{git|e5502d1ffabab7784d85d}}, {{git|63c3650665313eede9d5f68c473bbc9c28e234d1}}, {{ |
| with jQuery Migrate {{git|e5502d1ffabab7784d85d}}, {{git|63c3650665313eede9d5f68c473bbc9c28e234d1}}, {{git|8e41082af8aa04d482}} |
||
|- style="vertical-align: top" |
|||
|- |
|||
| {{plainlist| |
|||
| {{ll|MediaWiki 1.21}} |
|||
* {{ll|MediaWiki 1.23}} |
|||
* {{ll|MediaWiki 1.22}} |
|||
* {{ll|MediaWiki 1.21}} |
|||
}} |
|||
| jQuery 1.8.3 |
| jQuery 1.8.3 |
||
| |
| |
||
|- style="vertical-align: top" |
|||
|- |
|||
| {{ll|MediaWiki 1.20}} |
| {{ll|MediaWiki 1.20}} |
||
| jQuery 1.8.2 |
| jQuery 1.8.2 |
||
| {{task|T31100}}, {{git|3b85ab0624afe5a53bb60c558f0bef4d6dfb43cd}},<br/>{{git|974fa832b4346a61d37250680a3c1e519f2c098b}}, {{git|d6bb1851a7329d66a5904ba27a9ea44687be4658}} |
| {{task|T31100}}, {{git|3b85ab0624afe5a53bb60c558f0bef4d6dfb43cd}},<br/> |
||
{{git|974fa832b4346a61d37250680a3c1e519f2c098b}}, {{git|d6bb1851a7329d66a5904ba27a9ea44687be4658}} |
|||
|- style="vertical-align: top" |
|||
|- |
|||
| {{ll|MediaWiki 1.19}} |
| {{ll|MediaWiki 1.19}} |
||
| jQuery 1.7.1 |
| jQuery 1.7.1 |
||
| {{r|105612}} |
| {{r|105612}} |
||
|- style="vertical-align: top" |
|||
|- |
|||
| {{ll|MediaWiki 1.18}} |
| {{ll|MediaWiki 1.18}} |
||
| jQuery 1.6.4 |
| jQuery 1.6.4 |
||
| {{task|T30904}}, {{task|T31773}}<br/>{{r|91845}}, {{r|92349}}, {{r|99231}}, {{r|99262}} |
| {{task|T30904}}, {{task|T31773}}<br/> |
||
{{r|91845}}, {{r|92349}}, {{r|99231}}, {{r|99262}} |
|||
|- style="vertical-align: top" |
|||
|- |
|||
| {{ll|MediaWiki 1.17}} |
| {{ll|MediaWiki 1.17}} |
||
| jQuery 1.4.2 |
| jQuery 1.4.2 |
||
| {{r|65962}} |
| {{r|65962}} |
||
|- style="vertical-align: top" |
|||
|- |
|||
| [[MediaWiki 1.16]] |
|||
| jQuery 1.3.2 |
|||
| |
|||
|} |
|} |
||
==jQuery Migrate== |
|||
The plugin jQuery Migrate helps developers to migrate from jQuery 1 to jQuery 3. The tracking task to remove these warnings and improve the underlying code is {{task|T169385}}. |
|||
Note that the stack traces are available together with the console log in modern browsers, to help to locate the origin of the deprecated function. |
|||
==ResourceLoader== |
==ResourceLoader== |
||
{{MW 1.17|and later}} |
{{MW 1.17|and later}} |
||
As of MediaWiki 1.17 all resources are (or should be) loaded through |
As of MediaWiki 1.17 all resources are (or should be) loaded through {{ll|ResourceLoader}}. |
||
The [[Special:MyLanguage/ResourceLoader/Core modules|core modules]] are stored in <code>/resources</code>. |
|||
There are no static minified versions anymore as ResourceLoader takes care of this when combining and optimizing all queued files. |
|||
All code can assume that jQuery has already been loaded. |
|||
However, if your site skin was created prior to 1.17, ResourceLoader will not be loaded and jQuery will not be available. |
However, if your site skin was created prior to 1.17, ResourceLoader will not be loaded and jQuery will not be available. |
||
==Before ResourceLoader== |
|||
{{MW 1.16|and earlier}} |
|||
MediaWiki 1.16 shipped with jQuery version 1.3.2 with some patches by [[User:Trevor Parscal|Trevor Parscal]] and [[User:Catrope|Roan Kattouw]] to fix jQuery bug [http://dev.jquery.com/ticket/5081 #5081] (see [[Special:Code/MediaWiki/60697|r60697]] and [[Special:Code/MediaWiki/61700|r61700]]). |
|||
In 1.16, the jQuery file is in <tt>skins/common/jquery.js</tt> and the minified version is <tt>jquery-min.js</tt> in the same directory. |
|||
Extensions can use OutputPage's includeJQuery method, which has existed since [[Special:Code/MediaWiki/61431|r61431]], to avoid loading minified version of jQuery core multiple times. It should be noted that includeJQuery does not support jQuery plugins and such. |
|||
To include it, paste the following at the bottom of {{ll|LocalSettings.php}}: |
|||
<syntaxhighlight lang="php" style="overflow:auto;"> |
|||
// Include jQuery |
|||
function wfIncludeJQuery() { |
|||
global $wgOut; |
|||
$wgOut->includeJQuery(); |
|||
} |
|||
$wgExtensionFunctions[] = 'wfIncludeJQuery'; |
|||
</syntaxhighlight> |
|||
=== MediaWiki 1.16: jQuery.noConflict=== |
|||
Please pay attention to the fact that, to avoid conflicts with other libraries (since it's not loaded by default in 1.16) jQuery will be loaded in [http://api.jquery.com/jQuery.noConflict/ noConflict()]-mode into <code>window.$j</code>. |
|||
You can use either <code>jQuery</code>, <code>$j</code> or something like the following to locally wrap-alias it: |
|||
<syntaxhighlight lang="javascript" style="overflow:auto;"> |
|||
( function ( $ ) { |
|||
// Simple scope wrap, where $ is available as alias for jQuery. |
|||
// Code here will be executed immediately |
|||
}( jQuery ) ); |
|||
/* or */ |
|||
jQuery( document ).ready( function ( $ ) { |
|||
// Code wrapped in this function will be executed when the document is ready |
|||
// When the document is ready, jQuery calls this callback function with itself as |
|||
// first parameter, allowing you to locally alias it (e.g. as "$") |
|||
} ); |
|||
</syntaxhighlight> |
|||
==See also== |
==See also== |
||
* {{ll|Upstream projects|2=Upstream projects}} |
|||
* {{ll|Learning JavaScript|2=Learning JavaScript}} |
|||
*[[Special:MyLanguage/:Category:Snippets with JavaScript|jQuery snippets]] |
|||
*[[Special:MyLanguage/ |
*[[Special:MyLanguage/Category:Snippets with JavaScript|jQuery snippets]] |
||
==External links== |
==External links== |
||
*[ |
*[https://jquery.com jQuery.com, the official jQuery site] |
||
*[http://www.n8williams.com/devblog/javascript_and_ajax/jquery-dialog-error-in-ie7-runtime-error-invalid-argument jQuery Dialog error in IE7. Runtime error: invalid argument - The Dev Pages] — the reason why we patched our jQuery |
|||
[[Category:MediaWiki |
[[Category:MediaWiki development{{#translation:}}]] |
||
[[Category:JavaScript{{#translation:}}]] |
|||
Latest revision as of 00:52, 7 March 2026
Warning: Display title "jQuery/en" overrides earlier display title "JQuery".
jQuery is a JavaScript library designed to simplify cross-browser development.
MediaWiki has included jQuery since version 1.16.
Version
| MediaWiki | jQuery | Notes |
|---|---|---|
| jQuery 3.7.1 | git #I144069c | |
| MediaWiki 1.39 | jQuery 3.6.1 | git #Ic67517c |
| jQuery 3.6.0 | Including jQuery Migrate v3.3.2 | |
| jQuery 3.4.1 | Including jQuery Migrate v3.1.0 | |
| jQuery 3.3.1 | Including jQuery Migrate v3.0.1 | |
| jQuery 3.2.1 | Including jQuery Migrate v3.0.0. See also $wgUsejQueryThree (removed in MW 1.31) and T124742. | |
| jQuery 1.11.3 | git #d898e80f, git #acfa9695 | |
| MediaWiki 1.24.2 | jQuery 1.11.2 | |
| MediaWiki 1.24 | jQuery 1.11.1 | with jQuery Migrate git #e5502d1f, git #63c36506, git #8e41082a |
| jQuery 1.8.3 | ||
| MediaWiki 1.20 | jQuery 1.8.2 | T31100, git #3b85ab06, |
| MediaWiki 1.19 | jQuery 1.7.1 | r105612 |
| MediaWiki 1.18 | jQuery 1.6.4 | T30904, T31773 |
| MediaWiki 1.17 | jQuery 1.4.2 | r65962 |
| MediaWiki 1.16 | jQuery 1.3.2 |
jQuery Migrate
The plugin jQuery Migrate helps developers to migrate from jQuery 1 to jQuery 3. The tracking task to remove these warnings and improve the underlying code is T169385.
Note that the stack traces are available together with the console log in modern browsers, to help to locate the origin of the deprecated function.
ResourceLoader
| MediaWiki version: | ≥ 1.17 |
As of MediaWiki 1.17 all resources are (or should be) loaded through ResourceLoader.
The core modules are stored in /resources.
There are no static minified versions anymore as ResourceLoader takes care of this when combining and optimizing all queued files.
All code can assume that jQuery has already been loaded.
However, if your site skin was created prior to 1.17, ResourceLoader will not be loaded and jQuery will not be available.