ffffng/app/bower_components/jquery/README.md

63 lines
1.9 KiB
Markdown
Raw Normal View History

2017-05-13 13:25:33 +02:00
# jQuery
> jQuery is a fast, small, and feature-rich JavaScript library.
2022-08-02 15:24:19 +02:00
For information on how to get started and how to use jQuery, please see [jQuery's documentation](https://api.jquery.com/).
2017-05-13 13:25:33 +02:00
For source files and issues, please visit the [jQuery repo](https://github.com/jquery/jquery).
2022-08-02 15:24:19 +02:00
If upgrading, please see the [blog post for 3.6.0](https://blog.jquery.com/2021/03/02/jquery-3-6-0-released/). This includes notable differences from the previous version and a more readable changelog.
2017-05-13 13:25:33 +02:00
## Including jQuery
Below are some of the most common ways to include jQuery.
### Browser
#### Script tag
```html
2022-08-02 15:24:19 +02:00
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
2017-05-13 13:25:33 +02:00
```
#### Babel
2022-08-02 15:24:19 +02:00
[Babel](https://babeljs.io/) is a next generation JavaScript compiler. One of the features is the ability to use ES6/ES2015 modules now, even though browsers do not yet support this feature natively.
2017-05-13 13:25:33 +02:00
```js
import $ from "jquery";
```
#### Browserify/Webpack
2022-08-02 15:24:19 +02:00
There are several ways to use [Browserify](http://browserify.org/) and [Webpack](https://webpack.github.io/). For more information on using these tools, please refer to the corresponding project's documentation. In the script, including jQuery will usually look like this...
2017-05-13 13:25:33 +02:00
```js
2022-08-02 15:24:19 +02:00
var $ = require( "jquery" );
2017-05-13 13:25:33 +02:00
```
#### AMD (Asynchronous Module Definition)
2022-08-02 15:24:19 +02:00
AMD is a module format built for the browser. For more information, we recommend [require.js' documentation](https://requirejs.org/docs/whyamd.html).
2017-05-13 13:25:33 +02:00
```js
2022-08-02 15:24:19 +02:00
define( [ "jquery" ], function( $ ) {
2017-05-13 13:25:33 +02:00
2022-08-02 15:24:19 +02:00
} );
2017-05-13 13:25:33 +02:00
```
### Node
2022-08-02 15:24:19 +02:00
To include jQuery in [Node](https://nodejs.org/), first install with npm.
2017-05-13 13:25:33 +02:00
```sh
npm install jquery
```
2022-08-02 15:24:19 +02:00
For jQuery to work in Node, a window with a document is required. Since no such window exists natively in Node, one can be mocked by tools such as [jsdom](https://github.com/jsdom/jsdom). This can be useful for testing purposes.
2017-05-13 13:25:33 +02:00
```js
2022-08-02 15:24:19 +02:00
const { JSDOM } = require( "jsdom" );
const { window } = new JSDOM( "" );
const $ = require( "jquery" )( window );
2017-05-13 13:25:33 +02:00
```