You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# [jQuery](https://jquery.com/) — New Wave JavaScript
3
2
4
3
Meetings are currently held on the [matrix.org platform](https://matrix.to/#/#jquery_meeting:gitter.im).
5
4
6
5
Meeting minutes can be found at [meetings.jquery.org](https://meetings.jquery.org/category/core/).
7
6
8
-
Contribution Guides
9
-
--------------------------------------
7
+
The latest version of jQuery is available at [https://jquery.com/download/](https://jquery.com/download/).
8
+
9
+
## Version support
10
+
11
+
| Version | Branch | Status |
12
+
| ------- | ---------- | -------- |
13
+
| 4.x | main | Beta |
14
+
| 3.x | 3.x-stable | Active |
15
+
| 2.x | 2.x-stable | Inactive |
16
+
| 1.x | 1.x-stable | Inactive |
17
+
18
+
Once 4.0.0 final is released, the 3.x branch will continue to receive updates for a limited time. The 2.x and 1.x branches are no longer supported.
19
+
20
+
Commercial support for inactive versions is available from [HeroDevs](https://herodevs.com/nes).
21
+
22
+
Learn more about our [version support](https://jquery.com/support/).
23
+
24
+
## Contribution Guides
10
25
11
26
In the spirit of open source software development, jQuery always encourages community code contribution. To help you get started and before you jump into writing code, be sure to read these important contribution guidelines thoroughly:
12
27
@@ -20,16 +35,12 @@ GitHub issues/PRs are usually referenced via `gh-NUMBER`, where `NUMBER` is the
20
35
21
36
jQuery has used a different bug tracker - based on Trac - in the past, available under [bugs.jquery.com](https://bugs.jquery.com/). It is being kept in read only mode so that referring to past discussions is possible. When jQuery source references one of those issues, it uses the pattern `trac-NUMBER`, where `NUMBER` is the numerical ID of the issue. You can find such an issue under `https://bugs.jquery.com/ticket/NUMBER`.
- jQuery also supports Node, browser extensions, and other non-browser environments.
29
42
30
-
31
-
What you need to build your own jQuery
32
-
--------------------------------------
43
+
## What you need to build your own jQuery
33
44
34
45
To build jQuery, you need to have the latest Node.js/npm and git 1.7 or later. Earlier versions might work, but are not supported.
35
46
@@ -41,9 +52,7 @@ and `brew install node` to install Node.js.
41
52
Linux/BSD users should use their appropriate package managers to install git and Node.js, or build from source
42
53
if you swing that way. Easy-peasy.
43
54
44
-
45
-
How to build your own jQuery
46
-
----------------------------
55
+
## How to build your own jQuery
47
56
48
57
First, [clone the jQuery git repo](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository).
49
58
@@ -94,7 +103,7 @@ Some example modules that can be excluded or included are:
94
103
-**ajax/script**: The `<script>` AJAX transport only; used to retrieve scripts.
95
104
-**ajax/jsonp**: The JSONP AJAX transport only; depends on the ajax/script transport.
96
105
-**css**: The `.css()` method. Also removes **all** modules depending on css (including **effects**, **dimensions**, and **offset**).
97
-
-**css/showHide**: Non-animated `.show()`, `.hide()` and `.toggle()`; can be excluded if you use classes or explicit `.css()` calls to set the `display` property. Also removes the **effects** module.
106
+
-**css/showHide**: Non-animated `.show()`, `.hide()` and `.toggle()`; can be excluded if you use classes or explicit `.css()` calls to set the `display` property. Also removes the **effects** module.
98
107
-**deprecated**: Methods documented as deprecated but not yet removed.
99
108
-**dimensions**: The `.width()` and `.height()` methods, including `inner-` and `outer-` variations.
100
109
-**effects**: The `.animate()` method and its shorthands such as `.slideUp()` or `.hide("slow")`.
*Non-official custom builds are not regularly tested. Use them at your own risk.*
195
204
196
-
Running the Unit Tests
197
-
--------------------------------------
205
+
## Running the Unit Tests
198
206
199
207
Make sure you have the necessary dependencies:
200
208
@@ -208,22 +216,18 @@ Start `npm start` to auto-build jQuery as you work:
208
216
npm start
209
217
```
210
218
211
-
212
219
Run the unit tests with a local server that supports PHP. Ensure that you run the site from the root directory, not the "test" directory. No database is required. Pre-configured php local servers are available for Windows and Mac. Here are some options:
- Linux: [Setting up LAMP](https://www.linux.com/training-tutorials/easy-lamp-server-installation/)
As the source code is handled by the Git version control system, it's useful to know some features used.
225
229
226
-
### Cleaning ###
230
+
### Cleaning
227
231
228
232
If you want to purge your working directory back to the status of upstream, the following commands can be used (remember everything you've worked on is gone after these):
For feature/topic branches, you should always use the `--rebase` flag to `git pull`, or if you are usually handling many temporary "to be in a github pull request" branches, run the following to automate this:
238
242
239
243
```bash
240
244
git config branch.autosetuprebase local
241
245
```
246
+
242
247
(see `man git-config` for more information)
243
248
244
-
### Handling merge conflicts ###
249
+
### Handling merge conflicts
245
250
246
251
If you're getting merge conflicts when merging, instead of editing the conflicted files manually, you can use the feature
247
252
`git mergetool`. Even though the default tool `xxdiff` looks awful/old, it's rather useful.
248
253
249
254
The following are some commands that can be used there:
250
255
251
-
*`Ctrl + Alt + M` - automerge as much as possible
252
-
*`b` - jump to next merge conflict
253
-
*`s` - change the order of the conflicted lines
254
-
*`u` - undo a merge
255
-
*`left mouse button` - mark a block to be the winner
256
-
*`middle mouse button` - mark a line to be the winner
257
-
*`Ctrl + S` - save
258
-
*`Ctrl + Q` - quit
256
+
-`Ctrl + Alt + M` - automerge as much as possible
257
+
-`b` - jump to next merge conflict
258
+
-`s` - change the order of the conflicted lines
259
+
-`u` - undo a merge
260
+
-`left mouse button` - mark a block to be the winner
261
+
-`middle mouse button` - mark a line to be the winner
*Note*: QUnit's eventual addition of an argument to stop/start is ignored in this test suite so that start and stop can be passed as callbacks without worrying about their parameters.
Test Suite Convenience Methods Reference (See [test/data/testinit.js](https://github.com/jquery/jquery/blob/main/test/data/testinit.js))
290
-
------------------------------
292
+
See [test/data/testinit.js](https://github.com/jquery/jquery/blob/main/test/data/testinit.js).
291
293
292
-
### Returns an array of elements with the given IDs ###
294
+
### Returns an array of elements with the given IDs
293
295
294
296
```js
295
297
q( ... );
@@ -298,12 +300,12 @@ q( ... );
298
300
Example:
299
301
300
302
```js
301
-
q("main", "foo", "bar");
303
+
q("main", "foo", "bar");
302
304
303
305
=> [ div#main, span#foo, input#bar ]
304
306
```
305
307
306
-
### Asserts that a selection matches the given IDs ###
308
+
### Asserts that a selection matches the given IDs
t("Check for something", "//[a]", ["foo", "bar"]);
316
318
```
317
319
318
-
319
-
320
-
### Fires a native DOM event without going through jQuery ###
320
+
### Fires a native DOM event without going through jQuery
321
321
322
322
```js
323
-
fireNative( node, eventType )
323
+
fireNative( node, eventType );
324
324
```
325
325
326
326
Example:
327
327
328
328
```js
329
-
fireNative( jQuery("#elem")[0], "click" );
329
+
fireNative( jQuery("#elem" )[ 0], "click" );
330
330
```
331
331
332
-
### Add random number to url to stop caching ###
332
+
### Add random number to url to stop caching
333
333
334
334
```js
335
335
url( "some/url" );
@@ -338,18 +338,17 @@ url( "some/url" );
338
338
Example:
339
339
340
340
```js
341
-
url("index.html");
341
+
url("index.html");
342
342
343
343
=>"data/index.html?10538358428943"
344
344
345
345
346
-
url("mock.php?foo=bar");
346
+
url("mock.php?foo=bar");
347
347
348
348
=>"data/mock.php?foo=bar&10538358345554"
349
349
```
350
350
351
-
352
-
### Run tests in an iframe ###
351
+
### Run tests in an iframe
353
352
354
353
Some tests may require a document other than the standard test fixture, and
355
354
these can be run in a separate iframe. The actual test code and assertions
@@ -376,9 +375,7 @@ for this test, followed by the global `jQuery`, `window`, and `document` from
376
375
the iframe. If the iframe code passes any arguments to `startIframeTest`,
377
376
they follow the `document` argument.
378
377
379
-
380
-
Questions?
381
-
----------
378
+
## Questions?
382
379
383
380
If you have any questions, please feel free to ask on the
384
381
[Developing jQuery Core forum](https://forum.jquery.com/developing-jquery-core) or in #jquery on [libera](https://web.libera.chat/).
0 commit comments