Twitter Search

" ).append( - "
• Refresh
" + - "
• Remove
" + - "
• Collapse
" - ); -}; - -$.fn.twitterResult.events = { - refresh: function( e ) { - - // Indicate that the results are refreshing - var elem = $( this ).addClass( "refreshing" ); - - elem.find( "p.tweet" ).remove(); - results.append( "

Loading...

" ); - - // Get the twitter data using jsonp - $.getJSON( "http://search.twitter.com/search.json?q=" + escape( e.data.term ) + "&rpp=5&callback=?", function( json ) { - elem.trigger( "populate", [ json ] ); - }); - }, - - populate: function( e, json ) { - var results = json.results; - var elem = $( this ); - - elem.find( "p.loading" ).remove(); - $.each( results, function( i, result ) { - var tweet = "

" + - "" + - result.from_user + - ": " + - result.text + - " " + - result.created_at + - "" + - "

"; - - elem.append( tweet ); - }); - - // Indicate that the results are done refreshing - elem.removeClass("refreshing"); - }, - - remove: function( e, force ) { - if ( !force && !confirm( "Remove panel for term " + e.data.term + "?" ) ) { - return; - } - $( this ).remove(); - - // Indicate that we no longer have a panel for the term - search_terms[ e.data.term ] = 0; - }, - - collapse: function( e ) { - $( this ).find( "li.collapse" ) - .removeClass( "collapse" ) - .addClass( "expand" ) - .text( "Expand" ); - - $( this ).addClass( "collapsed" ); - }, - - expand: function( e ) { - $( this ).find( "li.expand" ) - .removeClass( "expand" ) - .addClass( "collapse" ) - .text( "Collapse" ); - - $( this ).removeClass( "collapsed" ); - } -}; -``` - -The Twitter container itself will have just two custom events: - -* `getResults` — Receives a search term and checks to determine whether there's already a results container for the term; if not, adds a results container using the results template, set up the results container using the `$.fn.twitterResult` plugin discussed above, and then triggers the `refresh` event on the results container in order to actually load the results. Finally, it will store the search term so the application knows not to re-fetch the term. - -* `getTrends` — Queries Twitter for the top 10 trending terms, then iterates over them and triggers the `getResults` event for each of them, thereby adding a results container for each term. - -Here's how the Twitter container bindings look: - -``` -$( "#twitter" ).on( "getResults", function( e, term ) { - - // Make sure we don't have a box for this term already - if ( !search_terms[ term ] ) { - var elem = $( this ); - var template = elem.find( "div.template" ); - - // Make a copy of the template div - // and insert it as the first results box - results = template.clone() - .removeClass( "template" ) - .insertBefore( elem.find( "div:first" ) ) - .twitterResult({ - "term": term - }); - - // Load the content using the "refresh" - // custom event that we bound to the results container - results.trigger( "refresh" ); - - search_terms[ term ] = 1; - } -}).on( "getTrends", function( e ) { - var elem = $( this ); - - $.getJSON( "http://search.twitter.com/trends.json?callback=?", function( json ) { - var trends = json.trends; - $.each( trends, function( i, trend ) { - elem.trigger( "getResults", [ trend.name ] ); - }); - }); -}); -``` - -So far, we've written a lot of code that does approximately nothing, but that's OK. By specifying all the behaviors that we want our core objects to have, we've created a solid framework for rapidly building out the interface. - -Let's start by hooking up our text input and the "Load Trending Terms" button. For the text input, we'll capture the term that was entered in the input and pass it as we trigger the Twitter container's `getResults` event. Clicking the "Load Trending Terms" will trigger the Twitter container's `getTrends` event: - -``` -$( "form" ).submit(function( event ) { - var term = $( "#search_term" ).val(); - $( "#twitter" ).trigger( "getResults", [ term ] ); - event.preventDefault(); -}); - -$( "#get_trends" ).click(function() { - $( "#twitter" ).trigger( "getTrends" ); -}); -``` - -By adding a few buttons with the appropriate ID's, we can make it possible to remove, collapse, expand, and refresh all results containers at once, as shown below. For the remove button, note how we're passing a value of `true` to the event handler as its second argument, telling the event handler that we don't want to verify the removal of individual containers. - -``` -$.each([ "refresh", "expand", "collapse" ], function( i, ev ) { - $( "#" + ev ).click( function( e ) { - $( "#twitter div.results" ).trigger( ev ); - }); -}); - -$( "#remove" ).click(function( e ) { - if ( confirm( "Remove all results?" ) ) { - $( "#twitter div.results" ).trigger( "remove", [ true ] ); - } -}); -``` - ### Conclusion Custom events offer a new way of thinking about your code: they put the emphasis on the target of a behavior, not on the element that triggers it. If you take the time at the outset to spell out the pieces of your application, as well as the behaviors those pieces need to exhibit, custom events can provide a powerful way for you to "talk" to those pieces, either one at a time or en masse. Once the behaviors of a piece have been described, it becomes trivial to trigger those behaviors from anywhere, allowing for rapid creation of and experimentation with interface options. Finally, custom events can enhance code readability and maintainability, by making clear the relationship between an element and its behaviors. From aef941e30f99739dbd4eed7ed7f7d6fbf5fe7696 Mon Sep 17 00:00:00 2001 From: Arthur Verschaeve Date: Sat, 28 Feb 2015 16:45:48 +0100 Subject: [PATCH 10/91] 0.6.7 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 15800e46..79ae6b8d 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.6", + "version": "0.6.7", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From f9572e24766d362eb66ab818f5c24dc8384d376f Mon Sep 17 00:00:00 2001 From: Arthur Verschaeve Date: Sun, 1 Mar 2015 10:16:03 +0100 Subject: [PATCH 11/91] Effects: Merge 2 articles on queues Fixes gh-77 Closes gh-633 --- order.json | 3 +- page/effects/queue-and-dequeue-explained.md | 122 ++++++++--- page/effects/uses-of-queue-and-dequeue.md | 214 -------------------- 3 files changed, 93 insertions(+), 246 deletions(-) delete mode 100644 page/effects/uses-of-queue-and-dequeue.md diff --git a/order.json b/order.json index 8527b06a..ee998761 100644 --- a/order.json +++ b/order.json @@ -59,8 +59,7 @@ "effects": [ "intro-to-effects", "custom-effects", - "queue-and-dequeue-explained", - "uses-of-queue-and-dequeue" + "queue-and-dequeue-explained" ] }, { diff --git a/page/effects/queue-and-dequeue-explained.md b/page/effects/queue-and-dequeue-explained.md index c527d75f..b72cfaec 100644 --- a/page/effects/queue-and-dequeue-explained.md +++ b/page/effects/queue-and-dequeue-explained.md @@ -4,53 +4,115 @@ "source": "http://jqueryfordesigners.com/api-queue-dequeue/" } -When you use the `.animate()`, `.show()`, `.hide()`, `.slideUp()`, etc. effect methods, you're adding a job to the effects queue. By default, using `.queue()` and passing a function, will add it to the effects queue. So we're creating our own bespoke animation step: +Queues are the foundation for all animations in jQuery, they allow a series functions to be executed asynchronously on an element. Methods such as `.slideUp()`, `.slideDown()`, `.fadeIn()`, and `.fadeOut()` all use `.animate()`, which leverages *queues* to build up the series of steps that will transition one or more CSS values throughout the duration of the animation. + +We can pass a callback function to the `.animate()` method, which will execute once the animation has completed. ``` $( ".box" ) - .animate({ + .animate( { height: 20 - }, "slow" ) - .queue(function() { - $( "#title" ).html( "We're in the animation, baby!" ); - }); + }, "slow", function() { + $( "#title" ).html( "We're in the callback, baby!" ); + } ); ``` -As I said though, these methods come in pairs, so anything you add using `.queue()`, you need to dequeue to allow the process to continue. In the code above, if I chained more animations on, until I call `$( this ).dequeue()`, the subsequent animations wouldn't run: +## Queues As Callbacks + +Instead of passing a callback as an argument, we can add another function to the *queue* that will act as our callback. This will execute after all of the steps in the animation have completed. ``` $( ".box" ) - .animate({ + .animate( { height: 20 - }, "slow" ) - .queue(function() { + }, "slow") + .queue( function() { $( "#title" ).html( "We're in the animation, baby!" ); + + // This tells jQuery to continue to the next item in the queue $( this ).dequeue(); - }).animate({ - height: 150 - }); + } ); + ``` -Keeping in mind that the animation won't continue until we've explicitly called `.dequeue()`, we can easily create a pausing plugin, by adding a step in the queue that sets a timer and triggers after `delay` milliseconds, at which time, it dequeues the element: +In this example, the queued function will execute right after the animation. + +jQuery does not have any insight into how the queue items function, so we need to call `.dequeue()`, which tells jQuery when to move to the next item in the queue. +Another way of *dequeuing* is by calling the function that is passed to your callback. That function will automatically call `.dequeue()` for you. + +``` +.queue( function( next ) { + console.log( "I fired!" ); + next(); +} ); ``` -$.fn.pause = function( delay ) { - return this.queue(function() { - var elem = this; - setTimeout(function() { - return $( elem ).dequeue(); - }, delay ); - }); -}; +## Custom Queues + +Up to this point all of our animation and queue examples have been using the default queue name which is `fx`. Elements can have multiple queues attached to them, and we can give each of these queues a different name. We can specify a custom queue name as the first argument to the `.queue()` method. + +``` $( ".box" ) - .animate({ - height: 20 - }, "slow" ) - .pause( 1000 ) - .animate({ - height: 150 - }); + .queue( "steps", function( next ) { + console.log( "Step 1" ); + next(); + } ) + .queue( "steps", function( next ) { + console.log( "Step 2" ); + next(); + } ) + .dequeue( "steps" ); +``` + +Notice that we have to call the `.dequeue()` method passing it the name of our custom queue to start the execution. Every queue except for the default, `fx`, has to be manually kicked off by calling `.dequeue()` and passing it the name of the queue. + +## Clearing The Queue + +Since queues are just a set of ordered operations, our application may have some logic in place that needs to prevent the remaining queue entries from executing. We can do this by calling the `.clearQueue()` method, which will empty the queue. + +``` +$( ".box" ) + .queue( "steps", function( next ) { + console.log( "Will never log because we clear the queue" ); + next(); + } ) + .clearQueue( "steps" ) + .dequeue( "steps" ); +``` + +In this example, nothing will happen as we removed everything from the `steps` queue. + +Another way of clearing the queue is to call `.stop( true )`. That will stop the currently running animations and will clear the queue. + +## Replacing The Queue + +When you pass an array of functions as second argument to `.queue()`, that array will replace the queue. + +``` +$( ".box" ) + .queue( "steps", function( next ) { + console.log( "I will never fire as we totally replace the queue" ); + next(); + } ) + .queue( "steps", [ + function( next ) { + console.log( "I fired!" ); + next(); + } + ] ) + .dequeue( "steps" ); +``` + +You can also call `.queue()` without passing it functions, which will return the queue of that element as an array. + ``` +$( ".box" ).queue( "steps", function( next ) { + console.log( "I fired!" ); + next(); +} ); -Remember that the first argument for `.queue()` and `.dequeue()` is `fx`, and that in all of these examples I'm not including it because jQuery sets the argument to `fx` by default — so I don't have to specify it. +console.log( $( ".box" ).queue( "steps" ) ); + +$( ".box" ).dequeue( "steps" ); +``` diff --git a/page/effects/uses-of-queue-and-dequeue.md b/page/effects/uses-of-queue-and-dequeue.md deleted file mode 100644 index edc04b98..00000000 --- a/page/effects/uses-of-queue-and-dequeue.md +++ /dev/null @@ -1,214 +0,0 @@ - - -Queues in jQuery are used for animations. You can use them for any purpose you like. They are an array of functions stored on a per element basis, using `jQuery.data()`. They are First In, First Out (FIFO). You can add a function to the queue by calling `.queue()`, and you remove (by calling) the functions using `.dequeue()`. - -To understand the internal jQuery queue functions, reading the source and looking at examples helps me out tremendously. One of the best examples of a queue function I've seen is `.delay()`: - -``` -$.fn.delay = function( time, type ) { - time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; - type = type || "fx"; - - return this.queue( type, function( next, hooks ) { - var timeout = setTimeout( next, time ); - hooks.stop = function() { - clearTimeout( timeout ); - }; - }); -}; -``` - -## The default queue – fx - -The default queue in jQuery is `fx`. The default queue has some special properties that are not shared with other queues. - -* Auto Start: When calling `$(elem).queue( function() {} );` the fx queue will automatically dequeue the next function and run it if the queue hasn't started. -* "inprogress" sentinel: Whenever you `dequeue()` a function from the fx queue, it will `unshift()` (push into the first location of the array) the string "inprogress" — which flags that the queue is currently being run. -* It's the default! The fx queue is used by `.animate()` and all functions that call it by default. - -**Note:** If you are using a custom queue, you must manually `.dequeue()` the functions, they will not auto start! - -## Retrieving/Setting the queue - -You can retrieve a reference to a jQuery queue by calling `.queue()` without a function argument. You can use the method if you want to see how many items are in the queue. You can use `push`, `pop`, `unshift`, and `shift` to manipulate the queue in place. You can replace the entire queue by passing an array to the `.queue()` function. - -## Quick Examples: - -``` -// Assume elem is a jQuery object that contains an element we are animating -var queue = elem.queue(); - -// Remove the last function from the animation queue -var lastFunc = queue.pop(); - -// Insert it at the beginning -queue.unshift( lastFunc ); - -// Replace queue with the first three items in the queue -elem.queue( queue.slice( 0, 3 ) ); -``` - -### An animation (fx) queue example: - -``` -$(function() { - - // Let's do something with Google Maps - var canvas = $( "#map_canvas" ); - - var latlng = new google.maps.LatLng( -34.397, 150.644 ); - - var options = { - zoom: 8, - center: latlng, - mapTypeId: google.maps.MapTypeId.ROADMAP - }; - - var geocoder = new google.maps.Geocoder(); - - var map = new google.maps.Map( canvas[0], options ); - - var resized = function() { - - // Simple animation callback - let maps know we resized - google.maps.event.trigger( map, "resize" ); - }; - - // Wait for two seconds - canvas.delay( 2000 ); - - // Resize the div - canvas.animate({ - width: 250, - height: 250, - marginLeft: 250, - marginTop:250 - }, resized ); - - // Geocode something - canvas.queue(function( next ) { - - // Find Stack Overflow's whois address - geocoder.geocode( { - address: "55 Broadway New York NY 10006" - }, handleResponse ); - - function handleResponse( results, status ) { - if ( status === google.maps.GeocoderStatus.OK ) { - var location = results[ 0 ].geometry.location; - map.setZoom( 13 ); - map.setCenter( location ); - new google.maps.Marker({ - map: map, - position: location - }); - } - - // Geocoder result returned, continue with animations - next(); - } - }); - - // After we find Stack Overflow, wait 3 more seconds - canvas.delay( 3000 ); - - // Then resize the map again - canvas.animate({ - width: 500, - height: 500, - marginLeft:0, - marginTop: 0 - }, resized ); -}); -``` - -### Queueing something like Ajax Calls: - -``` -// jQuery on an empty object, we are going to use this as our queue -var ajaxQueue = $({}); - -$.ajaxQueue = function( ajaxOpts ) { - - // Hold the original complete function - var oldComplete = ajaxOpts.complete; - - // Queue our ajax request - ajaxQueue.queue(function( next ) { - - // Create a complete callback to invoke the next event in the queue - ajaxOpts.complete = function() { - - // Invoke the original complete if it was there - if ( oldComplete ) { - oldComplete.apply( this, arguments ); - } - - // Run the next query in the queue - next(); - }; - - // Run the query - $.ajax( ajaxOpts ); - }); -}; - -// Get each item we want to copy -$( "#items li" ).each(function( idx ) { - - // Queue up an ajax request - $.ajaxQueue({ - url: "/ajax_html_echo/", - data: { - html: "[" + idx + "] " + $( this ).html() - }, - type: "POST", - success: function( data ) { - - // Write to #output - $( "#output" ).append( $( "
• ", { - html: data - })); - } - }); -}); -``` - -### Another custom queue example - -``` -// jQuery on an empty object - a perfect queue holder -var theQueue = $({}); - -$.each([ 1, 2, 3 ], function( i, num ) { - - // Add some really simple functions to a queue - theQueue.queue( "alerts", function( next ) { - - // Show something, and if the user clicks "yes", run the next function - if ( confirm( "index: " + i + " = " + num + "\nRun the next function?" ) ) { - next(); - } - }); -}); - -// Create a button to run the queue -$( "", { - text: "Run Queue", - click: function() { - theQueue.dequeue( "alerts" ); - } -}).appendTo( "body" ); - -// Create a button to show the length -$( "", { - text: "Show Length", - click: function() { - alert( theQueue.queue( "alerts" ).length ); - } -}).appendTo( "body" ); -``` From b5da8f9fd337c82852a7e1560634a29cf3afee2f Mon Sep 17 00:00:00 2001 From: Arthur Verschaeve Date: Wed, 11 Mar 2015 07:08:26 +0100 Subject: [PATCH 12/91] 0.6.8 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 79ae6b8d..f434ae9c 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.7", + "version": "0.6.8", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 97e44cd22476d9106f188e9744272940bc52f55e Mon Sep 17 00:00:00 2001 From: Daniel Jost Date: Tue, 10 Mar 2015 21:43:58 -0700 Subject: [PATCH 13/91] Stateful Plugins: Update widget factory for jQuery UI 1.9+ Closes gh-639 --- page/plugins/stateful-plugins-with-widget-factory.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/page/plugins/stateful-plugins-with-widget-factory.md b/page/plugins/stateful-plugins-with-widget-factory.md index 3f306d83..9f2c18ae 100644 --- a/page/plugins/stateful-plugins-with-widget-factory.md +++ b/page/plugins/stateful-plugins-with-widget-factory.md @@ -257,7 +257,7 @@ $.nmk.progressbar.prototype.reset = function() { ### Cleaning Up -In some cases, it will make sense to allow users to apply and then later unapply your plugin. You can accomplish this via the `destroy` method. Within the `destroy` method, you should undo anything your plugin may have done during initialization or later use. The `destroy` method is automatically called if the element that your plugin instance is tied to is removed from the DOM, so this can be used for garbage collection as well. The default `destroy` method removes the link between the DOM element and the plugin instance, so it's important to call the base function from your plugin's `destroy` method. +In some cases, it will make sense to allow users to apply and then later unapply your plugin. You can accomplish this via the `_destroy` method. Within the `_destroy` method, you should undo anything your plugin may have done during initialization or later use. The `_destroy` method is automatically called if the element that your plugin instance is tied to is removed from the DOM, so this can be used for garbage collection as well. The base `destroy` method calls `_destroy` on the plugin instance. Adding a destroy method to a widget: @@ -286,13 +286,10 @@ $.widget( "nmk.progressbar", { } }, - destroy: function() { + _destroy: function() { this.element .removeClass( "progressbar" ) .text( "" ); - - // Call the base destroy function. - $.Widget.prototype.destroy.call( this ); } }); From 334a91038d225719c4532bc6dfd4ac7172bddd24 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Thu, 12 Mar 2015 08:21:43 -0400 Subject: [PATCH 14/91] 0.6.9 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index f434ae9c..71e5c0fb 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.8", + "version": "0.6.9", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From c6ef9a09ce067fbffbde70ddd2cdbb59b45d6ca9 Mon Sep 17 00:00:00 2001 From: Acho Arnold Date: Sat, 28 Mar 2015 13:55:19 +0100 Subject: [PATCH 15/91] Events: Fix broken links Closes gh-646 --- page/events/event-extensions.md | 2 +- page/jquery-ui/theming.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/page/events/event-extensions.md b/page/events/event-extensions.md index 53ab9b00..f94bf178 100644 --- a/page/events/event-extensions.md +++ b/page/events/event-extensions.md @@ -27,7 +27,7 @@ Although jQuery's event system is oriented towards delivering DOM events to DOM ### jQuery.event.props: Array -jQuery defines an [Event object](http://api.jquery.com/jQuery.Event/) that represents a cross-browser subset of the information available when an event occurs. The `jQuery.event.props` property is an array of string names for properties that are always copied when jQuery processes a *native* browser event. (Events fired in code by `.trigger()` do not use this list, since the code can construct a `jQuery.Event` object with the needed values and trigger using that object.) +jQuery defines an [Event object](https://api.jquery.com/category/events/event-object/) that represents a cross-browser subset of the information available when an event occurs. The `jQuery.event.props` property is an array of string names for properties that are always copied when jQuery processes a *native* browser event. (Events fired in code by `.trigger()` do not use this list, since the code can construct a `jQuery.Event` object with the needed values and trigger using that object.) To add a property name to this list, use `jQuery.event.props.push( "newPropertyName" )`. However, be aware that every event processed by jQuery will now attempt to copy this property name from the native browser event to jQuery's constructed event. If the property does not exist for that event type, it will get an undefined value. Adding many properties to this list can significantly reduce event delivery performance, so for infrequently-needed properties it is more efficient to use the value directly from `event.originalEvent` instead. If properties must be copied, you are strongly advised to use `jQuery.event.fixHooks` as of version 1.7. diff --git a/page/jquery-ui/theming.md b/page/jquery-ui/theming.md index 00456d23..ba8d5602 100644 --- a/page/jquery-ui/theming.md +++ b/page/jquery-ui/theming.md @@ -7,7 +7,7 @@ All jQuery UI plugins are designed to allow a developer to seamlessly integrate The jQuery UI CSS Framework provide semantic presentation classes to indicate the role of an element within a widget such as a header, content area, or clickable region. These are applied consistently across all widgets so a clickable tab, accordion, or button will all have the same `ui-state-default` class applied to indicate that it is clickable. When a user mouses over one of these elements, this class is changed to `ui-state-hover`, then `ui-state-active` when selected. This level of class consistency makes it easy to ensure that all elements with a similar role or interaction state will look the same across all widgets. -The CSS Framework styles are encapsulated in a single file called `theme.css` and this is the file modified by the [ThemeRoller](/jquery-ui/theming/themeroller/) application. Framework styles only include attributes that affect the look and feel (primarily color, background images, and icons) so these are "safe" styles that will not affect functionality of individual plugins. This separation means that a developer can create a custom look and feel by modifying the colors and images in the `theme.css` file and know that as future plugins or bug fixes become available, these should work with the theme without modification. +The CSS Framework styles are encapsulated in a single file called `theme.css` and this is the file modified by the [ThemeRoller](/jquery-ui/themeroller/) application. Framework styles only include attributes that affect the look and feel (primarily color, background images, and icons) so these are "safe" styles that will not affect functionality of individual plugins. This separation means that a developer can create a custom look and feel by modifying the colors and images in the `theme.css` file and know that as future plugins or bug fixes become available, these should work with the theme without modification. Since the framework styles only cover look and feel, plugin specific stylesheets are separated. These contain all the additional structural style rules required to make the widget functional, such as dimensions, padding, margins, positioning, and floats. When downloading jQuery UI, these can be found in `jquery-ui.structure.css`. @@ -17,6 +17,6 @@ We encourage all developers creating jQuery plugins to leverage the jQuery UI CS There are three general approaches to theming jQuery UI plugins: -* **Download a ThemeRoller theme**: The easiest way to build a theme is to use [ThemeRoller](/jquery-ui/theming/themeroller/) to generate and download a theme. This app will create a new `jquery-ui.theme.css` file and an `images` directory containing all necessary background images and icon sprites which can simply be dropped into your project. This approach will be the easiest to create and maintain but limits customization to the options provided in ThemeRoller. +* **Download a ThemeRoller theme**: The easiest way to build a theme is to use [ThemeRoller](/jquery-ui/themeroller/) to generate and download a theme. This app will create a new `jquery-ui.theme.css` file and an `images` directory containing all necessary background images and icon sprites which can simply be dropped into your project. This approach will be the easiest to create and maintain but limits customization to the options provided in ThemeRoller. * **Modify the CSS files**: To get a bit more control over the look and feel, you may choose to start with the default theme (Smoothness) or a ThemeRoller-generated theme and then adjust the `jquery-ui.theme.css` file or any of the individual plugin stylesheets. For example, you could easily tweak the corner radius for all buttons to be different than the rest of the UI components or change the path for the icon sprite to use a custom set. With a bit of style scoping, you can even use multiple themes together in a single UI. To keep maintenance simple, restricting changes to just the `jquery-ui.theme.css` file and images is recommended. * **Write completely custom CSS**: For the greatest amount of control, the CSS for each plugin can be written from scratch without using the framework classes or plugin-specific stylesheet. This may be necessary if the desired look and feel can't be achieved by modifying the CSS or if highly customized markup is used. This approach requires deep expertise in CSS and will require manual updates for future plugins. From 366325805892e6a8bffc16fddc1820e1d5ef154a Mon Sep 17 00:00:00 2001 From: Arthur Verschaeve Date: Sat, 28 Mar 2015 14:59:20 +0100 Subject: [PATCH 16/91] 0.6.10 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 71e5c0fb..c904fc87 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.9", + "version": "0.6.10", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 60cd0f1c1c5a28e672dae8003e2c68c515468908 Mon Sep 17 00:00:00 2001 From: Eric Lee Carraway Date: Mon, 6 Apr 2015 16:36:51 -0500 Subject: [PATCH 17/91] Ajax Events: Fix two typos Closes gh-648 --- page/ajax/ajax-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/page/ajax/ajax-events.md b/page/ajax/ajax-events.md index 1c5dbad8..5cc70bfb 100644 --- a/page/ajax/ajax-events.md +++ b/page/ajax/ajax-events.md @@ -5,7 +5,7 @@ "attribution": [ "jQuery Fundamentals" ] } -Often, you'll want to perform an operation whenever an Ajax requests starts or stops, such as showing or hiding a loading indicator. Rather than defining this behavior inside every Ajax request, you can bind Ajax events to elements just like you'd bind other events. For a complete list of Ajax events, visit [Ajax Events documentation on docs.jquery.com](http://docs.jquery.com/Ajax_Events). +Often, you'll want to perform an operation whenever an Ajax request starts or stops, such as showing or hiding a loading indicator. Rather than defining this behavior inside every Ajax request, you can bind Ajax events to elements just like you'd bind other events. For a complete list of Ajax events, visit [Ajax Events documentation on docs.jquery.com](http://docs.jquery.com/Ajax_Events). ``` // Setting up a loading indicator using Ajax Events From fc48992f2eb61c4901cf21385c464071850e6e5e Mon Sep 17 00:00:00 2001 From: Arthur Verschaeve Date: Tue, 7 Apr 2015 09:26:46 +0200 Subject: [PATCH 18/91] 0.6.11 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index c904fc87..35f95195 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.10", + "version": "0.6.11", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 8bc77a565cac7146680c82474c83b31f956d5017 Mon Sep 17 00:00:00 2001 From: Acho Arnold Date: Sun, 29 Mar 2015 23:50:28 +0100 Subject: [PATCH 19/91] All: fix some unnecessary redirects Closes gh-649 --- CONTRIBUTING.md | 2 +- page/effects/custom-effects.md | 2 +- page/events/handling-events.md | 4 ++-- page/events/history-of-events.md | 2 +- page/events/introduction-to-events.md | 2 +- page/events/triggering-event-handlers.md | 4 ++-- page/jquery-ui/getting-started.md | 4 ++-- page/jquery-ui/themeroller.md | 2 +- page/plugins/finding-evaluating-plugins.md | 2 +- page/style-guide.md | 4 ++-- page/using-jquery-core/manipulating-elements.md | 2 +- 11 files changed, 15 insertions(+), 15 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2ff46f70..428978e3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -81,7 +81,7 @@ For more advice on managing your fork and submitting pull requests to the jQuery ### Formatting Articles -Yes! Take a look at our [style guide](http://learn.jquery.com/style-guide) for more information on authoring and formatting conventions. +Yes! Take a look at our [style guide](http://learn.jquery.com/style-guide/) for more information on authoring and formatting conventions.

  Getting Help

  diff --git a/page/effects/custom-effects.md b/page/effects/custom-effects.md index 350a6ce0..082f827c 100644 --- a/page/effects/custom-effects.md +++ b/page/effects/custom-effects.md @@ -25,7 +25,7 @@ $( "div.funtimes" ).animate( ); ``` -**Note:** Color-related properties cannot be animated with `.animate()` using jQuery out of the box. Color animations can easily be accomplished by including the [color plugin](http://github.com/jquery/jquery-color). We'll discuss using plugins later in the book. +**Note:** Color-related properties cannot be animated with `.animate()` using jQuery out of the box. Color animations can easily be accomplished by including the [color plugin](https://github.com/jquery/jquery-color). We'll discuss using plugins later in the book. ### Easing diff --git a/page/events/handling-events.md b/page/events/handling-events.md index 61f180b9..9f809553 100644 --- a/page/events/handling-events.md +++ b/page/events/handling-events.md @@ -5,7 +5,7 @@ "attribution": [ "jQuery Fundamentals" ] } -jQuery provides a method `.on()` to respond to any event on the selected elements. This is called an _event binding_. Although `.on()` isn't the only method provided for event binding, it is a best practice to use this for jQuery 1.7+. To learn more, [read more about the evolution of event binding in jQuery](/events/history-of-events). +jQuery provides a method `.on()` to respond to any event on the selected elements. This is called an _event binding_. Although `.on()` isn't the only method provided for event binding, it is a best practice to use this for jQuery 1.7+. To learn more, [read more about the evolution of event binding in jQuery](/events/history-of-events/). The `.on()` method provides several useful features: @@ -138,4 +138,4 @@ $( "p" ).off( "click", bar ); ### Namespacing Events -For complex applications and for plugins you share with others, it can be useful to namespace your events so you don't unintentionally disconnect events that you didn't or couldn't know about. For details, see [Event Namespacing](/event-basics#namespacing-events). +For complex applications and for plugins you share with others, it can be useful to namespace your events so you don't unintentionally disconnect events that you didn't or couldn't know about. For details, see [Event Namespacing](/events/event-basics/#namespacing-events). diff --git a/page/events/history-of-events.md b/page/events/history-of-events.md index 605e6ced..280749bf 100644 --- a/page/events/history-of-events.md +++ b/page/events/history-of-events.md @@ -32,7 +32,7 @@ It is possible to use `.bind()` and attach a handler to every element. });​​​​​​​​​​​​​​​​​​​​​ ``` -As discussed in the [event delegation](/event/event-delegation) article, this is not optimal. +As discussed in the [event delegation](/event/event-delegation/) article, this is not optimal. ### liveQuery *liveQuery* was a popular jQuery plugin that allowed for the creation of events which would be triggered for elements that existed now or in the future. This plugin did not use event delegation and used expensive CPU processing to poll the DOM for changes every 20ms and fire events accordingly. diff --git a/page/events/introduction-to-events.md b/page/events/introduction-to-events.md index 25ba1b24..f066dd48 100644 --- a/page/events/introduction-to-events.md +++ b/page/events/introduction-to-events.md @@ -12,7 +12,7 @@ Web pages are all about interaction. Users perform a countless number of actions ## What's a DOM event? -As mentioned, there are a myriad of event types, but perhaps the ones that are easiest to understand are user events, like when someone clicks on an element or types into a form. These types of events occur on an element, meaning that when a user clicks on a button for example, the button has had an event occur on it. While user interactions aren't the only types of DOM events, they're certainly the easiest to understand when starting out. Mozilla Developer Network has a good reference of [available DOM events](https://developer.mozilla.org/en/DOM/DOM_event_reference). +As mentioned, there are a myriad of event types, but perhaps the ones that are easiest to understand are user events, like when someone clicks on an element or types into a form. These types of events occur on an element, meaning that when a user clicks on a button for example, the button has had an event occur on it. While user interactions aren't the only types of DOM events, they're certainly the easiest to understand when starting out. Mozilla Developer Network has a good reference of [available DOM events](https://developer.mozilla.org/en-US/docs/Web/Events). ## Ways to listen for events diff --git a/page/events/triggering-event-handlers.md b/page/events/triggering-event-handlers.md index c7366f28..99d3a3a3 100644 --- a/page/events/triggering-event-handlers.md +++ b/page/events/triggering-event-handlers.md @@ -22,7 +22,7 @@ $( "a" ).trigger( "click" ); ## How can I mimic a native browser event, if not `.trigger()`? -In order to trigger a native browser event, you have to use [document.createEventObject](http://msdn.microsoft.com/en-us/library/ie/ms536390%28v=vs.85%29.aspx) for < IE9 and [document.createEvent](https://developer.mozilla.org/en/DOM/document.createEvent) for all other browsers. Using these two APIs, you can programmatically create an event that behaves exactly as if someone has actually clicked on a file input box. The default action will happen, and the browse file dialog will display. +In order to trigger a native browser event, you have to use [document.createEventObject](http://msdn.microsoft.com/en-us/library/ie/ms536390%28v=vs.85%29.aspx) for < IE9 and [document.createEvent](https://developer.mozilla.org/en-US/docs/Web/API/Document/createEvent) for all other browsers. Using these two APIs, you can programmatically create an event that behaves exactly as if someone has actually clicked on a file input box. The default action will happen, and the browse file dialog will display. The jQuery UI Team created [jquery.simulate.js](https://github.com/jquery/jquery-simulate/) in order to simplify triggering a native browser event for use in their automated testing. Its usage is modeled after jQuery's trigger. @@ -43,7 +43,7 @@ There are four differences between `.trigger()` and `.triggerHandler()` 3. `.triggerHandler()` will not cause the default behavior of the event (such as a form submission). 4. Events triggered by `.triggerHandler()`, will not bubble up the DOM hierarchy. Only the handlers on the single element will fire. -For more information see the [triggerHandler documentation](http://api.jquery.com/triggerHandler) +For more information see the [triggerHandler documentation](http://api.jquery.com/triggerHandler/) ## Don't use `.trigger()` simply to execute specific functions diff --git a/page/jquery-ui/getting-started.md b/page/jquery-ui/getting-started.md index 865fc1cb..b32a53dc 100644 --- a/page/jquery-ui/getting-started.md +++ b/page/jquery-ui/getting-started.md @@ -111,8 +111,8 @@ When you click the "Download theme" button in ThemeRoller, you'll be directed to ### Support: Where Can I Get Help? -JQuery UI user and developer resources are kept up-to-date at the [Support Center](http://jqueryui.com/support). +JQuery UI user and developer resources are kept up-to-date at the [Support Center](http://jqueryui.com/support/). ### Developers Wanted! -Want to join the jQuery UI team? We'd love your help! Visit the UI [Development Center](http://jqueryui.com/development) for details on how to get involved. +Want to join the jQuery UI team? We'd love your help! Visit the UI [Development Center](http://jqueryui.com/development/) for details on how to get involved. diff --git a/page/jquery-ui/themeroller.md b/page/jquery-ui/themeroller.md index bae47368..096dd226 100644 --- a/page/jquery-ui/themeroller.md +++ b/page/jquery-ui/themeroller.md @@ -7,7 +7,7 @@ ### About ThemeRoller -ThemeRoller is a web app that offers a fun and intuitive interface for designing and downloading custom themes for jQuery UI. You can find ThemeRoller in the "Themes" section of the jQuery UI site, or by following this link: [jQuery UI ThemeRoller](http://jqueryui.com/themeroller) +ThemeRoller is a web app that offers a fun and intuitive interface for designing and downloading custom themes for jQuery UI. You can find ThemeRoller in the "Themes" section of the jQuery UI site, or by following this link: [jQuery UI ThemeRoller](http://jqueryui.com/themeroller/)   diff --git a/page/plugins/finding-evaluating-plugins.md b/page/plugins/finding-evaluating-plugins.md index abc48008..266176ac 100644 --- a/page/plugins/finding-evaluating-plugins.md +++ b/page/plugins/finding-evaluating-plugins.md @@ -11,6 +11,6 @@ The quality of jQuery plugins varies widely. Many plugins are extensively tested The easiest way to find plugins is to search Google or the [jQuery Plugins Registry](http://plugins.jquery.com/). Once you've identified some options, you may want to consult the [jQuery forums](http://forum.jquery.com/) or the `#jquery` IRC channel to get input from others. -When looking for a plugin to fill a need, do your homework. Ensure that the plugin is well-documented, and look for the author to provide lots of examples of its use. Be wary of plugins that do far more than you need; they can end up adding substantial overhead to your page. For more tips on spotting a sub-par plugin, read [Signs of a poorly written jQuery plugin](http://remysharp.com/2010/06/03/signs-of-a-poorly-written-jquery-plugin/) by Remy Sharp. +When looking for a plugin to fill a need, do your homework. Ensure that the plugin is well-documented, and look for the author to provide lots of examples of its use. Be wary of plugins that do far more than you need; they can end up adding substantial overhead to your page. For more tips on spotting a sub-par plugin, read [Signs of a poorly written jQuery plugin](https://remysharp.com/2010/06/03/signs-of-a-poorly-written-jquery-plugin/) by Remy Sharp. Once you choose a plugin, you'll need to add it to your page. Download the plugin, unzip it if necessary, place it within your application's directory structure, then include the plugin in your page using a script tag (after you include jQuery). diff --git a/page/style-guide.md b/page/style-guide.md index 8e5c4a2e..1d1db266 100644 --- a/page/style-guide.md +++ b/page/style-guide.md @@ -11,7 +11,7 @@ ## Formatting Conventions -Articles in the learn site are authored with [GitHub Flavored Markdown](http://github.github.com/github-flavored-markdown/), and the beginning of each article contains some JSON "front matter" that contains metadata used when the article is published. +Articles in the learn site are authored with [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/), and the beginning of each article contains some JSON "front matter" that contains metadata used when the article is published. ### Article Header Metadata @@ -106,7 +106,7 @@ Content should be educational and accessible to a broad audience of developers. - Link to the jQuery blog or API documentation when necessary. - Use inline hyperlinks to reference relevant content. - Acceptable external resources: - - [Mozilla Developer Network](https://developer.mozilla.org/) + - [Mozilla Developer Network](https://developer.mozilla.org/en-US/) - [Webplatform.org](http://www.webplatform.org/) - [htmldog.com](http://www.htmldog.com/) diff --git a/page/using-jquery-core/manipulating-elements.md b/page/using-jquery-core/manipulating-elements.md index 720f51de..d3fe9db1 100644 --- a/page/using-jquery-core/manipulating-elements.md +++ b/page/using-jquery-core/manipulating-elements.md @@ -9,7 +9,7 @@ For complete documentation of jQuery manipulation methods, visit the [Manipulati ## Getting and Setting Information About Elements -There are many ways to change an existing element. Among the most common tasks is changing the inner HTML or attribute of an element. jQuery offers simple, cross-browser methods for these sorts of manipulations. You can also get information about elements using many of the same methods in their getter incarnations. For more information on getters and setters, see the [Working with Selections](/working-with-selections/) section. Here are a few methods you can use to get and set information about elements: +There are many ways to change an existing element. Among the most common tasks is changing the inner HTML or attribute of an element. jQuery offers simple, cross-browser methods for these sorts of manipulations. You can also get information about elements using many of the same methods in their getter incarnations. For more information on getters and setters, see the [Working with Selections](/using-jquery-core/working-with-selections/) section. Here are a few methods you can use to get and set information about elements: * **`.html()`** – Get or set the HTML contents. * **`.text()`** – Get or set the text contents; HTML will be stripped. From 012d7abfb239de6b2086ea803dd9533ea42d6f75 Mon Sep 17 00:00:00 2001 From: Arthur Verschaeve Date: Fri, 17 Apr 2015 21:27:11 +0200 Subject: [PATCH 20/91] 0.6.12 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 35f95195..08bf2fc0 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.11", + "version": "0.6.12", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 5eaa3121114ae31a3c0341445a3c04a50112def1 Mon Sep 17 00:00:00 2001 From: Anne Hawley Brett Date: Mon, 8 Jun 2015 17:18:32 -0400 Subject: [PATCH 21/91] Using jQuery: Clarifies distinctions between getter and setter methods Fixes gh-655 Closes gh-656 --- page/using-jquery-core/working-with-selections.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/page/using-jquery-core/working-with-selections.md b/page/using-jquery-core/working-with-selections.md index 9f5348bc..86c45401 100644 --- a/page/using-jquery-core/working-with-selections.md +++ b/page/using-jquery-core/working-with-selections.md @@ -5,16 +5,18 @@ ### Getters & Setters -jQuery "overloads" its methods, so the method used to set a value generally has the same name as the method used to get a value. When a method is used to set a value, it's called a setter. When a method is used to get (or read) a value, it's called a getter. Setters affect all elements in a selection. Getters get the requested value only for the first element in the selection. +Some jQuery methods can be used to either assign or read some value on a selection. When the method is called with a value as an argument, it's referred to as a setter because it sets (or assigns) that value. When the method is called with no argument, it gets (or reads) the value of the element. Setters affect all elements in a selection, whereas getters return the requested value only for the first element in the selection, with the exception of [`.text()`](http://api.jquery.com/text/), which retrieves the values of all the elements. ``` -// The .html() method used as a setter: +// The .html() method sets all the h1 elements' html to be "hello world": $( "h1" ).html( "hello world" ); ``` ``` -// The .html() method used as a getter: +// The .html() method returns the html of the first h1 element: $( "h1" ).html(); +// > "hello world" + ``` Setters return a jQuery object, allowing you to continue calling jQuery methods on your selection. Getters return whatever they were asked to get, so you can't continue to call jQuery methods on the value returned by the getter. From a7e7d4d58b11989440e92c3d1ffcfcb128c6bb35 Mon Sep 17 00:00:00 2001 From: Corey Frang Date: Mon, 8 Jun 2015 19:28:18 -0400 Subject: [PATCH 22/91] 0.6.13 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 08bf2fc0..23068ff7 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.12", + "version": "0.6.13", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 3754358c761ce54932015cf66ef2faa40b16fc93 Mon Sep 17 00:00:00 2001 From: TJ VanToll Date: Fri, 19 Jun 2015 14:24:01 -0400 Subject: [PATCH 23/91] jQuery UI: Use a download location that has the UI source files Fixes gh-659 Closes gh-660 --- page/jquery-ui/environments/amd.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/page/jquery-ui/environments/amd.md b/page/jquery-ui/environments/amd.md index 6ee2e0e9..9214e985 100644 --- a/page/jquery-ui/environments/amd.md +++ b/page/jquery-ui/environments/amd.md @@ -13,7 +13,7 @@ In this article we'll walk through the process of using AMD with jQuery UI. Let' We'll need to download three things to get up and running: jQuery core, jQuery UI, and an AMD loader. -While any AMD loader will work, we'll use RequireJS in this article, which you can download from . If you don't have a version of jQuery core handy, you can get it from , and you can download jQuery UI directly from . Alternatively you can [download these libraries using a package manager such as Bower](/jquery-ui/environments/bower/). +While any AMD loader will work, we'll use RequireJS in this article, which you can download from . If you don't have a version of jQuery core handy, you can get it from , and you can download the jQuery UI source files from (use the files in the `ui` directory). You can alternatively [download these libraries using a package manager such as Bower](/jquery-ui/environments/bower/). ### Directory Structure From d8a8b8ea9d048f2e04c60ccf512cc0ac40a346cc Mon Sep 17 00:00:00 2001 From: Anne-Gaelle Colom Date: Sat, 17 Oct 2015 22:19:42 +0100 Subject: [PATCH 24/91] About: Added warning divs where appropriate Closes gh-674 --- page/about-jquery/how-jquery-works.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/page/about-jquery/how-jquery-works.md b/page/about-jquery/how-jquery-works.md index 4fbb1eab..425ff563 100644 --- a/page/about-jquery/how-jquery-works.md +++ b/page/about-jquery/how-jquery-works.md @@ -28,7 +28,7 @@ This is a basic tutorial, designed to help you get started using jQuery. If you The `src` attribute in the ` - + + +
  From 2ea2f4554c7cedaa163062b2d550a029189ae888 Mon Sep 17 00:00:00 2001 From: Anne-Gaelle Colom Date: Thu, 29 Oct 2015 18:22:52 +0000 Subject: [PATCH 29/91] Mobile: Updated content div to 1.4+ style Fixes gh-682 Closes gh-683 --- page/jquery-mobile/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/page/jquery-mobile/getting-started.md b/page/jquery-mobile/getting-started.md index 5b662452..5f07a2bb 100644 --- a/page/jquery-mobile/getting-started.md +++ b/page/jquery-mobile/getting-started.md @@ -11,7 +11,7 @@ To get started, you can simply paste the template below in your favorite text ed In the `` of this template, a meta `viewport` tag sets the screen width to the pixel width of the device. References to jQuery, jQuery Mobile, and the mobile theme stylesheet from the CDN add all the styles and scripts. jQuery Mobile 1.4 works with versions of jQuery core 1.8 and newer. -In the ``, a div with a `data-role` of `page` is the wrapper used to delineate a page. A header bar (`data-role="header"`), a content region (`data-role="content"`) and a footer bar (`data-role="footer"`) are added inside to create a basic page (all three are optional). These `data-` attributes are HTML5 attributes used throughout jQuery Mobile to transform basic markup into an enhanced and styled widget. +In the ``, a div with a `data-role` of `page` is the wrapper used to delineate a page. A header bar (`data-role="header"`), a content region (`class="ui-content"`) and a footer bar (`data-role="footer"`) are added inside to create a basic page (all three are optional). These `data-` attributes are HTML5 attributes used throughout jQuery Mobile to transform basic markup into an enhanced and styled widget. ``` @@ -30,7 +30,7 @@ In the ``, a div with a `data-role` of `page` is the wrapper used to delin

  My Title

  -
  +

  Hello world

  From 69c1436c91ae7f08b4ffce354796dc6f78d6dbd6 Mon Sep 17 00:00:00 2001 From: Anne-Gaelle Colom Date: Thu, 29 Oct 2015 21:35:55 +0000 Subject: [PATCH 30/91] 0.6.16 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 73c7abdf..fb3ee491 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.15", + "version": "0.6.16", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From be806f47f93060e5ba667bfcdc5cf792159b2748 Mon Sep 17 00:00:00 2001 From: Eric Lee Carraway Date: Tue, 3 Nov 2015 21:17:32 -0600 Subject: [PATCH 31/91] Pages: Fix typos Closes gh-687 behaviour => behavior inadvert => inadvertent namepaces => namespaces seperate => separate --- page/code-organization/deferreds/examples.md | 2 +- page/jquery-ui/widget-factory/extending-widgets.md | 2 +- page/style-guide.md | 2 +- page/using-jquery-core/iterating.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/page/code-organization/deferreds/examples.md b/page/code-organization/deferreds/examples.md index eb1d7aec..b355ce2e 100644 --- a/page/code-organization/deferreds/examples.md +++ b/page/code-organization/deferreds/examples.md @@ -11,7 +11,7 @@ ## Further Deferreds examples -Deferreds are used behind the hood in Ajax but it doesn't mean they can't also be used elsewhere. This section describes situations where deferreds will help abstract away asynchronous behaviour and decouple our code. +Deferreds are used behind the hood in Ajax but it doesn't mean they can't also be used elsewhere. This section describes situations where deferreds will help abstract away asynchronous behavior and decouple our code. ### Caching diff --git a/page/jquery-ui/widget-factory/extending-widgets.md b/page/jquery-ui/widget-factory/extending-widgets.md index e16fdd0f..2285efe6 100644 --- a/page/jquery-ui/widget-factory/extending-widgets.md +++ b/page/jquery-ui/widget-factory/extending-widgets.md @@ -23,7 +23,7 @@ Like the previous example, the following also creates a "superDialog" widget in $.widget( "custom.superDialog", $.ui.dialog, {} ); ``` -Here superDialog and dialog are essentially equivalent widgets with different names and namepaces. To make our new widget more interesting we can add methods to its prototype object. +Here superDialog and dialog are essentially equivalent widgets with different names and namespaces. To make our new widget more interesting we can add methods to its prototype object. A widget's prototype object is the final argument passed to `$.widget()`. So far, our examples have been using an empty object. Let's add a method to this object: diff --git a/page/style-guide.md b/page/style-guide.md index 1d1db266..7f16ca74 100644 --- a/page/style-guide.md +++ b/page/style-guide.md @@ -60,7 +60,7 @@ Content should be educational and accessible to a broad audience of developers. #### Article & Sentence Structure - Use headings to break up content into easier-to-read sections. Begin headings within an article with `

  `. -- Keep sentences short and to the point. A good rule-of-thumb is to break up any sentence longer than 21 words into two or more seperate thoughts. +- Keep sentences short and to the point. A good rule-of-thumb is to break up any sentence longer than 21 words into two or more separate thoughts. - Lists: - Use bulleted lists when necessary to share a series of five or more points. - Use numbered lists only when providing step-by-step instruction – note that this should be avoided. diff --git a/page/using-jquery-core/iterating.md b/page/using-jquery-core/iterating.md index eabac87c..1e95eeff 100644 --- a/page/using-jquery-core/iterating.md +++ b/page/using-jquery-core/iterating.md @@ -115,7 +115,7 @@ $( "li" ).each( function( index, element ){ The question is often raised, "If `this` is the element, why is there a second DOM element argument passed to the callback?" -Whether intentional or inadvert, the execution context may change. When consistently using the keyword `this`, it's easy to end up confusing ourselves or other developers reading the code. Even if the execution context remains the same, it may be more readable to use the second parameter as a named parameter. For example: +Whether intentional or inadvertent, the execution context may change. When consistently using the keyword `this`, it's easy to end up confusing ourselves or other developers reading the code. Even if the execution context remains the same, it may be more readable to use the second parameter as a named parameter. For example: ``` $( "li" ).each( function( index, listItem ) { From f0ea6b58c50a1e49faf000b4b8be391e5ba1df04 Mon Sep 17 00:00:00 2001 From: Anne-Gaelle Colom Date: Wed, 4 Nov 2015 21:54:00 +0000 Subject: [PATCH 32/91] 0.6.17 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index fb3ee491..f9c2df63 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "learn.jquery.com", "title": "jQuery Learning Site", "description": "jQuery Foundation site for learning jQuery and JavaScript", - "version": "0.6.16", + "version": "0.6.17", "homepage": "http://learn.jquery.com", "author": { "name": "jQuery Foundation and other contributors" From 7ebe257ab4f82739f19779717c2815594d19e7ad Mon Sep 17 00:00:00 2001 From: Eric Lee Carraway Date: Thu, 5 Nov 2015 22:59:57 -0600 Subject: [PATCH 33/91] Pages: grammatical proofreading Closes gh-688 --- page/code-organization/deferreds/examples.md | 2 +- page/effects/queue-and-dequeue-explained.md | 2 +- page/events/event-extensions.md | 2 +- page/events/introduction-to-events.md | 2 +- page/jquery-mobile/theme-roller.md | 4 ++-- page/jquery-ui/environments/bower.md | 12 ++++++------ page/jquery-ui/theming.md | 2 +- .../widget-factory/how-to-use-the-widget-factory.md | 2 +- page/plugins/advanced-plugin-concepts.md | 2 +- page/plugins/basic-plugin-creation.md | 2 +- 10 files changed, 16 insertions(+), 16 deletions(-) diff --git a/page/code-organization/deferreds/examples.md b/page/code-organization/deferreds/examples.md index b355ce2e..e619e793 100644 --- a/page/code-organization/deferreds/examples.md +++ b/page/code-organization/deferreds/examples.md @@ -158,7 +158,7 @@ The new `$.afterDOMReady()` helper method provides proper timing after the DOM i While jQuery offers all the event binding one may need, it can become a bit cumbersome to handle events that are only supposed to be dealt with once. -For instance, you may wish to have a button that will open a panel the first time it is clicked and leave it open afterwards or take special initialization actions the first time said button is clicked. When dealing with such a situation, one usually end up with code like this: +For instance, you may wish to have a button that will open a panel the first time it is clicked and leave it open afterward or take special initialization actions the first time said button is clicked. When dealing with such a situation, one usually ends up with code like this: ``` var buttonClicked = false; diff --git a/page/effects/queue-and-dequeue-explained.md b/page/effects/queue-and-dequeue-explained.md index b72cfaec..0bc59825 100644 --- a/page/effects/queue-and-dequeue-explained.md +++ b/page/effects/queue-and-dequeue-explained.md @@ -87,7 +87,7 @@ Another way of clearing the queue is to call `.stop( true )`. That will stop the ## Replacing The Queue -When you pass an array of functions as second argument to `.queue()`, that array will replace the queue. +When you pass an array of functions as the second argument to `.queue()`, that array will replace the queue. ``` $( ".box" ) diff --git a/page/events/event-extensions.md b/page/events/event-extensions.md index f94bf178..39f9bd7d 100644 --- a/page/events/event-extensions.md +++ b/page/events/event-extensions.md @@ -7,7 +7,7 @@ jQuery offers several ways to extend its event system to provide custom function This document covers the extensions available starting with jQuery 1.7; a sparsely documented subset of this functionality has been available since jQuery 1.3 but the differences in functionality are extensive. For an overview of special events in earlier versions, see [Ben Alman's jQuery Special Events](http://benalman.com/news/2010/03/jquery-special-events/) article. -

  **Note:** jQuery event extensions are an advanced feature; they require deeper knowledge of both browser behavior and jQuery internals than most of the API. Most users of jQuery will not need to use event extensions, and those who do should use them with care. For example, on a large project with third-party plugins, changing the behavior of standard events such as `click` or `mouseover` can cause serious compatibility issues.

  +

  **Note:** jQuery event extensions are an advanced feature; they require a deeper knowledge of both browser behavior and jQuery internals than most of the API. Most users of jQuery will not need to use event extensions, and those who do should use them with care. For example, on a large project with third-party plugins, changing the behavior of standard events such as `click` or `mouseover` can cause serious compatibility issues.

  ### Events overview and general advice diff --git a/page/events/introduction-to-events.md b/page/events/introduction-to-events.md index f066dd48..c105de82 100644 --- a/page/events/introduction-to-events.md +++ b/page/events/introduction-to-events.md @@ -131,7 +131,7 @@ In this slightly different example, we're defining a function called `sayHello` But what about that `event` argument in the `sayHello` function — what is it and why does it matter? In all DOM event callbacks, jQuery passes an *event object* argument which contains information about the event, such as precisely when and where it occurred, what type of event it was, which element the event occurred on, and a plethora of other information. Of course you don't have to call it `event`; you could call it `e` or whatever you want to, but `event` is a pretty common convention. -If the element has default functionality for a specific event (like a link opens a new page, a button in a form submits the form, etc.), that default functionality can be cancelled. This is often useful for Ajax requests. When a user clicks on a button to submit a form via Ajax, we'd want to cancel the button/form's default action (to submit it to the form's `action` attribute), and we would instead do an Ajax request to accomplish the same task for a more seamless experience. To do this, we would utilize the event object and call its `.preventDefault()` method. We can also prevent the event from bubbling up the DOM tree using `.stopPropagation()` so that parent elements aren't notified of its occurrence (in the case that event delegation is being used). +If the element has default functionality for a specific event (like a link opens a new page, a button in a form submits the form, etc.), that default functionality can be canceled. This is often useful for Ajax requests. When a user clicks on a button to submit a form via Ajax, we'd want to cancel the button/form's default action (to submit it to the form's `action` attribute), and we would instead do an Ajax request to accomplish the same task for a more seamless experience. To do this, we would utilize the event object and call its `.preventDefault()` method. We can also prevent the event from bubbling up the DOM tree using `.stopPropagation()` so that parent elements aren't notified of its occurrence (in the case that event delegation is being used). ``` // Preventing a default action from occurring and stopping the event bubbling diff --git a/page/jquery-mobile/theme-roller.md b/page/jquery-mobile/theme-roller.md index dfb73d67..545ea902 100644 --- a/page/jquery-mobile/theme-roller.md +++ b/page/jquery-mobile/theme-roller.md @@ -35,11 +35,11 @@ The easiest way to create custom themes is with the ThemeRoller tool. It allows ### Creating the Theme Swatches -The [ThemeRoller](http://jquerymobile.com/themeroller/) allows users to create their own theme through an easy to use drag and drop interface. By default, ThemeRoller offers three swatches (a, b and c). You can use the offered default colors, the Adobe kuler colors, or create your own. You will create your theme by dragging the chosen color onto the chosen element in the swatch of your choice. You can add more swatches by pressing the "+" sign near the "A", "B", and "C" tabs, in the left-hand side menu. +The [ThemeRoller](http://jquerymobile.com/themeroller/) allows users to create their own theme through an easy to use drag and drop interface. By default, ThemeRoller offers three swatches (a, b and c). You can use the offered default colors, the Adobe Kuler colors, or create your own. You will create your theme by dragging the chosen color onto the chosen element in the swatch of your choice. You can add more swatches by pressing the "+" sign near the "A", "B", and "C" tabs, in the left-hand side menu. You can further edit your swatch from the menu. For example, you can expand the various element parts and carry out detailed editing. This will allow you to change text color, text shadow size, position and color, etc. You can also edit the gradient used on each element. -Here are two examples of theme swatches created, one with the default colors, and one with the kuler colors: +Here are two examples of theme swatches created, one with the default colors, and one with the Kuler colors:   diff --git a/page/jquery-ui/environments/bower.md b/page/jquery-ui/environments/bower.md index 0c07b116..37793006 100644 --- a/page/jquery-ui/environments/bower.md +++ b/page/jquery-ui/environments/bower.md @@ -35,13 +35,13 @@ As an example, suppose we're starting a new project and we need to use [jQuery U ``` -This examples fails with a JavaScript error because neither jQuery core nor jQuery UI are loaded. Let's load them with Bower. +This example fails with a JavaScript error because neither jQuery core nor jQuery UI are loaded. Let's load them with Bower. ### Downloading jQuery UI With Bower Libraries are downloaded with Bower using the `bower install` command. To install jQuery UI, run `bower install jquery-ui`. Doing so creates the following (simplified) directory structure. -*Note: If you get an error that the `bower` command is not found, checkout [Bower's installation instructions](http://bower.io/#installing-bower).* +*Note: If you get an error that the `bower` command is not found, check out [Bower's installation instructions](http://bower.io/#installing-bower).*

   .
  @@ -85,7 +85,7 @@ We have a few different options for using the files downloaded with Bower. The e
   	
   
   
  - 
  +
   
  
   	
  jQuery Core
   	
  jQuery is a fast, small, and feature-rich JavaScript library...
  @@ -94,13 +94,13 @@ We have a few different options for using the files downloaded with Bower. The e
   	
  jQuery Mobile
   	
  jQuery Mobile is a HTML5-based user interface system...
   
  - 
  +
   
   
   
  - 
  +
   
   
   ```
  @@ -140,4 +140,4 @@ Because Bower also downloaded jQuery UI's individual source files, we can altern
   
   ```
   
  -From here, you can hook jQuery UI's files into your own custom build system to concatenate and minify your resources for production. If you're a RequireJS user, checkout our [guide on how to use jQuery UI with AMD](/jquery-ui/environments/amd/).
  \ No newline at end of file
  +From here, you can hook jQuery UI's files into your own custom build system to concatenate and minify your resources for production. If you're a RequireJS user, check out our [guide on how to use jQuery UI with AMD](/jquery-ui/environments/amd/).
  diff --git a/page/jquery-ui/theming.md b/page/jquery-ui/theming.md
  index ba8d5602..56e5cf5b 100644
  --- a/page/jquery-ui/theming.md
  +++ b/page/jquery-ui/theming.md
  @@ -5,7 +5,7 @@
   
   All jQuery UI plugins are designed to allow a developer to seamlessly integrate UI widgets into the look and feel of their site or application. Each plugin is styled with CSS and contains two layers of style information: standard [jQuery UI CSS Framework](http://api.jqueryui.com/theming/css-framework/) styles and plugin-specific styles.
   
  -The jQuery UI CSS Framework provide semantic presentation classes to indicate the role of an element within a widget such as a header, content area, or clickable region. These are applied consistently across all widgets so a clickable tab, accordion, or button will all have the same `ui-state-default` class applied to indicate that it is clickable. When a user mouses over one of these elements, this class is changed to `ui-state-hover`, then `ui-state-active` when selected. This level of class consistency makes it easy to ensure that all elements with a similar role or interaction state will look the same across all widgets.
  +The jQuery UI CSS Framework provides semantic presentation classes to indicate the role of an element within a widget such as a header, content area, or clickable region. These are applied consistently across all widgets so a clickable tab, accordion, or button will all have the same `ui-state-default` class applied to indicate that it is clickable. When a user mouses over one of these elements, this class is changed to `ui-state-hover`, then `ui-state-active` when selected. This level of class consistency makes it easy to ensure that all elements with a similar role or interaction state will look the same across all widgets.
   
   The CSS Framework styles are encapsulated in a single file called `theme.css` and this is the file modified by the [ThemeRoller](/jquery-ui/themeroller/) application. Framework styles only include attributes that affect the look and feel (primarily color, background images, and icons) so these are "safe" styles that will not affect functionality of individual plugins. This separation means that a developer can create a custom look and feel by modifying the colors and images in the `theme.css` file and know that as future plugins or bug fixes become available, these should work with the theme without modification.
   
  diff --git a/page/jquery-ui/widget-factory/how-to-use-the-widget-factory.md b/page/jquery-ui/widget-factory/how-to-use-the-widget-factory.md
  index 228e7e0c..4c8b9d40 100644
  --- a/page/jquery-ui/widget-factory/how-to-use-the-widget-factory.md
  +++ b/page/jquery-ui/widget-factory/how-to-use-the-widget-factory.md
  @@ -299,6 +299,6 @@ $.widget( "custom.progressbar", {
   
   ## Closing Comments
   
  -The widget factory is only one way of creating stateful plugins. There are a few different models that can be used and each have their own advantages and disadvantages. The widget factory solves lots of common problems for you and can greatly improve productivity, it also greatly improves code reuse, making it a great fit for jQuery UI as well as many other stateful plugins.
  +The widget factory is only one way of creating stateful plugins. There are a few different models that can be used and each has their own advantages and disadvantages. The widget factory solves lots of common problems for you and can greatly improve productivity, it also greatly improves code reuse, making it a great fit for jQuery UI as well as many other stateful plugins.
   
   You may have noticed that in this article we used the `custom` namespace. The `ui` namespace is reserved for official jQuery UI plugins. When building your own plugins, you should create your own namespace. This makes it clear where the plugin came from and if it is part of a larger collection.
  diff --git a/page/plugins/advanced-plugin-concepts.md b/page/plugins/advanced-plugin-concepts.md
  index 28333478..84826df2 100644
  --- a/page/plugins/advanced-plugin-concepts.md
  +++ b/page/plugins/advanced-plugin-concepts.md
  @@ -245,7 +245,7 @@ $( "
  " ).appendTo( "body" );
   $( ".gallery-wrapper" ).append( "..." );
   ```
   
  -To allow users to access and even manipulate those information, you can store them in a variable containing the settings of your plugin. A better implementation of the previous code is shown below:
  +To allow users to access and even manipulate that information, you can store it in a variable containing the settings of your plugin. A better implementation of the previous code is shown below:
   
   ```
   // Retain an internal reference:
  diff --git a/page/plugins/basic-plugin-creation.md b/page/plugins/basic-plugin-creation.md
  index a93f0bd9..a186f2cc 100644
  --- a/page/plugins/basic-plugin-creation.md
  +++ b/page/plugins/basic-plugin-creation.md
  @@ -33,7 +33,7 @@ Notice that to use `.css()`, another method, we use `this`, not `$( this )`. Thi
   
   ## Chaining
   
  -This works, but there's a couple of things we need to do for our plugin to survive in the real world. One of jQuery's features is chaining, when you link five or six actions onto one selector. This is accomplished by having all jQuery object methods return the original jQuery object again (there are a few exceptions: `.width()` called without parameters returns the width of the selected element, and is not chainable). Making our plugin method chainable takes one line of code:
  +This works, but there are a couple of things we need to do for our plugin to survive in the real world. One of jQuery's features is chaining, when you link five or six actions onto one selector. This is accomplished by having all jQuery object methods return the original jQuery object again (there are a few exceptions: `.width()` called without parameters returns the width of the selected element, and is not chainable). Making our plugin method chainable takes one line of code:
   
   ```
   $.fn.greenify = function() {
  
  From 17b053e5fe7ed7935c2cbec4982293d5368aceb4 Mon Sep 17 00:00:00 2001
  From: Arthur Verschaeve 
  Date: Fri, 6 Nov 2015 10:55:49 +0100
  Subject: [PATCH 34/91] 0.6.18
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index f9c2df63..f0071c72 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.17",
  +  "version": "0.6.18",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From d0eadf725ae6ecdfdf19d1fc02a2c9442e078ba9 Mon Sep 17 00:00:00 2001
  From: Anne-Gaelle Colom 
  Date: Mon, 23 Nov 2015 21:12:31 +0000
  Subject: [PATCH 35/91] Mobile: Updated getting started page
  
  Closes gh-689
  Fixes gh-684
  ---
   page/jquery-mobile/getting-started.md | 12 ++++++------
   1 file changed, 6 insertions(+), 6 deletions(-)
  
  diff --git a/page/jquery-mobile/getting-started.md b/page/jquery-mobile/getting-started.md
  index 5f07a2bb..e557a526 100644
  --- a/page/jquery-mobile/getting-started.md
  +++ b/page/jquery-mobile/getting-started.md
  @@ -11,7 +11,7 @@ To get started, you can simply paste the template below in your favorite text ed
   
   In the `` of this template, a meta `viewport` tag sets the screen width to the pixel width of the device. References to jQuery, jQuery Mobile, and the mobile theme stylesheet from the CDN add all the styles and scripts. jQuery Mobile 1.4 works with versions of jQuery core 1.8 and newer.
   
  -In the ``, a div with a `data-role` of `page` is the wrapper used to delineate a page. A header bar (`data-role="header"`), a content region (`class="ui-content"`) and a footer bar (`data-role="footer"`) are added inside to create a basic page (all three are optional). These `data-` attributes are HTML5 attributes used throughout jQuery Mobile to transform basic markup into an enhanced and styled widget.
  +In the ``, a div with a `data-role` of `page` is the wrapper used to delineate a page. A header bar (`data-role="header"`), a content region (`role="main" class="ui-content"`) and a footer bar (`data-role="footer"`) are added inside to create a basic page (all three are optional). These `data-` attributes are HTML5 attributes used throughout jQuery Mobile to transform basic markup into an enhanced and styled widget.
   
   ```
   
  @@ -30,7 +30,7 @@ In the ``, a div with a `data-role` of `page` is the wrapper used to delin
   			
  My Title
   		
  
   
  -		
  
  +		
  
   			
  Hello world
   		
  
   
  @@ -82,19 +82,19 @@ There are a few ways to make buttons. A common one is to turn a link into a butt
   
   ### Choose a Theme Swatch
   
  -jQuery Mobile has a robust theme framework that supports up to 26 sets of toolbar, content, and button colors, called a "swatch". You can add a `data-theme="e"` attribute to any of the widgets on this page: page, header, list, input for the slider, or button to turn it yellow. Different swatch letters from a-e in the default theme can be used to mix and match swatches.
  +jQuery Mobile has a robust theme framework that supports up to 26 sets of toolbar, content, and button colors, called a "swatch". You can add a `data-theme="b"` attribute to any of the widgets on this page: page, header, list, input for the slider, or button to turn it a dark shade of grey. Different swatch letters from a-b in the default theme can be used to mix and match swatches.
   
  -If you add the theme swatch to the page, all the widgets inside the content will automatically inherit the theme (headers and footers don't inherit and default to swatch "a").
  +If you add the theme swatch to the page, all the widgets inside the content will automatically inherit the theme.
   
   ```
   Button
   ```
   
  -If you would like to create a custom theme, you can use [ThemeRoller](http://jquerymobile.com/themeroller/) that allows users to create their own theme through an easy to use drag and drop interface. You will then be able to download and use your newly created theme.
  +If you would like to create a custom theme, you can use [ThemeRoller](https://themeroller.jquerymobile.com/) that allows users to create their own theme through an easy to use drag and drop interface. You will then be able to download and use your newly created theme.
   
   ### Go Forth and Build Something
   
  -This guide has provided you with a basic structure for a jQuery Mobile page and a few enhanced elements. You can explore the full [jQuery Mobile documentation](http://jquerymobile.com/demos/1.2.0/) to learn about linking pages, adding animated page transitions, and creating dialogs and popups.
  +This guide has provided you with a basic structure for a jQuery Mobile page and a few enhanced elements. You can explore the full [jQuery Mobile API Documentation](http://api.jquerymobile.com) and [jQuery Mobile Demo Center](http://demos.jquerymobile.com/1.4.5/) to learn about linking pages, adding animated page transitions, and creating dialogs and popups.
   
   If you're more of the type who prefers actually writing JavaScript to build your apps, and you don't want to use the `data-` attribute configuration system, you can take full control of everything and call plugins directly as these are all standard jQuery plugins built with the UI widget factory. Particularly useful information for such cases can be found in the global configuration, events, and methods sections.
   
  
  From c0fee2851c1aeaae41236d05379671e4240cb856 Mon Sep 17 00:00:00 2001
  From: Anne-Gaelle Colom 
  Date: Tue, 24 Nov 2015 11:53:59 +0000
  Subject: [PATCH 36/91] 0.6.19
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index f0071c72..22f78f64 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.18",
  +  "version": "0.6.19",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From eba4201609f9dbca36a763079e36fa933f002d9a Mon Sep 17 00:00:00 2001
  From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
  Date: Thu, 17 Dec 2015 13:28:59 -0500
  Subject: [PATCH 37/91] Build: Upgrade to grunt-jquery-content 3.0.0
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 22f78f64..449a389c 100644
  --- a/package.json
  +++ b/package.json
  @@ -22,7 +22,7 @@
     ],
     "dependencies": {
       "grunt": "0.4.5",
  -    "grunt-jquery-content": "2.0.0",
  +    "grunt-jquery-content": "3.0.0",
       "spawnback": "1.0.0"
     }
   }
  
  From 851b0b923120f69d2533013029de2d2a09d45795 Mon Sep 17 00:00:00 2001
  From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
  Date: Thu, 17 Dec 2015 13:29:02 -0500
  Subject: [PATCH 38/91] 0.6.20
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 449a389c..6bf99d33 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.19",
  +  "version": "0.6.20",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From f541b367ae7f1d370359c6190bd0d869fe26166f Mon Sep 17 00:00:00 2001
  From: Aurelio De Rosa 
  Date: Sun, 25 Oct 2015 20:13:05 +0000
  Subject: [PATCH 39/91] Explicitly describe $ as an alias for jQuery
  
  Fixes gh-680
  Closes gh-681
  ---
   page/about-jquery/how-jquery-works.md | 2 ++
   1 file changed, 2 insertions(+)
  
  diff --git a/page/about-jquery/how-jquery-works.md b/page/about-jquery/how-jquery-works.md
  index 425ff563..33cfb0cb 100644
  --- a/page/about-jquery/how-jquery-works.md
  +++ b/page/about-jquery/how-jquery-works.md
  @@ -53,6 +53,8 @@ $( document ).ready(function() {
   });
   ```
   
  +
  **Note**: The jQuery library exposes its methods and properties via two properties of the window object called jQuery and $. $ is simply an alias for jQuery and it's often employed because it's shorter and faster to write.
  +
   For example, inside the `ready` event, you can add a click handler to the link:
   
   ```
  
  From edb7c1f95f27f3707fa4c65e5f310661fb171d94 Mon Sep 17 00:00:00 2001
  From: Alex Marshall 
  Date: Wed, 24 Feb 2016 15:03:51 -0500
  Subject: [PATCH 40/91] Handling events: Simple grammar correction
  
  "it's" to "its"
  
  Closes gh-700
  ---
   page/events/handling-events.md | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/page/events/handling-events.md b/page/events/handling-events.md
  index 9f809553..d1ca45af 100644
  --- a/page/events/handling-events.md
  +++ b/page/events/handling-events.md
  @@ -113,7 +113,7 @@ The `.one()` method is especially useful if you need to do some complicated setu
   
   ### Disconnecting Events
   
  -Although all the fun of jQuery occurs in the `.on()` method, it's counterpart is just as important if you want to be a responsible developer. `.off()` cleans up that event binding when you don't need it anymore. Complex user interfaces with lots of event bindings can bog down browser performance, so using the `.off()` method diligently is a best practice to ensure that you only have the event bindings that you need, when you need them.
  +Although all the fun of jQuery occurs in the `.on()` method, its counterpart is just as important if you want to be a responsible developer. `.off()` cleans up that event binding when you don't need it anymore. Complex user interfaces with lots of event bindings can bog down browser performance, so using the `.off()` method diligently is a best practice to ensure that you only have the event bindings that you need, when you need them.
   
   ```
   // Unbinding all click handlers on a selection
  
  From 45df607ae6b02eaf9db090534fcbbdcbffc8bfbb Mon Sep 17 00:00:00 2001
  From: Aurelio De Rosa 
  Date: Sat, 23 Jan 2016 17:16:32 +0000
  Subject: [PATCH 41/91] Added .editorconfig file
  
  Closes gh-698
  ---
   .editorconfig | 19 +++++++++++++++++++
   1 file changed, 19 insertions(+)
   create mode 100644 .editorconfig
  
  diff --git a/.editorconfig b/.editorconfig
  new file mode 100644
  index 00000000..29b657a3
  --- /dev/null
  +++ b/.editorconfig
  @@ -0,0 +1,19 @@
  +# This file is for unifying the coding style for different editors and IDEs
  +# editorconfig.org
  +
  +root = true
  +
  +[*]
  +end_of_line = lf
  +charset = utf-8
  +trim_trailing_whitespace = true
  +insert_final_newline = true
  +indent_style = tab
  +
  +[package.json]
  +indent_style = space
  +indent_size = 2
  +
  +[*.yml]
  +indent_style = space
  +indent_size = 2
  
  From 9e8fcacfa73bb3c6862739a2b6c6e8e1c6fcbf8e Mon Sep 17 00:00:00 2001
  From: James White 
  Date: Fri, 25 Sep 2015 17:57:40 +0100
  Subject: [PATCH 42/91] Updated Ajax page to remove deprecated methods
  
  Fixes gh-665
  Closes gh-669
  ---
   page/ajax/jquery-ajax-methods.md | 57 ++++++++++++++++----------------
   1 file changed, 28 insertions(+), 29 deletions(-)
  
  diff --git a/page/ajax/jquery-ajax-methods.md b/page/ajax/jquery-ajax-methods.md
  index 1caaf189..54a62e1e 100644
  --- a/page/ajax/jquery-ajax-methods.md
  +++ b/page/ajax/jquery-ajax-methods.md
  @@ -30,28 +30,26 @@ $.ajax({
   
   	// The type of data we expect back
   	dataType : "json",
  +})
  +  // Code to run if the request succeeds (is done);
  +  // The response is passed to the function
  +  .done(function( json ) {
  +     $( "
  " ).text( json.title ).appendTo( "body" );
  +     $( "
  ").html( json.html ).appendTo( "body" );
  +  })
  +  // Code to run if the request fails; the raw request and
  +  // status codes are passed to the function
  +  .fail(function( xhr, status, errorThrown ) {
  +    alert( "Sorry, there was a problem!" );
  +    console.log( "Error: " + errorThrown );
  +    console.log( "Status: " + status );
  +    console.dir( xhr );
  +  })
  +  // Code to run regardless of success or failure;
  +  .always(function( xhr, status ) {
  +    alert( "The request is complete!" );
  +  });
   
  -	// Code to run if the request succeeds;
  -	// the response is passed to the function
  -	success: function( json ) {
  -		$( "
  " ).text( json.title ).appendTo( "body" );
  -		$( "
  ").html( json.html ).appendTo( "body" );
  -	},
  -
  -	// Code to run if the request fails; the raw request and
  -	// status codes are passed to the function
  -	error: function( xhr, status, errorThrown ) {
  -		alert( "Sorry, there was a problem!" );
  -		console.log( "Error: " + errorThrown );
  -		console.log( "Status: " + status );
  -		console.dir( xhr );
  -	},
  -
  -	// Code to run regardless of success or failure
  -	complete: function( xhr, status ) {
  -		alert( "The request is complete!" );
  -	}
  -});
   ```
   
   **Note:** Regarding the `dataType` setting, if the server sends back data that is in a different format than you specify, your code may fail, and the reason will not always be clear, because the HTTP response code will not show an error. When working with Ajax requests, make sure your server is sending back the data type you're asking for, and verify that the `Content-type` header is accurate for the data type. For example, for JSON data, the `Content-type` header should be `application/json`.
  @@ -68,7 +66,15 @@ Set to `false` if the request should be sent synchronously. Defaults to `true`.
   
   Whether to use a cached response if available. Defaults to `true` for all `dataType`s except "script" and "jsonp". When set to `false`, the URL will simply have a cachebusting parameter appended to it.
   
  -#### complete
  +#### done
  +
  +A callback function to run if the request succeeds. The function receives the response data (converted to a JavaScript object if the `dataType` was JSON), as well as the text status of the request and the raw request object.
  +
  +#### fail
  +
  +A callback function to run if the request results in an error. The function receives the raw request object and the text status of the request.
  +
  +#### always 
   
   A callback function to run when the request is complete, regardless of success or failure. The function receives the raw request object and the text status of the request.
   
  @@ -84,17 +90,10 @@ The data to be sent to the server. This can either be an object or a query strin
   
   The type of data you expect back from the server. By default, jQuery will look at the MIME type of the response if no `dataType` is specified.
   
  -#### error
  -
  -A callback function to run if the request results in an error. The function receives the raw request object and the text status of the request.
  -
   #### jsonp
   
   The callback name to send in a query string when making a JSONP request. Defaults to "callback".
   
  -#### success
  -
  -A callback function to run if the request succeeds. The function receives the response data (converted to a JavaScript object if the `dataType` was JSON), as well as the text status of the request and the raw request object.
   
   #### timeout
   
  
  From d08015a310858e480c746c7e145303be1aba500e Mon Sep 17 00:00:00 2001
  From: Karl Swedberg 
  Date: Sun, 13 Mar 2016 18:38:22 -0400
  Subject: [PATCH 43/91] Note what defer.resolve and defer.reject do. Closes
   gh-693
  
  ---
   page/code-organization/deferreds/examples.md | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/page/code-organization/deferreds/examples.md b/page/code-organization/deferreds/examples.md
  index e619e793..d4b74e38 100644
  --- a/page/code-organization/deferreds/examples.md
  +++ b/page/code-organization/deferreds/examples.md
  @@ -39,7 +39,7 @@ $.cachedGetScript = function( url, callback ) {
   };
   ```
   
  -One promise is cached per URL. If there is no promise for the given URL yet, then a deferred is created and the request is issued. If it already exists, however, the callback is attached to the existing deferred. The big advantage of this solution is that it will handle both complete and inbound requests transparently. Another advantage is that a deferred-based cache will deal with failure gracefully. The promise will end up rejected which can be tested for by providing an error callback:
  +One promise is cached per URL. If there is no promise for the given URL yet, then a deferred is created and the request is issued. When the request is complete, the deferred is resolved (with `defer.resolve`); if an error occurs, the deferred is rejected (with `defer.reject`). If the promise already exists, the callback is attached to the existing deferred; otherwise, the promise is first created and then the callback is attached. The big advantage of this solution is that it will handle both complete and inbound requests transparently. Another advantage is that a deferred-based cache will deal with failure gracefully. The promise will end up rejected which can be tested for by providing an error callback:
   
   ```
   $.cachedGetScript( url ).then( successCallback, errorCallback );
  
  From 82c75035e7dec5bf1970b5d17e738d437c4a5c61 Mon Sep 17 00:00:00 2001
  From: Karl Swedberg 
  Date: Sun, 13 Mar 2016 18:41:50 -0400
  Subject: [PATCH 44/91] Improve/update optimize-selectors page. Fixes gh-697.
   Closes gh-704
  
  ---
   page/performance/optimize-selectors.md | 55 +++++++++++++++++---------
   1 file changed, 36 insertions(+), 19 deletions(-)
  
  diff --git a/page/performance/optimize-selectors.md b/page/performance/optimize-selectors.md
  index c287f208..44f3b8e6 100644
  --- a/page/performance/optimize-selectors.md
  +++ b/page/performance/optimize-selectors.md
  @@ -5,11 +5,36 @@
   	"attribution": [ "jQuery Fundamentals" ]
   }
   
  -Selector optimization is less important than it used to be, as more browsers implement `document.querySelectorAll()` and the burden of selection shifts from jQuery to the browser. However, there are still some tips to keep in mind.
  +Selector optimization is less important than it used to be, as more browsers implement `document.querySelectorAll()` and the burden of selection shifts from jQuery to the browser. However, there are still some tips to keep in mind when selector performance becomes a bottleneck.
  +
  +## jQuery Extensions
  +
  +When possible, avoid selectors that include [jQuery extensions](https://api.jquery.com/category/selectors/jquery-selector-extensions/). These extensions cannot take advantage of the performance boost provided by the native `querySelectorAll()` DOM method and, therefore, require the use of the Sizzle selector engine provided by jQuery.
  +
  +```
  +// Slower (the zero-based :even selector is a jQuery extension)
  +$( "#my-table tr:even" );
  +
  +// Better, though not exactly equivalent
  +$( "#my-table tr:nth-child(odd)" );
  +```
  +
  +Keep in mind that many jQuery extensions, including `:even` in the above example, do not have exact equivalents in the CSS specification. In some situations the convenience of these extensions could outweigh their performance cost.
  +
  +## Avoid Excessive Specificity
  +
  +```
  +$( ".data table.attendees td.gonzalez" );
  +
  +// Better: Drop the middle if possible.
  +$( ".data td.gonzalez" );
  +```
  +
  +A "flatter" DOM also helps improve selector performance, as the selector engine has fewer layers to traverse when looking for an element.
   
   ## ID-Based Selectors
   
  -Beginning your selector with an ID is always best.
  +Beginning your selector with an ID is a safe bet.
   
   ```
   // Fast:
  @@ -19,10 +44,13 @@ $( "#container div.robotarm" );
   $( "#container" ).find( "div.robotarm" );
   ```
   
  -The `.find()` approach is faster because the first selection is handled without going through the Sizzle selector engine – ID-only selections are handled using `document.getElementById()`, which is extremely fast because it is native to the browser.
  +With the first approach, jQuery queries the DOM using `document.querySelectorAll()`. With the second, jQuery uses `document.getElementById()`, which is faster, although the speed improvement may be diminished by the subsequent call to `.find()`.
  +
  +## Tips for Older Browsers
   
  -## Specificity
  +When support for older browsers, such as Internet Explorer 8 and below, is necessary, consider the following tips:
   
  +### Specificity
   Be specific on the right-hand side of your selector, and less specific on the left.
   
   ```
  @@ -35,18 +63,7 @@ $( ".data td.gonzalez" );
   
   Use `tag.class` if possible on your right-most selector, and just tag or just `.class` on the left.
   
  -## Avoid Excessive Specificity
  -
  -```
  -$( ".data table.attendees td.gonzalez" );
  -
  -// Better: Drop the middle if possible.
  -$( ".data td.gonzalez" );
  -```
  -
  -A "flatter" DOM also helps improve selector performance, as the selector engine has fewer layers to traverse when looking for an element.
  -
  -## Avoid the Universal Selector
  +### Avoid the Universal Selector
   
   Selections that specify or imply that a match could be found anywhere can be very slow.
   
  @@ -54,7 +71,7 @@ Selections that specify or imply that a match could be found anywhere can be ver
   $( ".buttons > *" ); // Extremely expensive.
   $( ".buttons" ).children(); // Much better.
   
  -$( ".category :radio" ); // Implied universal selection.
  -$( ".category *:radio" ); // Same thing, explicit now.
  -$( ".category input:radio" ); // Much better.
  +$( ":radio" ); // Implied universal selection.
  +$( "*:radio" ); // Same thing, explicit now.
  +$( "input:radio" ); // Much better.
   ```
  
  From 493807e4ced93042344af5a358a310c4047ca8f6 Mon Sep 17 00:00:00 2001
  From: Karl Swedberg 
  Date: Sun, 13 Mar 2016 20:45:01 -0400
  Subject: [PATCH 45/91] Add example for comma-separated list of selectors.
   Fixes gh-702. Closes gh-706.
  
  ---
   page/using-jquery-core/selecting-elements.md | 18 ++++++++----------
   1 file changed, 8 insertions(+), 10 deletions(-)
  
  diff --git a/page/using-jquery-core/selecting-elements.md b/page/using-jquery-core/selecting-elements.md
  index 6d608d07..08db0659 100644
  --- a/page/using-jquery-core/selecting-elements.md
  +++ b/page/using-jquery-core/selecting-elements.md
  @@ -20,7 +20,7 @@ $( ".myClass" );
   ## Selecting Elements by Attribute
   
   ```
  -$( "input[name='first_name']" ); // Beware, this can be very slow in older browsers
  +$( "input[name='first_name']" );
   ```
   
   ## Selecting Elements by Compound CSS Selector
  @@ -29,6 +29,12 @@ $( "input[name='first_name']" ); // Beware, this can be very slow in older brows
   $( "#contents ul.people li" );
   ```
   
  +## Selecting Elements with a Comma-separated List of Selectors
  +
  +```
  +$( "div.myClass, ul.people" );
  +```
  +
   ## Pseudo-Selectors
   
   ```
  @@ -54,16 +60,8 @@ Elements that have not been added to the DOM will always be considered hidden, e
   
   ## Choosing Selectors
   
  -Choosing good selectors is one way to improve JavaScript's performance. A little specificity – for example, including an element type when selecting elements by class name – can go a long way. On the other hand, too much specificity can be a bad thing. A selector such as `#myTable thead tr th.special` is overkill if a selector such as `#myTable th.special` will get the job done.
  -
  -jQuery offers many attribute-based selectors, allowing selections based on the content of arbitrary attributes using simplified regular expressions.
  -
  -```
  -// Find all  elements whose rel attribute ends with "thinger".
  -$( "a[rel$='thinger']" );
  -```
  +Choosing good selectors is one way to improve JavaScript's performance. Too much specificity can be a bad thing. A selector such as `#myTable thead tr th.special` is overkill if a selector such as `#myTable th.special` will get the job done.
   
  -While these can be useful in a pinch, they can also be extremely slow in older browsers. Wherever possible, make selections using IDs, class names, and tag names.
   
   ### Does My Selection Contain Any Elements?
   
  
  From 987b2dac4ce31a2ea2b5f24e7aa7b55b4c4f2472 Mon Sep 17 00:00:00 2001
  From: Karl Swedberg 
  Date: Mon, 14 Mar 2016 08:54:14 -0400
  Subject: [PATCH 46/91] jQuery Deferreds: Improve last example and provide more
   detailed explanation
  
  ---
   .../deferreds/jquery-deferreds.md             | 31 +++++++++++++------
   1 file changed, 21 insertions(+), 10 deletions(-)
  
  diff --git a/page/code-organization/deferreds/jquery-deferreds.md b/page/code-organization/deferreds/jquery-deferreds.md
  index 83e02412..0c3621c8 100644
  --- a/page/code-organization/deferreds/jquery-deferreds.md
  +++ b/page/code-organization/deferreds/jquery-deferreds.md
  @@ -37,9 +37,9 @@ $.when(
   ).then( successFunc, failureFunc );
   ```
   
  -The `$.when()` implementation offered in jQuery is quite interesting as it not only interprets deferred objects, but when passed arguments that are not deferreds, it treats these as if they were resolved deferreds and executes any callbacks (doneCallbacks) right away. It is also worth noting that jQuery's deferred implementation, in addition to exposing deferred.then(), a jQuery promise also supports the deferred.done() and deferred.fail() methods which can also be used to add callbacks to the deferred's queues.
  +The `$.when()` implementation offered in jQuery is quite interesting as it not only interprets deferred objects, but when passed arguments that are not deferreds, it treats these as if they were resolved deferreds and executes any callbacks (`doneCallbacks`) right away. It is also worth noting that jQuery's deferred implementation, in addition to exposing `deferred.then()`, also supports the `deferred.done()` and `deferred.fail()` methods which can also be used to add callbacks to the deferred's queues.
   
  -We will now take a look at a code example that utilizes many of the deferred features mentioned in the table presented earlier. Here is a very basic application that consumes (1) an external news feed and (2) a reactions feed for pulling in the latest comments via `$.get()` (which will return a promise). The application also has a function (`prepareInterface()`) which returns a promise to complete animating our containers for both the news and reactions.
  +We will now take a look at a code example that uses many deferred features. This very basic script begins by consuming (1) an external news feed and (2) a reactions feed for pulling in the latest comments via `$.get()` (which will return a promise-like object). When both requests are received, the `showAjaxedContent()` function is called. The `showAjaxedContent()` function returns a promise that is resolved when animating both containers has completed. When the `showAjaxedContent()` promise is resolved, `removeActiveClass()` is called. The `removeActiveClass()` returns a promise that is resolved inside a `setTimeout()` after 4 seconds have elapsed. Finally, after the `removeActiveClass()` promise is resolved, the last `then()` callback is called, provided no errors occurred along the way.
   
   ```
   function getLatestNews() {
  @@ -56,20 +56,31 @@ function getLatestReactions() {
   	});
   }
   
  -function prepareInterface() {
  +function showAjaxedContent() {
  +	// The .promise() is resolved *once*, after all animations complete
  +	return $( ".news, .reactions" ).slideDown( 500, function() {
  +		// Called once *for each element* when animation completes
  +		$(this).addClass( "active" );
  +	}).promise();
  +}
  +
  +function removeActiveClass() {
   	return $.Deferred(function( dfd ) {
  -		var latest = $( ".news, .reactions" );
  -			latest.slideDown( 500, dfd.resolve );
  -			latest.addClass( "active" );
  +		setTimeout(function () {
  +			$( ".news, .reactions" ).removeClass( "active" );
  +			dfd.resolve();
  +		}, 4000);
   	}).promise();
   }
   
   $.when(
   	getLatestNews(),
  -	getLatestReactions(),
  -	prepareInterface()
  -).then(function() {
  -	console.log( "fire after requests succeed" );
  +	getLatestReactions()
  +)
  +.then(showAjaxedContent)
  +.then(removeActiveClass)
  +.then(function() {
  +	console.log( "Requests succeeded and animations completed" );
   }).fail(function() {
   	console.log( "something went wrong!" );
   });
  
  From 9878874bfc350e44c2b8137cb3245e3ce4eb4a9b Mon Sep 17 00:00:00 2001
  From: Karl Swedberg 
  Date: Mon, 14 Mar 2016 08:54:35 -0400
  Subject: [PATCH 47/91] 0.6.21
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 6bf99d33..8b528786 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.20",
  +  "version": "0.6.21",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From cb2c81b5816f112368c34090f4214bf613c1b881 Mon Sep 17 00:00:00 2001
  From: Thomas Tortorini 
  Date: Wed, 16 Mar 2016 19:30:39 +0100
  Subject: [PATCH 48/91] optimize-selectors qSA before Sizzle
  
  ---
   page/performance/optimize-selectors.md | 29 +++++++++++++++++---------
   1 file changed, 19 insertions(+), 10 deletions(-)
  
  diff --git a/page/performance/optimize-selectors.md b/page/performance/optimize-selectors.md
  index 44f3b8e6..fa923974 100644
  --- a/page/performance/optimize-selectors.md
  +++ b/page/performance/optimize-selectors.md
  @@ -21,6 +21,18 @@ $( "#my-table tr:nth-child(odd)" );
   
   Keep in mind that many jQuery extensions, including `:even` in the above example, do not have exact equivalents in the CSS specification. In some situations the convenience of these extensions could outweigh their performance cost.
   
  +## Try to segregate the nonstandard parts of your selection
  +
  +When you select elements, jQuery will call `querySelectorAll` with your selection. If `querySelectorAll` throws an error, jQuery will refer to its Sizzle engine. So, if you are using at least one of the nonstandard pseudo-classes such as `:contains()`, `:has`, `:even`, `:submit`, etc. You will not take advantage of the native `querySelectorAll`.
  +
  +```
  +// A long selection with nonstandard pseudo-classes inside
  +$( "#global.ready .part .list li a:contains('qwerty'):first" );
  +
  +// A long standard selection with a filter outside (faster):
  +$( "#global.ready .part .list li a").filter( ":contains('qwerty'):first" );
  +```
  +
   ## Avoid Excessive Specificity
   
   ```
  @@ -32,16 +44,15 @@ $( ".data td.gonzalez" );
   
   A "flatter" DOM also helps improve selector performance, as the selector engine has fewer layers to traverse when looking for an element.
   
  -## ID-Based Selectors
  -
  -Beginning your selector with an ID is a safe bet.
  +## Save calls to `querySelectorAll`
   
   ```
  -// Fast:
  -$( "#container div.robotarm" );
  +// If in your HTML there are 2 .container with 5 div in each,
  +// this line will call querySelectorAll 13 times (1 + 2 + 2*5).
  +$( ".container" ).children( "div" ).find( ".robotarm" );
   
  -// Super-fast:
  -$( "#container" ).find( "div.robotarm" );
  +// Against only 1 call with this:
  +$( ".container div .robotarm" );
   ```
   
   With the first approach, jQuery queries the DOM using `document.querySelectorAll()`. With the second, jQuery uses `document.getElementById()`, which is faster, although the speed improvement may be diminished by the subsequent call to `.find()`.
  @@ -51,6 +62,7 @@ With the first approach, jQuery queries the DOM using `document.querySelectorAll
   When support for older browsers, such as Internet Explorer 8 and below, is necessary, consider the following tips:
   
   ### Specificity
  +
   Be specific on the right-hand side of your selector, and less specific on the left.
   
   ```
  @@ -68,9 +80,6 @@ Use `tag.class` if possible on your right-most selector, and just tag or just `.
   Selections that specify or imply that a match could be found anywhere can be very slow.
   
   ```
  -$( ".buttons > *" ); // Extremely expensive.
  -$( ".buttons" ).children(); // Much better.
  -
   $( ":radio" ); // Implied universal selection.
   $( "*:radio" ); // Same thing, explicit now.
   $( "input:radio" ); // Much better.
  
  From c895d3f2709e7e0faab7e186bcba9fe4426fbe27 Mon Sep 17 00:00:00 2001
  From: Thomas Tortorini 
  Date: Thu, 17 Mar 2016 16:56:13 +0100
  Subject: [PATCH 49/91] remove another old sentence
  
  ---
   page/performance/optimize-selectors.md | 2 --
   1 file changed, 2 deletions(-)
  
  diff --git a/page/performance/optimize-selectors.md b/page/performance/optimize-selectors.md
  index fa923974..c90aa987 100644
  --- a/page/performance/optimize-selectors.md
  +++ b/page/performance/optimize-selectors.md
  @@ -55,8 +55,6 @@ $( ".container" ).children( "div" ).find( ".robotarm" );
   $( ".container div .robotarm" );
   ```
   
  -With the first approach, jQuery queries the DOM using `document.querySelectorAll()`. With the second, jQuery uses `document.getElementById()`, which is faster, although the speed improvement may be diminished by the subsequent call to `.find()`.
  -
   ## Tips for Older Browsers
   
   When support for older browsers, such as Internet Explorer 8 and below, is necessary, consider the following tips:
  
  From 1216af95067d410372ea1ee2e2d648b6b4436da9 Mon Sep 17 00:00:00 2001
  From: Thomas Tortorini 
  Date: Sat, 19 Mar 2016 15:41:05 +0100
  Subject: [PATCH 50/91] A small introduction for  + remove a semi colon
  
  ---
   page/performance/optimize-selectors.md | 4 +++-
   1 file changed, 3 insertions(+), 1 deletion(-)
  
  diff --git a/page/performance/optimize-selectors.md b/page/performance/optimize-selectors.md
  index c90aa987..45304b9e 100644
  --- a/page/performance/optimize-selectors.md
  +++ b/page/performance/optimize-selectors.md
  @@ -29,7 +29,7 @@ When you select elements, jQuery will call `querySelectorAll` with your selectio
   // A long selection with nonstandard pseudo-classes inside
   $( "#global.ready .part .list li a:contains('qwerty'):first" );
   
  -// A long standard selection with a filter outside (faster):
  +// A long standard selection with a filter outside (faster)
   $( "#global.ready .part .list li a").filter( ":contains('qwerty'):first" );
   ```
   
  @@ -46,6 +46,8 @@ A "flatter" DOM also helps improve selector performance, as the selector engine
   
   ## Save calls to `querySelectorAll`
   
  +`querySelectorAll` is already really fast, if you want maintain this speed try to call it the least possible.
  +
   ```
   // If in your HTML there are 2 .container with 5 div in each,
   // this line will call querySelectorAll 13 times (1 + 2 + 2*5).
  
  From 01858b0b67938fd20730e4939339b421dd086d1b Mon Sep 17 00:00:00 2001
  From: Anne-Gaelle Colom 
  Date: Wed, 30 Mar 2016 20:12:44 +0100
  Subject: [PATCH 51/91] Build: Update grunt-jquery-content to 3.0.1
  
  Closes gh-708
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 8b528786..8fb383e6 100644
  --- a/package.json
  +++ b/package.json
  @@ -22,7 +22,7 @@
     ],
     "dependencies": {
       "grunt": "0.4.5",
  -    "grunt-jquery-content": "3.0.0",
  +    "grunt-jquery-content": "3.0.1",
       "spawnback": "1.0.0"
     }
   }
  
  From 7d4f48256b41d09cc685da54a88c8e7296171262 Mon Sep 17 00:00:00 2001
  From: Kris Borchers 
  Date: Wed, 13 Apr 2016 16:12:52 -0500
  Subject: [PATCH 52/91] Mobile: Update themeroller image to remove bulls eye
  
  ---
   resources/jquery-mobile/Theme.png | Bin 45355 -> 49690 bytes
   1 file changed, 0 insertions(+), 0 deletions(-)
  
  diff --git a/resources/jquery-mobile/Theme.png b/resources/jquery-mobile/Theme.png
  index 9fc9b3ece29f40575c500927a016ffaa2a5633c2..0052542e87d1953036984b3cab6ce9f7dcef5706 100644
  GIT binary patch
  literal 49690
  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Μ?kr<4FKf{cR$
  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
  b?Y%=bFK*}UIFp|KQ?*Ko$%|GA8wCDeAFp`$
  
  literal 45355
  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
  h|Lr9ENqr-RCKdPO_3NXl8Z_|dg}ka
  Date: Wed, 13 Apr 2016 16:14:51 -0500
  Subject: [PATCH 53/91] 0.6.22
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 8fb383e6..5996c5d8 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.21",
  +  "version": "0.6.22",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From 018aff8d70321b5b4df774314c3d8b7965a50aed Mon Sep 17 00:00:00 2001
  From: Moorthy Venkatraman 
  Date: Fri, 29 Apr 2016 22:49:51 -0400
  Subject: [PATCH 54/91] Update key-concepts with XDomainRequest limitation
   (#572)
  
  * Update key-concepts with XDomainRequest limitation
  * Update IE's limited support info
  ---
   page/ajax/key-concepts.md | 4 +++-
   1 file changed, 3 insertions(+), 1 deletion(-)
  
  diff --git a/page/ajax/key-concepts.md b/page/ajax/key-concepts.md
  index bda84ee7..68f14596 100644
  --- a/page/ajax/key-concepts.md
  +++ b/page/ajax/key-concepts.md
  @@ -71,7 +71,9 @@ $.get( "foo.php", function( response ) {
   
   ### Same-Origin Policy and JSONP
   
  -In general, Ajax requests are limited to the same protocol (http or https), the same port, and the same domain as the page making the request. This limitation does not apply to scripts that are loaded via jQuery's Ajax methods.
  +In general, Ajax requests are limited to the same protocol (http or https), the same port, and the same domain as the page making the request. This limitation does not apply to scripts that are loaded via jQuery's Ajax methods. 
  +
  +Note: Versions of Internet Explorer less than 10 do not support cross-domain AJAX requests. 
   
   The other exception is requests targeted at a JSONP service on another domain. In the case of JSONP, the provider of the service has agreed to respond to your request with a script that can be loaded into the page using a `
   
  -Because jQuery uses CSS syntax for selecting elements, some characters are interpreted as CSS notation. For example, ID attributes, after an initial letter (a-z or A-Z), may also use periods and colons, in addition to letters, numbers, hyphens, and underscores (see [W3C Basic HTML Data Types](http://www.w3.org/TR/html4/types.html#type-id)). The colon (":") and period (".") are problematic within the context of a jQuery selector because they indicate a pseudo-class and class, respectively.
  +Because jQuery uses CSS syntax for selecting elements, some characters are interpreted as CSS notation. In order to tell jQuery to treat these characters literally rather than as CSS notation, they must be escaped by placing two backslashes in front of them.
   
  -In order to tell jQuery to treat these characters literally rather than as CSS notation, they must be "escaped" by placing two backslashes in front of them.
  +See the [Selector documentation](http://api.jquery.com/category/selectors/) for further details.
   
   ```
   // Does not work:
  @@ -25,7 +25,7 @@ The following function takes care of escaping these characters and places a "#"
   ```
   function jq( myid ) {
   
  -	return "#" + myid.replace( /(:|\.|\[|\]|,)/g, "\\$1" );
  +	return "#" + myid.replace( /(:|\.|\[|\]|,|=)/g, "\\$1" );
   
   }
   ```
  
  From c22de98667b5819e49aaa75c9fc4dae28218dbf0 Mon Sep 17 00:00:00 2001
  From: TJ VanToll 
  Date: Sun, 30 Nov 2014 11:33:45 -0500
  Subject: [PATCH 56/91] =?UTF-8?q?jQuery=20UI:=20Article=20on=20the=20class?=
   =?UTF-8?q?es=20option=20=E2=80=94=20new=20to=20jQuery=20UI=201.12?=
  MIME-Version: 1.0
  Content-Type: text/plain; charset=UTF-8
  Content-Transfer-Encoding: 8bit
  
  Closes gh-727
  Closes gh-574
  ---
   order.json                                    |  3 +-
   .../widget-factory/classes-option.md          | 87 +++++++++++++++++++
   2 files changed, 89 insertions(+), 1 deletion(-)
   create mode 100644 page/jquery-ui/widget-factory/classes-option.md
  
  diff --git a/order.json b/order.json
  index ee998761..38e12a24 100644
  --- a/order.json
  +++ b/order.json
  @@ -116,7 +116,8 @@
             "why-use-the-widget-factory",
             "how-to-use-the-widget-factory",
             "widget-method-invocation",
  -          "extending-widgets"
  +          "extending-widgets",
  +          "classes-option"
           ]
         },
         {
  diff --git a/page/jquery-ui/widget-factory/classes-option.md b/page/jquery-ui/widget-factory/classes-option.md
  new file mode 100644
  index 00000000..f5504f47
  --- /dev/null
  +++ b/page/jquery-ui/widget-factory/classes-option.md
  @@ -0,0 +1,87 @@
  +
  +
  +As of the 1.12 release, the jQuery UI widget factory includes a means of managing CSS class names through the [`classes` option](http://api.jqueryui.com/jquery.widget/#option-classes). This article will give you an overview of how the `classes` option works, and discuss what you can do with it.
  +
  +## Syntax overview
  +
  +The `classes` option is used to map structural class names to theme-related class names that you define. To see what this means let's look at an example. The code below uses the `classes` option to create a red dialog:
  +
  +```
  +
  +
  +```
  +
  +Here, the presentational `custom-red` class name is associated with the structural `ui-dialog` class name. Now, whenever the dialog applies the `ui-dialog` class name, it will also add a `custom-red` class name. However, something other than adding the `custom-red` class has happened here, which isn't immediately obvious. This code also *removes* the existing default value which was `"ui-corner-all"`. You can associate multiple class names by including multiple space-delimited class names in the object's value. For instance the following code creates a dialog that is red and still has rounded corners:
  +
  +```
  +
  +
  +```
  +
  +*Note: To get a full list of the class names you can use with the `classes` option, check the API documentation for the jQuery UI widget you're interested in. For example, here's the list of classes for the dialog width: .*
  +
  +The `classes` option works like any other widget factory option, which means all the widget factory option mechanisms still apply. For instance, the following code uses the [`option()` method](http://api.jqueryui.com/jquery.widget/#method-option) to remove all class names currently associated with the `ui-dialog` class name:
  +
  +```
  +dialog.dialog( "option", "classes.ui-dialog", null );
  +```
  +
  +And the following creates a [widget extension](http://learn.jquery.com/jquery-ui/widget-factory/extending-widgets/) that automatically associates the `custom-red` class with the `ui-dialog` class:
  +
  +```
  +
  +
  +```
  +
  +As an added benefit, the widget factory also removes any class names specified in the `classes` option when the widget is destroyed.
  +
  +## Theming
  +
  +As the previous examples show, the `classes` option provides a quick way to associate theme-related class names with the structural class names used within a widget. This approach works for simple cases, but it can also be used to adapt third-party themes to work with widget-factory-built widgets. For example, if you're using [Bootstrap](http://getbootstrap.com/) and jQuery UI together, you can use the following code to create a jQuery UI dialog that uses Bootstrap's theming:
  +
  +```
  +$.extend( $.ui.dialog.prototype.options.classes, {
  +	"ui-dialog": "modal-content",
  +	"ui-dialog-titlebar": "modal-header",
  +	"ui-dialog-title": "modal-title",
  +	"ui-dialog-titlebar-close": "close",
  +	"ui-dialog-content": "modal-body",
  +	"ui-dialog-buttonpane": "modal-footer"
  +});
  +```
  +
  +For more examples of this approach, check out [Alexander Schmitz's repo](https://github.com/arschmitz/jqueryui-bootstrap-adapter) that adapts jQuery UI to work with Boostrap using the `classes` option.
  +
  +## Conclusion
  +
  +The introduction of the `classes` option takes us one step further in the split between structural and theme-related classes, making it easier than ever to make jQuery UI widgets match the look and feel of your existing site. At the same time, this allows jQuery UI to be used alongside other CSS frameworks, just like jQuery can be used alongside other JavaScript frameworks.
  
  From 08e3a1364ab14ec87ccd61896b0f59840c850ae2 Mon Sep 17 00:00:00 2001
  From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= 
  Date: Thu, 15 Sep 2016 10:30:47 -0400
  Subject: [PATCH 57/91] 0.6.23
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 5996c5d8..93b7b8b7 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.22",
  +  "version": "0.6.23",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From 3ed1f8e5f8de85fe55230507046616e3e9ab2ebb Mon Sep 17 00:00:00 2001
  From: Kris Borchers 
  Date: Mon, 10 Oct 2016 15:04:59 -0500
  Subject: [PATCH 58/91] 0.6.24
  
  ---
   package.json | 2 +-
   1 file changed, 1 insertion(+), 1 deletion(-)
  
  diff --git a/package.json b/package.json
  index 93b7b8b7..4dd4af5b 100644
  --- a/package.json
  +++ b/package.json
  @@ -2,7 +2,7 @@
     "name": "learn.jquery.com",
     "title": "jQuery Learning Site",
     "description": "jQuery Foundation site for learning jQuery and JavaScript",
  -  "version": "0.6.23",
  +  "version": "0.6.24",
     "homepage": "http://learn.jquery.com",
     "author": {
       "name": "jQuery Foundation and other contributors"
  
  From a027005501391797d592e274eb4dce239813b3f8 Mon Sep 17 00:00:00 2001
  From: Brian Salomaki 
  Date: Tue, 29 Nov 2016 22:00:45 -0600
  Subject: [PATCH 59/91] Replace $(window).load with $(window).on( "load" )
  
  Closes gh-736
  ---
   page/using-jquery-core/document-ready.md | 8 ++++----
   1 file changed, 4 insertions(+), 4 deletions(-)
  
  diff --git a/page/using-jquery-core/document-ready.md b/page/using-jquery-core/document-ready.md
  index da379ebe..90a98ea8 100644
  --- a/page/using-jquery-core/document-ready.md
  +++ b/page/using-jquery-core/document-ready.md
  @@ -3,7 +3,7 @@
   	"level": "beginner"
   }
   
  -A page can't be manipulated safely until the document is "ready." jQuery detects this state of readiness for you. Code included inside `$( document ).ready()` will only run once the page Document Object Model (DOM) is ready for JavaScript code to execute. Code included inside `$( window ).load(function() { ... })` will run once the entire page (images or iframes), not just the DOM, is ready.
  +A page can't be manipulated safely until the document is "ready." jQuery detects this state of readiness for you. Code included inside `$( document ).ready()` will only run once the page Document Object Model (DOM) is ready for JavaScript code to execute. Code included inside `$( window ).on( "load", function() { ... })` will run once the entire page (images or iframes), not just the DOM, is ready.
   
   ```
   // A $( document ).ready() block.
  @@ -32,10 +32,10 @@ function readyFn( jQuery ) {
   
   $( document ).ready( readyFn );
   // or:
  -$( window ).load( readyFn );
  +$( window ).on( "load", readyFn );
   ```
   
  -The example below shows `$( document ).ready()` and `$( window ).load()` in action. The code tries to load a website URL in an `