Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Notes: Added a preprocess step to create the XInclude nodes based on …

…note@id inside entry. Changed note placeholders from elements to data- attributes. Brought in only string escaping from xml2json rather than a wholesale import as otherwise apply-templates always matches xml2json templates, making it unusable generally.
  • Loading branch information...
commit 8d741f7118f0fa14ab3d40d4f8258b056ecfc5c5 1 parent 96f3fec
@rdworth rdworth authored
Showing with 526 additions and 518 deletions.
  1. +1 −0  .gitignore
  2. +338 −320 categories.xml
  3. +1 −3 entries/animate.xml
  4. +1 −3 entries/animated-selector.xml
  5. +1 −4 entries/attribute-not-equal-selector.xml
  6. +1 −3 entries/button-selector.xml
  7. +1 −4 entries/checkbox-selector.xml
  8. +1 −2  entries/delegate.xml
  9. +1 −4 entries/eq-selector.xml
  10. +2 −5 entries/even-selector.xml
  11. +1 −3 entries/fadeIn.xml
  12. +1 −3 entries/fadeOut.xml
  13. +1 −3 entries/fadeTo.xml
  14. +1 −3 entries/fadeToggle.xml
  15. +1 −4 entries/file-selector.xml
  16. +2 −5 entries/first-selector.xml
  17. +1 −4 entries/gt-selector.xml
  18. +1 −4 entries/has-selector.xml
  19. +1 −3 entries/header-selector.xml
  20. +1 −3 entries/hidden-selector.xml
  21. +1 −3 entries/hide.xml
  22. +1 −4 entries/image-selector.xml
  23. +1 −3 entries/input-selector.xml
  24. +2 −4 entries/jQuery.ajax.xml
  25. +3 −7 entries/jQuery.get.xml
  26. +2 −4 entries/jQuery.getJSON.xml
  27. +1 −3 entries/jQuery.post.xml
  28. +1 −3 entries/last-selector.xml
  29. +1 −4 entries/lt-selector.xml
  30. +1 −3 entries/odd-selector.xml
  31. +1 −3 entries/parent-selector.xml
  32. +1 −4 entries/password-selector.xml
  33. +2 −4 entries/prop.xml
  34. +1 −4 entries/radio-selector.xml
  35. +1 −4 entries/reset-selector.xml
  36. +1 −3 entries/selected-selector.xml
  37. +1 −3 entries/show.xml
  38. +1 −3 entries/slideDown.xml
  39. +1 −3 entries/slideToggle.xml
  40. +1 −3 entries/slideUp.xml
  41. +1 −4 entries/submit-selector.xml
  42. +1 −4 entries/text-selector.xml
  43. +1 −3 entries/toggle.xml
  44. +1 −3 entries/visible-selector.xml
  45. +32 −3 entries2html.xsl
  46. +41 −21 grunt.js
  47. +4 −1 notes/document-order.xml
  48. +4 −2 notes/domlint.xml
  49. +4 −4 notes/jquery-selector-extension-alt.xml
  50. +4 −4 notes/jquery-selector-extension.xml
  51. +4 −1 notes/jquery.fx.off.xml
  52. +4 −1 notes/no-data-on-xml.xml
  53. +4 −1 notes/prop-memory-leaks.xml
  54. +4 −1 notes/propagation-for-live-or-delegate.xml
  55. +4 −1 notes/same-origin-policy-exceptions.xml
  56. +4 −4 notes/same-origin-policy.xml
  57. +4 −4 notes/use-ajaxerror.xml
  58. +2 −1  package.json
  59. +19 −0 preproc-xinclude.xsl
View
1  .gitignore
@@ -1,4 +1,5 @@
dist
+entries_tmp
node_modules
config.json
.project
View
658 categories.xml
@@ -1,367 +1,385 @@
+<?xml version="1.0"?>
<categories>
- <category name="Ajax" slug="ajax">
- <desc>The jQuery library has a full suite of AJAX capabilities. The functions and methods therein allow us to load data from the server without a browser page refresh. </desc>
- <category name="Global Ajax Event Handlers" slug="global-ajax-event-handlers">
- <desc>These methods register handlers to be called when certain events, such as initialization or completion, take place for any AJAX request on the page. The global events are fired on each AJAX request if the <code>global</code> property in <a href="http://api.jquery.com/jQuery.ajaxSetup/"><code>jQuery.ajaxSetup()</code></a> is <code>true</code>, which it is by default. <em>Note: Global events are never fired for cross-domain script or JSONP requests, regardless of the value of <code>global</code>.</em></desc>
- </category>
- <category name="Helper Functions" slug="helper-functions">
- <desc>These functions assist with common idioms encountered when performing AJAX tasks.</desc>
- </category>
- <category name="Low-Level Interface" slug="low-level-interface">
- <desc>These methods can be used to make arbitrary AJAX requests.</desc>
- </category>
- <category name="Shorthand Methods" slug="shorthand-methods">
- <desc>These methods perform the more common types of AJAX requests in less code.</desc>
- </category>
- </category>
- <category name="Attributes" slug="attributes">
- <desc>These methods get and set DOM attributes of elements.</desc>
- </category>
- <category name="Callbacks Object" slug="callbacks-object">
- <desc>The <code>jQuery.Callbacks()</code> function, introduced in version 1.7, returns a multi-purpose object that provides a powerful way to manage callback lists. It supports adding, removing, firing, and disabling callbacks.</desc>
- </category>
- <category name="Core" slug="core">
- <desc></desc>
- </category>
- <category name="CSS" slug="css">
- <desc>These methods get and set CSS-related properties of elements.</desc>
- </category>
- <category name="Data" slug="data">
- <desc>These methods allow us to associate arbitrary data with specific DOM elements.</desc>
- </category>
- <category name="Deferred Object" slug="deferred-object">
- <desc>
- <p><code>jQuery.Deferred()</code>, introduced in version 1.5, is a chainable utility object that can register multiple callbacks into callback queues, invoke callback queues, and relay the success or failure state of any synchronous or asynchronous function.</p>
- <div class="longdesc">
- <p>In JavaScript it is common to invoke functions that optionally accept callbacks that are called within that function.</p>
- <p>For example, in versions prior to jQuery 1.5, asynchronous processes such as <code>jQuery.ajax()</code> accept callbacks to be invoked some time in the near-future upon success, error, and completion of the ajax request.</p>
- <p><code>jQuery.Deferred()</code> introduces several enhancements to the way callbacks are managed and invoked. In particular, <code>jQuery.Deferred()</code> provides flexible ways to provide multiple callbacks, and these callbacks can be invoked regardless of whether the original callback dispatch has already occurred. jQuery Deferred is based on the <a href="http://wiki.commonjs.org/wiki/Promises/A">CommonJS Promises/A</a> design.</p>
- <p>One model for understanding Deferred is to think of it as a chain-aware function wrapper. The <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a>, <a href="http://api.jquery.com/deferred.done"><code>deferred.done()</code></a>, and <a href="http://api.jquery.com/deferred.fail"><code>deferred.fail()</code></a> methods specify the functions to be called and the <a href="http://api.jquery.com/deferred.resolve"><code>deferred.resolve(args)</code></a> or <a href="http://api.jquery.com/deferred.reject"><code>deferred.reject(args)</code></a> methods "call" the functions with the arguments you supply. Once the Deferred has been resolved or rejected it stays in that state; a second call to <code>deferred.resolve()</code> is ignored for example. If more functions are added by <code>deferred.then()</code> after the Deferred is resolved, they are called immediately with the arguments previously provided.</p>
- <p>In most cases where a jQuery API call returns a Deferred or Deferred-compatible object, such as <a href="http://api.jquery.com/jQuery.ajax"><code>jQuery.ajax()</code></a> or <a href="http://api.jquery.com/jQuery.when"><code>jQuery.when()</code></a>, you will only want to use the <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a>, <a href="http://api.jquery.com/deferred.done"><code>deferred.done()</code></a>, and <a href="http://api.jquery.com/deferred.fail"><code>deferred.fail()</code></a> methods to add callbacks to the Deferred's queues. The internals of the API call or code that created the Deferred will invoke <a href="http://api.jquery.com/deferred.resolve"><code>deferred.resolve()</code></a> or <a href="http://api.jquery.com/deferred.reject"><code>deferred.reject()</code></a> on the deferred at some point, causing the appropriate callbacks to run.</p>
- <h4>jQuery.Deferred Constructor</h4>
- <p>The <code>jQuery.Deferred()</code> constructor creates a new Deferred object. The <code>new</code> operator is optional.</p>
- <p><code>jQuery.Deferred</code> can be passed an optional function, which is called just before the constructor returns and is passed the constructed <code>deferred</code> object as both the <code>this</code> object and as the first argument to the function. The called function can attach callbacks using <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a> for example.</p>
- <p>A Deferred object starts in the <em>pending</em> state. Any callbacks added to the object with <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a>, <a href="http://api.jquery.com/deferred.done"><code>deferred.done()</code></a>, or <a href="http://api.jquery.com/deferred.fail"><code>deferred.fail()</code></a> are queued to be executed later. Calling <a href="http://api.jquery.com/deferred.resolve"><code>deferred.resolve()</code></a> or <a href="http://api.jquery.com/deferred.resolveWith"><code>deferred.resolveWith()</code></a> transitions the Deferred into the <em>resolved</em> state and immediately executes any <code>doneCallbacks</code> that are set. Calling <a href="http://api.jquery.com/deferred.reject"><code>deferred.reject()</code></a> or <a href="http://api.jquery.com/deferred.rejectWith"><code>deferred.rejectWith()</code></a> transitions the Deferred into the <em>rejected</em> state and immediately executes any <code>failCallbacks</code> that are set. Once the object has entered the resolved or rejected state, it stays in that state. Callbacks can still be added to the resolved or rejected Deferred -- they will execute immediately.</p>
- <p>The Deferred object is chainable, similar to the way a jQuery object is chainable, but it has its own methods. After creating a Deferred object, you can use any of the methods below by either chaining directly from the object creation or saving the object in a variable and invoking one or more methods on that variable.</p>
- </div>
- </desc>
- </category>
- <category name="Deprecated" slug="deprecated">
- <desc>These items have been deprecated, though not necessarily removed, from jQuery.</desc>
- </category>
- <category name="Dimensions" slug="dimensions">
- <desc></desc>
- </category>
- <category name="Effects" slug="effects">
- <desc>The jQuery library provides several techniques for adding animation to a web page. These include simple, standard animations that are frequently used, and the ability to craft sophisticated custom effects. In this chapter, we'll closely examine each of the effect methods, revealing all of the mechanisms jQuery has for providing visual feedback to the user.</desc>
- <category name="Basics" slug="basics">
- <desc></desc>
- </category>
- <category name="Custom" slug="custom-effects">
- <desc>These methods allow you to create effects that are not provided "out of the box" by jQuery.</desc>
- </category>
- <category name="Fading" slug="fading">
- <desc>These methods adjust the opacity of elements.</desc>
- </category>
- <category name="Sliding" slug="sliding">
- <desc></desc>
- </category>
- </category>
- <category name="Events" slug="events">
- <desc>These methods are used to register behaviors to take effect when the user interacts with the browser, and to further manipulate those registered behaviors.</desc>
- <category name="Browser Events" slug="browser-events">
- <desc></desc>
- </category>
- <category name="Document Loading" slug="document-loading">
- <desc></desc>
- </category>
- <category name="Event Handler Attachment" slug="event-handler-attachment">
- <desc></desc>
- </category>
- <category name="Event Object" slug="event-object">
- <desc>
- <p>jQuery's event system normalizes the event object according to <a href="http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html">W3C standards</a>. The event object is guaranteed to be passed to the event handler. Most properties from the original event are copied over and normalized to the new event object.</p>
- <div class="longdesc">
- <h4>jQuery.Event Constructor</h4>
- <p>The <code>jQuery.Event</code> constructor is exposed and can be used when calling <a href="/trigger">trigger</a>. The <code>new</code> operator is optional.</p>
- <p>Check <a href="/trigger">trigger</a>'s documentation to see how to combine it with your own event object.</p>
- <p>Example:</p>
- <pre><code><![CDATA[ //Create a new jQuery.Event object without the "new" operator.
+ <category name="Ajax" slug="ajax">
+ <desc>The jQuery library has a full suite of AJAX capabilities. The functions and methods therein allow us to load data from the server without a browser page refresh. </desc>
+ <category name="Global Ajax Event Handlers" slug="global-ajax-event-handlers">
+ <desc>These methods register handlers to be called when certain events, such as initialization or completion, take place for any AJAX request on the page. The global events are fired on each AJAX request if the <code>global</code> property in <a href="http://api.jquery.com/jQuery.ajaxSetup/"><code>jQuery.ajaxSetup()</code></a> is <code>true</code>, which it is by default. <em>Note: Global events are never fired for cross-domain script or JSONP requests, regardless of the value of <code>global</code>.</em></desc>
+ </category>
+ <category name="Helper Functions" slug="helper-functions">
+ <desc>These functions assist with common idioms encountered when performing AJAX tasks.</desc>
+ </category>
+ <category name="Low-Level Interface" slug="low-level-interface">
+ <desc>These methods can be used to make arbitrary AJAX requests.</desc>
+ </category>
+ <category name="Shorthand Methods" slug="shorthand-methods">
+ <desc>These methods perform the more common types of AJAX requests in less code.</desc>
+ </category>
+ </category>
+ <category name="Attributes" slug="attributes">
+ <desc>These methods get and set DOM attributes of elements.</desc>
+ </category>
+ <category name="Callbacks Object" slug="callbacks-object">
+ <desc>The <code>jQuery.Callbacks()</code> function, introduced in version 1.7, returns a multi-purpose object that provides a powerful way to manage callback lists. It supports adding, removing, firing, and disabling callbacks.</desc>
+ </category>
+ <category name="Core" slug="core">
+ <desc/>
+ </category>
+ <category name="CSS" slug="css">
+ <desc>These methods get and set CSS-related properties of elements.</desc>
+ </category>
+ <category name="Data" slug="data">
+ <desc>These methods allow us to associate arbitrary data with specific DOM elements.</desc>
+ </category>
+ <category name="Deferred Object" slug="deferred-object">
+ <desc>
+ <p><code>jQuery.Deferred()</code>, introduced in version 1.5, is a chainable utility object that can register multiple callbacks into callback queues, invoke callback queues, and relay the success or failure state of any synchronous or asynchronous function.</p>
+ <div class="longdesc">
+ <p>In JavaScript it is common to invoke functions that optionally accept callbacks that are called within that function.</p>
+ <p>For example, in versions prior to jQuery 1.5, asynchronous processes such as <code>jQuery.ajax()</code> accept callbacks to be invoked some time in the near-future upon success, error, and completion of the ajax request.</p>
+ <p><code>jQuery.Deferred()</code> introduces several enhancements to the way callbacks are managed and invoked. In particular, <code>jQuery.Deferred()</code> provides flexible ways to provide multiple callbacks, and these callbacks can be invoked regardless of whether the original callback dispatch has already occurred. jQuery Deferred is based on the <a href="http://wiki.commonjs.org/wiki/Promises/A">CommonJS Promises/A</a> design.</p>
+ <p>One model for understanding Deferred is to think of it as a chain-aware function wrapper. The <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a>, <a href="http://api.jquery.com/deferred.done"><code>deferred.done()</code></a>, and <a href="http://api.jquery.com/deferred.fail"><code>deferred.fail()</code></a> methods specify the functions to be called and the <a href="http://api.jquery.com/deferred.resolve"><code>deferred.resolve(args)</code></a> or <a href="http://api.jquery.com/deferred.reject"><code>deferred.reject(args)</code></a> methods "call" the functions with the arguments you supply. Once the Deferred has been resolved or rejected it stays in that state; a second call to <code>deferred.resolve()</code> is ignored for example. If more functions are added by <code>deferred.then()</code> after the Deferred is resolved, they are called immediately with the arguments previously provided.</p>
+ <p>In most cases where a jQuery API call returns a Deferred or Deferred-compatible object, such as <a href="http://api.jquery.com/jQuery.ajax"><code>jQuery.ajax()</code></a> or <a href="http://api.jquery.com/jQuery.when"><code>jQuery.when()</code></a>, you will only want to use the <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a>, <a href="http://api.jquery.com/deferred.done"><code>deferred.done()</code></a>, and <a href="http://api.jquery.com/deferred.fail"><code>deferred.fail()</code></a> methods to add callbacks to the Deferred's queues. The internals of the API call or code that created the Deferred will invoke <a href="http://api.jquery.com/deferred.resolve"><code>deferred.resolve()</code></a> or <a href="http://api.jquery.com/deferred.reject"><code>deferred.reject()</code></a> on the deferred at some point, causing the appropriate callbacks to run.</p>
+ <h4>jQuery.Deferred Constructor</h4>
+ <p>The <code>jQuery.Deferred()</code> constructor creates a new Deferred object. The <code>new</code> operator is optional.</p>
+ <p><code>jQuery.Deferred</code> can be passed an optional function, which is called just before the constructor returns and is passed the constructed <code>deferred</code> object as both the <code>this</code> object and as the first argument to the function. The called function can attach callbacks using <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a> for example.</p>
+ <p>A Deferred object starts in the <em>pending</em> state. Any callbacks added to the object with <a href="http://api.jquery.com/deferred.then"><code>deferred.then()</code></a>, <a href="http://api.jquery.com/deferred.done"><code>deferred.done()</code></a>, or <a href="http://api.jquery.com/deferred.fail"><code>deferred.fail()</code></a> are queued to be executed later. Calling <a href="http://api.jquery.com/deferred.resolve"><code>deferred.resolve()</code></a> or <a href="http://api.jquery.com/deferred.resolveWith"><code>deferred.resolveWith()</code></a> transitions the Deferred into the <em>resolved</em> state and immediately executes any <code>doneCallbacks</code> that are set. Calling <a href="http://api.jquery.com/deferred.reject"><code>deferred.reject()</code></a> or <a href="http://api.jquery.com/deferred.rejectWith"><code>deferred.rejectWith()</code></a> transitions the Deferred into the <em>rejected</em> state and immediately executes any <code>failCallbacks</code> that are set. Once the object has entered the resolved or rejected state, it stays in that state. Callbacks can still be added to the resolved or rejected Deferred -- they will execute immediately.</p>
+ <p>The Deferred object is chainable, similar to the way a jQuery object is chainable, but it has its own methods. After creating a Deferred object, you can use any of the methods below by either chaining directly from the object creation or saving the object in a variable and invoking one or more methods on that variable.</p>
+ </div>
+ </desc>
+ </category>
+ <category name="Deprecated" slug="deprecated">
+ <desc>These items have been deprecated, though not necessarily removed, from jQuery.</desc>
+ </category>
+ <category name="Dimensions" slug="dimensions">
+ <desc/>
+ </category>
+ <category name="Effects" slug="effects">
+ <desc>The jQuery library provides several techniques for adding animation to a web page. These include simple, standard animations that are frequently used, and the ability to craft sophisticated custom effects. In this chapter, we'll closely examine each of the effect methods, revealing all of the mechanisms jQuery has for providing visual feedback to the user.</desc>
+ <category name="Basics" slug="basics">
+ <desc/>
+ </category>
+ <category name="Custom" slug="custom-effects">
+ <desc>These methods allow you to create effects that are not provided "out of the box" by jQuery.</desc>
+ </category>
+ <category name="Fading" slug="fading">
+ <desc>These methods adjust the opacity of elements.</desc>
+ </category>
+ <category name="Sliding" slug="sliding">
+ <desc/>
+ </category>
+ </category>
+ <category name="Events" slug="events">
+ <desc>These methods are used to register behaviors to take effect when the user interacts with the browser, and to further manipulate those registered behaviors.</desc>
+ <category name="Browser Events" slug="browser-events">
+ <desc/>
+ </category>
+ <category name="Document Loading" slug="document-loading">
+ <desc/>
+ </category>
+ <category name="Event Handler Attachment" slug="event-handler-attachment">
+ <desc/>
+ </category>
+ <category name="Event Object" slug="event-object">
+ <desc>
+ <p>jQuery's event system normalizes the event object according to <a href="http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html">W3C standards</a>. The event object is guaranteed to be passed to the event handler. Most properties from the original event are copied over and normalized to the new event object.</p>
+ <div class="longdesc">
+ <h4>jQuery.Event Constructor</h4>
+ <p>The <code>jQuery.Event</code> constructor is exposed and can be used when calling <a href="/trigger">trigger</a>. The <code>new</code> operator is optional.</p>
+ <p>Check <a href="/trigger">trigger</a>'s documentation to see how to combine it with your own event object.</p>
+ <p>Example:</p>
+ <pre>
+ <code><![CDATA[ //Create a new jQuery.Event object without the "new" operator.
var e = jQuery.Event("click");
// trigger an artificial click event
jQuery("body").trigger( e );
-]]></code></pre>
- <p>As of jQuery 1.6, you can also pass an object to <code>jQuery.Event()</code> and its properties will be set on the newly created Event object.</p>
- <p>Example:</p>
- <pre><code><![CDATA[ // Create a new jQuery.Event object with specified event properties.
+]]></code>
+ </pre>
+ <p>As of jQuery 1.6, you can also pass an object to <code>jQuery.Event()</code> and its properties will be set on the newly created Event object.</p>
+ <p>Example:</p>
+ <pre>
+ <code><![CDATA[ // Create a new jQuery.Event object with specified event properties.
var e = jQuery.Event("keydown", { keyCode: 64 });
// trigger an artificial keydown event with keyCode 64
jQuery("body").trigger( e );
-]]></code></pre>
- <h4>Event Properties</h4>
- <p>jQuery normalizes the following properties for cross-browser consistency:</p>
- <ul>
- <li><code>target</code></li>
- <li><code>relatedTarget</code></li>
- <li><code>pageX</code></li>
- <li><code>pageY</code></li>
- <li><code>which</code></li>
- <li><code>metaKey</code></li>
- </ul>
- <p>The following properties are also copied to the event object, though some of their values may be undefined depending on the event:</p>
- <p>altKey, bubbles, button, cancelable, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, prevValue, relatedTarget, screenX, screenY, shiftKey, target, view, which</p>
- <h4>OtherProperties</h4>
- <p>Certain events may have properties specific to them. Those can be accessed as properties of the <code>event.originalEvent</code> object. To make special properties available in all event objects, they can be added to the <code>jQuery.event.props</code> array. This is not recommended, since it adds overhead to every event delivered by jQuery.</p>
- <p>Example:</p>
- <pre><code><![CDATA[
+]]></code>
+ </pre>
+ <h4>Event Properties</h4>
+ <p>jQuery normalizes the following properties for cross-browser consistency:</p>
+ <ul>
+ <li>
+ <code>target</code>
+ </li>
+ <li>
+ <code>relatedTarget</code>
+ </li>
+ <li>
+ <code>pageX</code>
+ </li>
+ <li>
+ <code>pageY</code>
+ </li>
+ <li>
+ <code>which</code>
+ </li>
+ <li>
+ <code>metaKey</code>
+ </li>
+ </ul>
+ <p>The following properties are also copied to the event object, though some of their values may be undefined depending on the event:</p>
+ <p>altKey, bubbles, button, cancelable, charCode, clientX, clientY, ctrlKey, currentTarget, data, detail, eventPhase, metaKey, offsetX, offsetY, originalTarget, pageX, pageY, prevValue, relatedTarget, screenX, screenY, shiftKey, target, view, which</p>
+ <h4>OtherProperties</h4>
+ <p>Certain events may have properties specific to them. Those can be accessed as properties of the <code>event.originalEvent</code> object. To make special properties available in all event objects, they can be added to the <code>jQuery.event.props</code> array. This is not recommended, since it adds overhead to every event delivered by jQuery.</p>
+ <p>Example:</p>
+ <pre>
+ <code><![CDATA[
// add the dataTransfer property for use with the native `drop` event
// to capture information about files dropped into the browser window
jQuery.event.props.push("dataTransfer");
-]]></code></pre>
- </div>
- </desc>
- </category>
- <category name="Form Events" slug="form-events">
- <desc></desc>
- </category>
- <category name="Keyboard Events" slug="keyboard-events">
- <desc></desc>
- </category>
- <category name="Mouse Events" slug="mouse-events">
- <desc></desc>
- </category>
- </category>
- <category name="Forms" slug="forms">
- <desc></desc>
- </category>
- <category name="Internals" slug="internals">
- <desc>Although this category is referred to as 'internal', any methods documented within the API site should be considered public and may be freely used. </desc>
- </category>
- <category name="Manipulation" slug="manipulation">
- <desc>All of the methods in this chapter manipulate the DOM in some manner. A few of them simply change one of the attributes of an element (also listed in the <a href="/category/attributes/">Attributes category</a>), while others set an element's style properties (also listed in the <a href="/category/css/">CSS category</a>). Still others modify entire elements (or groups of elements) themselves—inserting, copying, removing, and so on. All of these methods are referred to as "setters," as they change the values of properties.
- A few of these methods—such as <code>.attr()</code>, <code>.html()</code>, and <code>.val()</code>—also act as "getters," retrieving information from DOM elements for later use.
- </desc>
- <category name="Class Attribute" slug="class-attribute">
- <desc>These methods inspect and manipulate the CSS classes assigned to elements.</desc>
- </category>
- <category name="Copying" slug="copying">
- <desc>This method allows us to make copies of elements.</desc>
- </category>
- <category name="DOM Insertion" slug="dom-insertion">
- <desc></desc>
- </category>
- <category name="DOM Insertion, Around" slug="dom-insertion-around">
- <desc>These methods allow us to insert new content surrounding existing content.</desc>
- </category>
- <category name="DOM Insertion, Inside" slug="dom-insertion-inside">
- <desc>These methods allow us to insert new content inside an existing element.</desc>
- </category>
- <category name="DOM Insertion, Outside" slug="dom-insertion-outside">
- <desc>These methods allow us to insert new content outside an existing element.</desc>
- </category>
- <category name="DOM Removal" slug="dom-removal">
- <desc>These methods allow us to delete elements from the DOM.</desc>
- </category>
- <category name="DOM Replacement" slug="dom-replacement">
- <desc>These methods are used to remove content from the DOM and replace it with new content.</desc>
- </category>
- <category name="General Attributes" slug="general-attributes">
- <desc>These methods get and set DOM attributes of elements</desc>
- </category>
- <category name="Style Properties" slug="style-properties">
- <desc>These methods get and set CSS-related properties of elements.</desc>
- </category>
- </category>
- <category name="Miscellaneous" slug="miscellaneous">
- <desc></desc>
- <category name="Collection Manipulation" slug="collection-manipulation">
- <desc></desc>
- </category>
- <category name="Data Storage" slug="data-storage">
- <desc>These methods allow us to associate arbitrary data with specific DOM elements.</desc>
- </category>
- <category name="DOM Element Methods" slug="dom-element-methods">
- <desc></desc>
- </category>
- <category name="Setup Methods" slug="setup-methods">
- <desc></desc>
- </category>
- </category>
- <category name="Offset" slug="offset">
- <desc></desc>
- </category>
- <category name="Properties" slug="properties">
- <desc></desc>
- <category name="Properties of jQuery Object Instances" slug="jquery-object-instance-properties">
- <desc>Each jQuery object created with the jQuery() function contains a number of properties alongside its methods. These properties allow us to inspect various attributes of the object.</desc>
- </category>
- <category name="Properties of the Global jQuery Object" slug="global-jquery-object-properties">
- <desc>These properties are associated with the global jQuery object.</desc>
- </category>
- </category>
- <category name="Selectors" slug="selectors">
- <desc>
- <p>Borrowing from CSS 1–3, and then adding its own, jQuery offers a powerful set of tools for matching a set of elements in a document.</p>
- <p>If you wish to use any of the meta-characters ( such as <code> !&quot;#$%&amp;&#39;()*+,./:;&lt;=&gt;?@[\]^`{|}~</code> ) as a literal part of a name, you must escape the character with two backslashes: <code>\\</code>. For example, if you have an element with <code>id="foo.bar"</code>, you can use the selector <code>$("#foo\\.bar")</code>. The W3C CSS specification contains the <a href="http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier">complete set of rules regarding valid CSS selectors</a>. Also useful is the blog entry by Mathias Bynens on <a href="http://mathiasbynens.be/notes/css-escapes">CSS character escape sequences for identifiers</a>.</p>
+]]></code>
+ </pre>
+ </div>
+ </desc>
+ </category>
+ <category name="Form Events" slug="form-events">
+ <desc/>
+ </category>
+ <category name="Keyboard Events" slug="keyboard-events">
+ <desc/>
+ </category>
+ <category name="Mouse Events" slug="mouse-events">
+ <desc/>
+ </category>
+ </category>
+ <category name="Forms" slug="forms">
+ <desc/>
+ </category>
+ <category name="Internals" slug="internals">
+ <desc>Although this category is referred to as 'internal', any methods documented within the API site should be considered public and may be freely used. </desc>
+ </category>
+ <category name="Manipulation" slug="manipulation">
+ <desc>All of the methods in this chapter manipulate the DOM in some manner. A few of them simply change one of the attributes of an element (also listed in the <a href="/category/attributes/">Attributes category</a>), while others set an element's style properties (also listed in the <a href="/category/css/">CSS category</a>). Still others modify entire elements (or groups of elements) themselves&#x2014;inserting, copying, removing, and so on. All of these methods are referred to as "setters," as they change the values of properties.
+ A few of these methods&#x2014;such as <code>.attr()</code>, <code>.html()</code>, and <code>.val()</code>&#x2014;also act as "getters," retrieving information from DOM elements for later use.
</desc>
- <category name="Attribute" slug="attribute-selectors">
- <desc>
- <p>The CSS specification also allows elements to be identified by their attributes. While not widely supported by browsers for the purpose of styling documents, these attribute selectors are highly useful, and jQuery allows us to employ them regardless of the browser being used.
+ <category name="Class Attribute" slug="class-attribute">
+ <desc>These methods inspect and manipulate the CSS classes assigned to elements.</desc>
+ </category>
+ <category name="Copying" slug="copying">
+ <desc>This method allows us to make copies of elements.</desc>
+ </category>
+ <category name="DOM Insertion" slug="dom-insertion">
+ <desc/>
+ </category>
+ <category name="DOM Insertion, Around" slug="dom-insertion-around">
+ <desc>These methods allow us to insert new content surrounding existing content.</desc>
+ </category>
+ <category name="DOM Insertion, Inside" slug="dom-insertion-inside">
+ <desc>These methods allow us to insert new content inside an existing element.</desc>
+ </category>
+ <category name="DOM Insertion, Outside" slug="dom-insertion-outside">
+ <desc>These methods allow us to insert new content outside an existing element.</desc>
+ </category>
+ <category name="DOM Removal" slug="dom-removal">
+ <desc>These methods allow us to delete elements from the DOM.</desc>
+ </category>
+ <category name="DOM Replacement" slug="dom-replacement">
+ <desc>These methods are used to remove content from the DOM and replace it with new content.</desc>
+ </category>
+ <category name="General Attributes" slug="general-attributes">
+ <desc>These methods get and set DOM attributes of elements</desc>
+ </category>
+ <category name="Style Properties" slug="style-properties">
+ <desc>These methods get and set CSS-related properties of elements.</desc>
+ </category>
+ </category>
+ <category name="Miscellaneous" slug="miscellaneous">
+ <desc/>
+ <category name="Collection Manipulation" slug="collection-manipulation">
+ <desc/>
+ </category>
+ <category name="Data Storage" slug="data-storage">
+ <desc>These methods allow us to associate arbitrary data with specific DOM elements.</desc>
+ </category>
+ <category name="DOM Element Methods" slug="dom-element-methods">
+ <desc/>
+ </category>
+ <category name="Setup Methods" slug="setup-methods">
+ <desc/>
+ </category>
+ </category>
+ <category name="Offset" slug="offset">
+ <desc/>
+ </category>
+ <category name="Properties" slug="properties">
+ <desc/>
+ <category name="Properties of jQuery Object Instances" slug="jquery-object-instance-properties">
+ <desc>Each jQuery object created with the jQuery() function contains a number of properties alongside its methods. These properties allow us to inspect various attributes of the object.</desc>
+ </category>
+ <category name="Properties of the Global jQuery Object" slug="global-jquery-object-properties">
+ <desc>These properties are associated with the global jQuery object.</desc>
+ </category>
+ </category>
+ <category name="Selectors" slug="selectors">
+ <desc>
+ <p>Borrowing from CSS 1&#x2013;3, and then adding its own, jQuery offers a powerful set of tools for matching a set of elements in a document.</p>
+ <p>If you wish to use any of the meta-characters ( such as <code> !"#$%&amp;'()*+,./:;&lt;=&gt;?@[\]^`{|}~</code> ) as a literal part of a name, you must escape the character with two backslashes: <code>\\</code>. For example, if you have an element with <code>id="foo.bar"</code>, you can use the selector <code>$("#foo\\.bar")</code>. The W3C CSS specification contains the <a href="http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier">complete set of rules regarding valid CSS selectors</a>. Also useful is the blog entry by Mathias Bynens on <a href="http://mathiasbynens.be/notes/css-escapes">CSS character escape sequences for identifiers</a>.</p>
+ </desc>
+ <category name="Attribute" slug="attribute-selectors">
+ <desc>
+ <p>The CSS specification also allows elements to be identified by their attributes. While not widely supported by browsers for the purpose of styling documents, these attribute selectors are highly useful, and jQuery allows us to employ them regardless of the browser being used.
When using any of the following attribute selectors, we should account for attributes that have multiple, space-separated values. Since these selectors see attribute values as a single string, this selector, for example, <code>$("a[rel='nofollow']")</code>, will select <code><a href="example.html" rel="nofollow">Some text</a></code> but not <code><a href="example.html">Some text</a></code>.</p>
- <p>Attribute values in selector expressions <b>must</b> follow the rules for W3C CSS selectors, in general that means anything other than a simple identifier should be surrounded by quotation marks.</p>
- <ul>
- <li>double quotes inside single quotes: <code>$('a[rel="nofollow self"]')</code></li>
- <li>single quotes inside double quotes: <code>$("a[rel='nofollow self']")</code></li>
- <li>escaped single quotes inside single quotes: <code>$('a[rel=\'nofollow self\']')</code></li>
- <li>escaped double quotes inside double quotes: <code>$("a[rel=\"nofollow self\"]")</code></li>
- </ul>
- <p>The variation you choose is generally a matter of style or convenience.</p>
-
- <p><strong>Note</strong>: In jQuery 1.3 <code>[@attr]</code> style selectors were removed (they were previously deprecated in jQuery 1.2). Simply remove the "@" symbol from your selectors in order to make them work again.</p>
- </desc>
- </category>
- <category name="Basic" slug="basic-css-selectors">
- <desc>The following selectors are based on the Cascading Style Sheet 1 specification, as outlined by the W3C. For more information about the specifications, visit <a href="http://www.w3.org/Style/CSS/#specs">http://www.w3.org/Style/CSS/#specs</a>. </desc>
- </category>
- <category name="Basic Filter" slug="basic-filter-selectors">
- <desc></desc>
- </category>
- <category name="Child Filter" slug="child-filter-selectors">
- <desc></desc>
- </category>
- <category name="Content Filter" slug="content-filter-selector">
- <desc></desc>
- </category>
- <category name="Form" slug="form-selectors">
- <desc></desc>
- </category>
- <category name="Hierarchy" slug="hierarchy-selectors">
- <desc></desc>
- </category>
- <category name="jQuery Extensions" slug="jquery-selector-extensions">
- <desc>jQuery has extended the CSS3 selectors with the following selectors. Because these selectors are jQuery extension and not part of the CSS specification, queries using them cannot take advantage of the performance boost provided by the native DOM <code>querySelectorAll()</code> method. To achieve the best performance when using these selectors, first select some elements using a pure CSS selector, then use <a href="http://api.jquery.com/filter/"><code>.filter()</code></a>.</desc>
- </category>
- <category name="Visibility Filter" slug="visibility-filter-selectors">
- <desc></desc>
- </category>
- </category>
- <category name="Traversing" slug="traversing">
- <desc></desc>
- <category name="Filtering" slug="filtering">
- <desc></desc>
- </category>
- <category name="Miscellaneous Traversing" slug="miscellaneous-traversal">
- <desc></desc>
- </category>
- <category name="Tree Traversal" slug="tree-traversal">
- <desc></desc>
- </category>
- </category>
- <category name="Uncategorized" slug="uncategorized"/>
- <category name="Utilities" slug="utilities">
- <desc></desc>
- </category>
- <category name="Version" slug="version">
- <desc></desc>
- <category name="Version 1.0" slug="1.0">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ <p>Attribute values in selector expressions <b>must</b> follow the rules for W3C CSS selectors, in general that means anything other than a simple identifier should be surrounded by quotation marks.</p>
+ <ul>
+ <li>double quotes inside single quotes: <code>$('a[rel="nofollow self"]')</code></li>
+ <li>single quotes inside double quotes: <code>$("a[rel='nofollow self']")</code></li>
+ <li>escaped single quotes inside single quotes: <code>$('a[rel=\'nofollow self\']')</code></li>
+ <li>escaped double quotes inside double quotes: <code>$("a[rel=\"nofollow self\"]")</code></li>
+ </ul>
+ <p>The variation you choose is generally a matter of style or convenience.</p>
+ <p><strong>Note</strong>: In jQuery 1.3 <code>[@attr]</code> style selectors were removed (they were previously deprecated in jQuery 1.2). Simply remove the "@" symbol from your selectors in order to make them work again.</p>
+ </desc>
+ </category>
+ <category name="Basic" slug="basic-css-selectors">
+ <desc>The following selectors are based on the Cascading Style Sheet 1 specification, as outlined by the W3C. For more information about the specifications, visit <a href="http://www.w3.org/Style/CSS/#specs">http://www.w3.org/Style/CSS/#specs</a>. </desc>
+ </category>
+ <category name="Basic Filter" slug="basic-filter-selectors">
+ <desc/>
+ </category>
+ <category name="Child Filter" slug="child-filter-selectors">
+ <desc/>
+ </category>
+ <category name="Content Filter" slug="content-filter-selector">
+ <desc/>
+ </category>
+ <category name="Form" slug="form-selectors">
+ <desc/>
+ </category>
+ <category name="Hierarchy" slug="hierarchy-selectors">
+ <desc/>
+ </category>
+ <category name="jQuery Extensions" slug="jquery-selector-extensions">
+ <desc>jQuery has extended the CSS3 selectors with the following selectors. Because these selectors are jQuery extension and not part of the CSS specification, queries using them cannot take advantage of the performance boost provided by the native DOM <code>querySelectorAll()</code> method. To achieve the best performance when using these selectors, first select some elements using a pure CSS selector, then use <a href="http://api.jquery.com/filter/"><code>.filter()</code></a>.</desc>
+ </category>
+ <category name="Visibility Filter" slug="visibility-filter-selectors">
+ <desc/>
+ </category>
+ </category>
+ <category name="Traversing" slug="traversing">
+ <desc/>
+ <category name="Filtering" slug="filtering">
+ <desc/>
+ </category>
+ <category name="Miscellaneous Traversing" slug="miscellaneous-traversal">
+ <desc/>
+ </category>
+ <category name="Tree Traversal" slug="tree-traversal">
+ <desc/>
+ </category>
+ </category>
+ <category name="Uncategorized" slug="uncategorized"/>
+ <category name="Utilities" slug="utilities">
+ <desc/>
+ </category>
+ <category name="Version" slug="version">
+ <desc/>
+ <category name="Version 1.0" slug="1.0">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2006/08/26/jquery-10/">jQuery 1.0 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.0.4" slug="1.0.4">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.0.4" slug="1.0.4">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
Release Notes: <a href="http://blog.jquery.com/2006/08/31/jquery-101/">1.0.1</a>, <a href="http://blog.jquery.com/2006/10/09/jquery-102/">1.0.2</a>, <a href="http://blog.jquery.com/2006/10/27/jquery-103/">1.0.3</a>, <a href="http://blog.jquery.com/2006/12/12/jquery-104/">1.0.4</a>.
</desc>
- </category>
- <category name="Version 1.1" slug="1.1">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.1" slug="1.1">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2007/01/14/jquery-birthday-11-new-site-new-docs/">jQuery 1.1 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.1.2" slug="1.1.2">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.1.2" slug="1.1.2">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2007/02/27/jquery-112/">jQuery 1.1.2 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.1.3" slug="1.1.3">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.1.3" slug="1.1.3">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2007/07/01/jquery-113-800-faster-still-20kb/">jQuery 1.1.3 Release Notes</a>
</desc>
- </category>
- <category name="Version 1.1.4" slug="1.1.4">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.1.4" slug="1.1.4">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2007/08/24/jquery-114-faster-more-tests-ready-for-12/">jQuery 1.1.4 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.2" slug="1.2">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.2" slug="1.2">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://docs.jquery.com/Release:jQuery_1.2">jQuery 1.2 Release Notes</a>
</desc>
- </category>
- <category name="Version 1.2.3" slug="1.2.3">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.2.3" slug="1.2.3">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
Release Notes: <a href="http://docs.jquery.com/Release:jQuery_1.2.1">1.2.1</a>, <a href="http://docs.jquery.com/Release:jQuery_1.2.2">1.2.2</a>, <a href="http://docs.jquery.com/Release:jQuery_1.2.3">1.2.3</a>.
</desc>
- </category>
- <category name="Version 1.2.6" slug="1.2.6">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.2.6" slug="1.2.6">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://docs.jquery.com/Release:jQuery_1.2.6">jQuery 1.2.6 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.3" slug="1.3">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.3" slug="1.3">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
Release Notes: <a href="http://docs.jquery.com/Release:jQuery_1.3">1.3</a>, <a href="http://docs.jquery.com/Release:jQuery_1.3.1">1.3.1</a>, <a href="http://docs.jquery.com/Release:jQuery_1.3.2">1.3.2</a>
</desc>
- </category>
- <category name="Version 1.4" slug="1.4">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.4" slug="1.4">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://jquery14.com/day-01/jquery-14">jQuery 1.4 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.4.1" slug="1.4.1">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.4.1" slug="1.4.1">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://jquery14.com/day-12/jquery-141-released">jQuery 1.4.1 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.4.2" slug="1.4.2">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.4.2" slug="1.4.2">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2010/02/19/jquery-142-released/">jQuery 1.4.2 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.4.3" slug="1.4.3">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
+ </category>
+ <category name="Version 1.4.3" slug="1.4.3">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.
<a href="http://blog.jquery.com/2010/10/16/jquery-143-released/">jQuery 1.4.3 Release Notes</a>.
</desc>
- </category>
- <category name="Version 1.4.4" slug="1.4.4">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery. <a href="http://blog.jquery.com/2010/11/11/jquery-1-4-4-release-notes/">jQuery 1.4.4 Release Notes</a>.</desc>
- </category>
- <category name="Version 1.5" slug="1.5">
- <desc>
- <p>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.</p>
- <p>jQuery 1.5 also includes a large rewrite of the Ajax module, which has a number of extensibility improvements. You can find out more about those improvements in the <a href="http://api.jquery.com/extending-ajax/">Extending Ajax</a> documentation.</p>
- <p>Additionally jQuery 1.5 includes a new Deferred callback management system you can learn more about in in the <a href="http://api.jquery.com/category/deferred-object/">Deferred Object</a> documentation.</p>
- </desc>
- </category>
- <category name="Version 1.5.1" slug="1.5.1">
- <desc>Aspects of the API that were changed in the corresponding version of jQuery. API changes in jQuery 1.5.1 dealt primarily with jQuery.ajax settings and jQuery.support properties.</desc>
- </category>
- <category name="Version 1.6" slug="1.6">
- <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.</desc>
- </category>
- <category name="Version 1.7" slug="1.7">
- <desc>
- <p>Aspects of the API that were changed in the corresponding version of jQuery. API changes in jQuery 1.7.0 dealt primarily with the new
+ </category>
+ <category name="Version 1.4.4" slug="1.4.4">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery. <a href="http://blog.jquery.com/2010/11/11/jquery-1-4-4-release-notes/">jQuery 1.4.4 Release Notes</a>.</desc>
+ </category>
+ <category name="Version 1.5" slug="1.5">
+ <desc>
+ <p>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.</p>
+ <p>jQuery 1.5 also includes a large rewrite of the Ajax module, which has a number of extensibility improvements. You can find out more about those improvements in the <a href="http://api.jquery.com/extending-ajax/">Extending Ajax</a> documentation.</p>
+ <p>Additionally jQuery 1.5 includes a new Deferred callback management system you can learn more about in in the <a href="http://api.jquery.com/category/deferred-object/">Deferred Object</a> documentation.</p>
+ </desc>
+ </category>
+ <category name="Version 1.5.1" slug="1.5.1">
+ <desc>Aspects of the API that were changed in the corresponding version of jQuery. API changes in jQuery 1.5.1 dealt primarily with jQuery.ajax settings and jQuery.support properties.</desc>
+ </category>
+ <category name="Version 1.6" slug="1.6">
+ <desc>All the aspects of the API that were added, or had a new signature added, in the corresponding version of jQuery.</desc>
+ </category>
+ <category name="Version 1.7" slug="1.7">
+ <desc>
+ <p>Aspects of the API that were changed in the corresponding version of jQuery. API changes in jQuery 1.7.0 dealt primarily with the new
Event APIs: <code>.on()</code> and <code>.off()</code>
Better Support for HTML5 in IE6/7/8
<code>jQuery.Callbacks()</code>
Toggling Animations Work Intuitively
</p>
- <p>For more information, see the Release Notes/Changelog at <a href="http://blog.jquery.com/2011/11/03/jquery-1-7-released/">http://blog.jquery.com/2011/11/03/jquery-1-7-released/</a></p>
- <hr />
- </desc>
- </category>
- </category>
-</categories>
+ <p>For more information, see the Release Notes/Changelog at <a href="http://blog.jquery.com/2011/11/03/jquery-1-7-released/">http://blog.jquery.com/2011/11/03/jquery-1-7-released/</a></p>
+ <hr/>
+ </desc>
+ </category>
+ </category>
+</categories>
View
4 entries/animate.xml
@@ -127,9 +127,7 @@
});</pre>
<p>As previously noted, a plugin is required for the <code>easeOutBounce</code> function.</p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.animate()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".animate()"/>
<example>
<desc>Click the button to animate the div with a number of different properties.</desc>
<code><![CDATA[
View
4 entries/animated-selector.xml
@@ -7,9 +7,7 @@
</signature>
<desc>Select all elements that are in the progress of an animation at the time the selector is run.</desc>
<longdesc/>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:animated</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":animated"/>
<example>
<desc>Change the color of any div that is animated.</desc>
<code><![CDATA[
View
5 entries/attribute-not-equal-selector.xml
@@ -15,10 +15,7 @@
<longdesc>
<p>This selector is equivalent to <code>:not([attr="value"])</code>.</p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">[name!="value"]</placeholder>
- <placeholder name="alt">$("your-pure-css-selector").not('[name="value"]')</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector="[name!=&quot;value&quot;]" data-alt="$(&quot;your-pure-css-selector&quot;).not('[name=&quot;value&quot;]')"/>
<example>
<desc>Finds all inputs that don't have the name 'newsletter' and appends text to the span next to it.</desc>
<code><![CDATA[$('input[name!="newsletter"]').next().append('<b>; not newsletter</b>');]]></code>
View
4 entries/button-selector.xml
@@ -9,9 +9,7 @@
<longdesc>
<p>An equivalent selector to <code>$(":button")</code> using valid CSS is <code>$("button, input[type='button']")</code>.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:button</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":button"/>
<example>
<desc>Find all button inputs and mark them.</desc>
<code><![CDATA[
View
5 entries/checkbox-selector.xml
@@ -9,10 +9,7 @@
<longdesc>
<p><code>$(':checkbox')</code> is equivalent to <code>$('[type=checkbox]')</code>. As with other pseudo-class selectors (those that begin with a ":") it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ("*") is implied. In other words, the bare <code>$(':checkbox')</code> is equivalent to <code>$('*:checkbox')</code>, so <code>$('input:checkbox')</code> should be used instead. </p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:checkbox</placeholder>
- <placeholder name="alt">[type="checkbox"]</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":checkbox" data-alt="[type=&quot;checkbox&quot;]"/>
<example>
<desc>Finds all checkbox inputs.</desc>
<code><![CDATA[
View
3  entries/delegate.xml
@@ -55,8 +55,7 @@ $(elements).on(<em>events</em>, <em>selector</em>, <em>data</em>, <em>handler</e
<p>To remove events attached with <code>delegate()</code>, see the <a href="http://api.jquery.com/undelegate">.undelegate()</a> method.</p>
<p>Passing and handling event data works the same way as it does for <code>.on()</code>.</p>
</longdesc>
- <note id="propagation-for-live-or-delegate" type="additional">
-</note>
+ <note id="propagation-for-live-or-delegate" type="additional"/>
<example>
<desc>Click a paragraph to add another. Note that .delegate() attaches a click event handler to all paragraphs - even new ones.</desc>
<code><![CDATA[
View
5 entries/eq-selector.xml
@@ -14,10 +14,7 @@
<p>Note that since JavaScript arrays use <em>0-based indexing</em>, these selectors reflect that fact. This is why <code>$('.myclass:eq(1)')</code> selects the second element in the document with the class myclass, rather than the first. In contrast, <code>:nth-child(n)</code> uses <em>1-based indexing</em> to conform to the CSS specification.</p>
<p>Unlike the <a href="http://api.jquery.com/eq/"><code>.eq(index)</code></a> method, the <code>:eq(index)</code> selector does <em>not</em> accept a negative value for <code>index</code>. For example, while <code>$('li').eq(-1)</code> selects the last <code>li</code> element, <code>$('li:eq(-1)')</code> selects nothing.</p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:eq()</placeholder>
- <placeholder name="alt">$("your-pure-css-selector").eq(index)</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":eq()" data-alt="$(&quot;your-pure-css-selector&quot;).eq(index)"/>
<example>
<desc>Finds the third td.</desc>
<code><![CDATA[$("td:eq(2)").css("color", "red");]]></code>
View
7 entries/even-selector.xml
@@ -9,11 +9,8 @@
<longdesc>
<p>In particular, note that the <em>0-based indexing</em> means that, counter-intuitively, <code>:even</code> selects the first element, third element, and so on within the matched set.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:even</placeholder>
- </note>
- <note id="document-order" type="additional">
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":even"/>
+ <note id="document-order" type="additional"/>
<example>
<desc>Finds even table rows, matching the first, third and so on (index 0, 2, 4 etc.).</desc>
<code><![CDATA[$("tr:even").css("background-color", "#bbbbff");]]></code>
View
4 entries/fadeIn.xml
@@ -49,9 +49,7 @@
<p>If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but <code>this</code> is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole. </p>
<p><strong>As of jQuery 1.6</strong>, the <code><a href="http://api.jquery.com/promise/">.promise()</a></code> method can be used in conjunction with the <code><a href="http://api.jquery.com/deferred.done/">deferred.done()</a></code> method to execute a single callback for the animation as a whole when <em>all</em> matching elements have completed their animations ( See the <a href="http://api.jquery.com/promise/#example-1">example for .promise()</a> ). </p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.fadeIn()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".fadeIn()"/>
<example>
<desc>Animates hidden divs to fade in one by one, completing each animation within 600 milliseconds.</desc>
<code><![CDATA[
View
4 entries/fadeOut.xml
@@ -52,9 +52,7 @@
<p>If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but <code>this</code> is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.</p>
<p><strong>As of jQuery 1.6</strong>, the <code><a href="http://api.jquery.com/promise/">.promise()</a></code> method can be used in conjunction with the <code><a href="http://api.jquery.com/deferred.done/">deferred.done()</a></code> method to execute a single callback for the animation as a whole when <em>all</em> matching elements have completed their animations ( See the <a href="http://api.jquery.com/promise/#example-1">example for .promise()</a> ). </p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.fadeOut()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".fadeOut()"/>
<example>
<desc>Animates all paragraphs to fade out, completing the animation within 600 milliseconds.</desc>
<code><![CDATA[
View
4 entries/fadeTo.xml
@@ -53,9 +53,7 @@
</p>
<p>With <code>duration</code> set to <code>0</code>, this method just changes the <code>opacity</code> CSS property, so <code>.fadeTo(0, opacity)</code> is the same as <code>.css('opacity', opacity)</code>.</p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.fadeTo()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".fadeTo()"/>
<example>
<desc>Animates first paragraph to fade to an opacity of 0.33 (33%, about one third visible), completing the animation within 600 milliseconds.</desc>
<code><![CDATA[
View
4 entries/fadeToggle.xml
@@ -23,9 +23,7 @@
<p>If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but <code>this</code> is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.</p>
<p><strong>As of jQuery 1.6</strong>, the <code><a href="http://api.jquery.com/promise/">.promise()</a></code> method can be used in conjunction with the <code><a href="http://api.jquery.com/deferred.done/">deferred.done()</a></code> method to execute a single callback for the animation as a whole when <em>all</em> matching elements have completed their animations ( See the <a href="http://api.jquery.com/promise/#example-1">example for .promise()</a> ). </p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.fadeToggle()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".fadeToggle()"/>
<example>
<desc>Fades first paragraph in or out, completing the animation within 600 milliseconds and using a linear easing. Fades last paragraph in or out for 200 milliseconds, inserting a "finished" message upon completion. </desc>
<code><![CDATA[
View
5 entries/file-selector.xml
@@ -9,10 +9,7 @@
<longdesc>
<p><code>:file</code> is equivalent to <code>[type="file"]</code>. As with other pseudo-class selectors (those that begin with a ":") it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ("*") is implied. In other words, the bare <code>$(':file')</code> is equivalent to <code>$('*:file')</code>, so <code>$('input:file')</code> should be used instead. </p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="alt">[type="file"]</placeholder>
- <placeholder name="selector">:file</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":file" data-alt="[type=&quot;file&quot;]"/>
<example>
<desc>Finds all file inputs.</desc>
<code><![CDATA[
View
7 entries/first-selector.xml
@@ -9,11 +9,8 @@
<longdesc>
<p>The <code>:first</code> pseudo-class is equivalent to <code>:eq(0)</code>. It could also be written as <code>:lt(1)</code>. While this matches only a single element, <a href="first-child-selector">:first-child</a> can match more than one: One for each parent.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:first</placeholder>
- </note>
- <note id="document-order" type="additional">
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":first"/>
+ <note id="document-order" type="additional"/>
<example>
<desc>Finds the first table row.</desc>
<code><![CDATA[$("tr:first").css("font-style", "italic");]]></code>
View
5 entries/gt-selector.xml
@@ -16,10 +16,7 @@
<p>The index-related selector expressions (including this "greater than" selector) filter the set of elements that have matched the expressions that precede them. They narrow the set down based on the order of the elements within this matched set. For example, if elements are first selected with a class selector (<code>.myclass</code>) and four elements are returned, these elements are given indices 0 through 3 for the purposes of these selectors.</p>
<p>Note that since JavaScript arrays use <em>0-based indexing</em>, these selectors reflect that fact. This is why <code>$('.myclass:gt(1)')</code> selects elements after the second element in the document with the class <code>myclass</code>, rather than after the first. In contrast, <code>:nth-child(n)</code> uses <em>1-based indexing</em> to conform to the CSS specification.</p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:gt()</placeholder>
- <placeholder name="alt">$("your-pure-css-selector").slice(index)</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":gt()" data-alt="$(&quot;your-pure-css-selector&quot;).slice(index)"/>
<example>
<desc>Finds TD #5 and higher. Reminder: the indexing starts at 0.</desc>
<code><![CDATA[$("td:gt(4)").css("text-decoration", "line-through");]]></code>
View
5 entries/has-selector.xml
@@ -12,10 +12,7 @@
<longdesc>
<p>The expression <code>$('div:has(p)')</code> matches a <code>&lt;div&gt;</code> if a <code>&lt;p&gt;</code> exists anywhere among its descendants, not just as a direct child.</p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:has()</placeholder>
- <placeholder name="alt">$("your-pure-css-selector").has(selector/DOMElement)</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":has()" data-alt="$(&quot;your-pure-css-selector&quot;).has(selector/DOMElement)"/>
<example>
<desc>Adds the class "test" to all divs that have a paragraph inside of them.</desc>
<code><![CDATA[$("div:has(p)").addClass("test");]]></code>
View
4 entries/header-selector.xml
@@ -7,9 +7,7 @@
</signature>
<desc>Selects all elements that are headers, like h1, h2, h3 and so on.</desc>
<longdesc/>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:header</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":header"/>
<example>
<desc>Adds a background and text color to all the headers on the page.</desc>
<code><![CDATA[$(":header").css({ background:'#CCC', color:'blue' });]]></code>
View
4 entries/hidden-selector.xml
@@ -17,9 +17,7 @@
<p>Elements with <code>visibility: hidden</code> or <code>opacity: 0</code> are considered to be visible, since they still consume space in the layout. During animations that hide an element, the element is considered to be visible until the end of the animation. During animations to show an element, the element is considered to be visible at the start of the animation.</p>
<p>How <code>:hidden</code> is determined was changed in jQuery 1.3.2. An element is assumed to be hidden if it or any of its parents consumes no space in the document. CSS visibility isn't taken into account (therefore <code>$(elem).css('visibility','hidden').is(':hidden') == false</code>). The <a href="http://docs.jquery.com/Release:jQuery_1.3.2#:visible.2F:hidden_Overhauled">release notes</a> outline the changes in more detail.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:hidden</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":hidden"/>
<example>
<desc>Shows all hidden divs and counts hidden inputs.</desc>
<code><![CDATA[
View
4 entries/hide.xml
@@ -54,9 +54,7 @@ $('#clickme').click(function() {
<img src="/resources/0042_06_08.png" alt=""/>
</p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.hide()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".hide()"/>
<example>
<desc>Hides all paragraphs then the link on click.</desc>
<code><![CDATA[
View
5 entries/image-selector.xml
@@ -9,10 +9,7 @@
<longdesc>
<p><code>:image</code> is equivalent to <code>[type="image"]</code></p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:image</placeholder>
- <placeholder name="alt">[type="image"]</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":image" data-alt="[type=&quot;image&quot;]"/>
<example>
<desc>Finds all image inputs.</desc>
<code><![CDATA[
View
4 entries/input-selector.xml
@@ -9,9 +9,7 @@
<longdesc>
<p>The <code>:input</code> selector basically selects all form controls.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:input</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":input"/>
<example>
<desc>Finds all input elements.</desc>
<code><![CDATA[
View
6 entries/jQuery.ajax.xml
@@ -322,10 +322,8 @@ $.ajaxSetup({
<h4>Extending Ajax</h4>
<p><strong>As of jQuery 1.5</strong>, jQuery's Ajax implementation includes prefilters, converters, and transports that allow you to extend Ajax with a great deal of flexibility. For more information about these advanced features, see the <a href="http://api.jquery.com/extending-ajax/">Extending Ajax</a> page.</p>
</longdesc>
- <note id="same-origin-policy" type="additional">
-</note>
- <note id="same-origin-policy-exceptions" type="additional">
-</note>
+ <note id="same-origin-policy" type="additional"/>
+ <note id="same-origin-policy-exceptions" type="additional"/>
<example>
<desc>Save some data to the server and notify the user once it's complete.</desc>
<code><![CDATA[$.ajax({
View
10 entries/jQuery.get.xml
@@ -52,13 +52,9 @@
// Set another completion function for the request above
jqxhr.complete(function(){ alert("second complete"); });</pre>
</longdesc>
- <note id="same-origin-policy" type="additional">
-</note>
- <note id="use-ajaxerror" type="additional">
- <placeholder name="title">jQuery.get()</placeholder>
- </note>
- <note id="same-origin-policy-exceptions" type="additional">
-</note>
+ <note id="same-origin-policy" type="additional"/>
+ <note id="use-ajaxerror" type="additional" data-title="jQuery.get()"/>
+ <note id="same-origin-policy-exceptions" type="additional"/>
<example>
<desc>Request the test.php page, but ignore the return results.</desc>
<code><![CDATA[$.get("test.php");]]></code>
View
6 entries/jQuery.getJSON.xml
@@ -70,10 +70,8 @@ var jqxhr = $.getJSON("example.json", function() {
// Set another completion function for the request above
jqxhr.complete(function(){ alert("second complete"); });</pre>
</longdesc>
- <note id="same-origin-policy" type="additional">
-</note>
- <note id="same-origin-policy-exceptions" type="additional">
-</note>
+ <note id="same-origin-policy" type="additional"/>
+ <note id="same-origin-policy-exceptions" type="additional"/>
<example>
<desc>Loads the four most recent cat pictures from the Flickr JSONP API.</desc>
<code><![CDATA[
View
4 entries/jQuery.post.xml
@@ -55,9 +55,7 @@
</pre>
</longdesc>
<note id="same-origin-policy" type="additional"/>
- <note id="use-ajaxerror" type="additional">
- <placeholder name="title">jQuery.post()</placeholder>
- </note>
+ <note id="use-ajaxerror" type="additional" data-title="jQuery.post()"/>
<example>
<desc>Request the test.php page, but ignore the return results.</desc>
<code><![CDATA[$.post("test.php");]]></code>
View
4 entries/last-selector.xml
@@ -9,9 +9,7 @@
<longdesc>
<p>Note that <code>:last</code> selects a single element by filtering the current jQuery collection and matching the last element within it.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:last</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":last"/>
<example>
<desc>Finds the last table row.</desc>
<code><![CDATA[$("tr:last").css({backgroundColor: 'yellow', fontWeight: 'bolder'});]]></code>
View
5 entries/lt-selector.xml
@@ -16,10 +16,7 @@
<p>The index-related selectors (including this "less than" selector) filter the set of elements that have matched the expressions that precede them. They narrow the set down based on the order of the elements within this matched set. For example, if elements are first selected with a class selector (<code>.myclass</code>) and four elements are returned, these elements are given indices 0 through 3 for the purposes of these selectors.</p>
<p>Note that since JavaScript arrays use <em>0-based indexing</em>, these selectors reflect that fact. This is why <code>$('.myclass:lt(1)')</code> selects the first element in the document with the class <code>myclass</code>, rather than selecting no elements. In contrast, <code>:nth-child(n)</code> uses <em>1-based indexing</em> to conform to the CSS specification.</p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:lt()</placeholder>
- <placeholder name="alt">$("your-pure-css-selector").slice(0, index)</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":lt()" data-alt="$(&quot;your-pure-css-selector&quot;).slice(0, index)"/>
<example>
<desc>Finds TDs less than the one with the 4th index (TD#4).</desc>
<code><![CDATA[$("td:lt(4)").css("color", "red");]]></code>
View
4 entries/odd-selector.xml
@@ -9,9 +9,7 @@
<longdesc>
<p>In particular, note that the <em>0-based indexing</em> means that, counter-intuitively, <code>:odd</code> selects the second element, fourth element, and so on within the matched set.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:odd</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":odd"/>
<note id="document-order" type="additional"/>
<example>
<desc>Finds odd table rows, matching the second, fourth and so on (index 1, 3, 5 etc.).</desc>
View
4 entries/parent-selector.xml
@@ -11,9 +11,7 @@
<p>One important thing to note regarding the use of <code>:parent</code> (and <code>:empty</code>) is that child elements include text nodes.</p>
<p>The W3C recommends that the <code>&lt;p&gt;</code> element have at least one child node, even if that child is merely text (see <a href="http://www.w3.org/TR/html401/struct/text.html#edef-P">http://www.w3.org/TR/html401/struct/text.html#edef-P</a>). Some other elements, on the other hand, are empty (i.e. have no children) by definition:<code> &lt;input&gt;</code>, <code>&lt;img&gt;</code>, <code>&lt;br&gt;</code>, and <code>&lt;hr&gt;</code>, for example.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:parent</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":parent"/>
<example>
<desc>Finds all tds with children, including text.</desc>
<code><![CDATA[$("td:parent").fadeTo(1500, 0.3);]]></code>
View
5 entries/password-selector.xml
@@ -9,10 +9,7 @@
<longdesc>
<p><code>$(':password')</code> is equivalent to <code>$('[type=password]')</code>. As with other pseudo-class selectors (those that begin with a ":") it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ("*") is implied. In other words, the bare <code>$(':password')</code> is equivalent to <code>$('*:password')</code>, so <code>$('input:password')</code> should be used instead. </p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:password</placeholder>
- <placeholder name="alt">[type="password"]</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":password" data-alt="[type=&quot;password&quot;]"/>
<example>
<desc>Finds all password inputs.</desc>
<code><![CDATA[
View
6 entries/prop.xml
@@ -70,8 +70,7 @@ According to the <a href="http://www.w3.org/TR/html401/interact/forms.html#h-17.
</ul>
<p>If using jQuery 1.6, the code <code>if ( $(elem).attr("checked") )</code> will retrieve the actual content <em>attribute</em>, which does not change as the checkbox is checked and unchecked. It is meant only to store the default or initial value of the checked property. To maintain backwards compatability, the <code>.attr()</code> method in jQuery 1.6.1+ will retrieve and update the property for you so no code for boolean attributes is required to be changed to <code>.prop()</code>. Nevertheless, the preferred way to retrieve a checked value is with one of the options listed above. To see how this works in the latest jQuery, check/uncheck the checkbox in the example below.</p>
</longdesc>
- <note id="prop-memory-leaks" type="additional">
-</note>
+ <note id="prop-memory-leaks" type="additional"/>
<example>
<desc>Display the checked property and attribute of a checkbox as it changes.</desc>
<code><![CDATA[
@@ -138,8 +137,7 @@ $("input").val("someValue");
});</pre>
<p><strong>Note: </strong>If nothing is returned in the setter function (ie. <code>function(index, prop){})</code>, or if <code>undefined</code> is returned, the current value is not changed. This is useful for selectively setting values only when certain criteria are met.</p>
</longdesc>
- <note id="prop-memory-leaks" type="additional">
-</note>
+ <note id="prop-memory-leaks" type="additional"/>
<example>
<desc>Disable all checkboxes on the page.</desc>
<code><![CDATA[
View
5 entries/radio-selector.xml
@@ -10,10 +10,7 @@
<p><code>$(':radio')</code> is equivalent to <code>$('[type=radio]')</code>. As with other pseudo-class selectors (those that begin with a ":") it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ("*") is implied. In other words, the bare <code>$(':radio')</code> is equivalent to <code>$('*:radio')</code>, so <code>$('input:radio')</code> should be used instead. </p>
<p>To select a set of associated radio buttons, you might use: <code>$('input[name=gender]:radio')</code></p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:radio</placeholder>
- <placeholder name="alt">[type="radio"]</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":radio" data-alt="[type=&quot;radio&quot;]"/>
<example>
<desc>Finds all radio inputs.</desc>
<code><![CDATA[
View
5 entries/reset-selector.xml
@@ -9,10 +9,7 @@
<longdesc>
<p><code>:reset</code> is equivalent to <code>[type="reset"]</code></p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="alt">[type="reset"]</placeholder>
- <placeholder name="selector">:reset</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":reset" data-alt="[type=&quot;reset&quot;]"/>
<example>
<desc>Finds all reset inputs.</desc>
<code><![CDATA[
View
4 entries/selected-selector.xml
@@ -9,9 +9,7 @@
<longdesc>
<p>The <code>:selected</code> selector works for <code>&lt;option&gt;</code> elements. It does not work for checkboxes or radio inputs; use <code>:checked</code> for them.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:selected</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":selected"/>
<example>
<desc>Attaches a change event to the select that gets the text for each selected option and writes them in the div. It then triggers the event for the initial text draw.</desc>
<code><![CDATA[
View
4 entries/show.xml
@@ -57,9 +57,7 @@ $('#clickme').click(function() {
<img src="/resources/0042_06_04.png" alt=""/>
</p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.show()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".show()"/>
<example>
<desc>Animates all hidden paragraphs to show slowly, completing the animation within 600 milliseconds.</desc>
<code><![CDATA[
View
4 entries/slideDown.xml
@@ -49,9 +49,7 @@
<p>If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but <code>this</code> is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.</p>
<p><strong>As of jQuery 1.6</strong>, the <code><a href="http://api.jquery.com/promise/">.promise()</a></code> method can be used in conjunction with the <code><a href="http://api.jquery.com/deferred.done/">deferred.done()</a></code> method to execute a single callback for the animation as a whole when <em>all</em> matching elements have completed their animations ( See the <a href="http://api.jquery.com/promise/#example-1">example for .promise()</a> ). </p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.slideDown()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".slideDown()"/>
<example>
<desc>Animates all divs to slide down and show themselves over 600 milliseconds.</desc>
<code><![CDATA[
View
4 entries/slideToggle.xml
@@ -58,9 +58,7 @@
<p>If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but <code>this</code> is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.</p>
<p><strong>As of jQuery 1.6</strong>, the <code><a href="http://api.jquery.com/promise/">.promise()</a></code> method can be used in conjunction with the <code><a href="http://api.jquery.com/deferred.done/">deferred.done()</a></code> method to execute a single callback for the animation as a whole when <em>all</em> matching elements have completed their animations ( See the <a href="http://api.jquery.com/promise/#example-1">example for .promise()</a> ). </p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.slideToggle()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".slideToggle()"/>
<example>
<desc>Animates all paragraphs to slide up or down, completing the animation within 600 milliseconds.</desc>
<code><![CDATA[
View
4 entries/slideUp.xml
@@ -50,9 +50,7 @@
<p>If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is not sent any arguments, but <code>this</code> is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched element, not once for the animation as a whole.</p>
<p><strong>As of jQuery 1.6</strong>, the <code><a href="http://api.jquery.com/promise/">.promise()</a></code> method can be used in conjunction with the <code><a href="http://api.jquery.com/deferred.done/">deferred.done()</a></code> method to execute a single callback for the animation as a whole when <em>all</em> matching elements have completed their animations ( See the <a href="http://api.jquery.com/promise/#example-1">example for .promise()</a> ). </p>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.slideUp()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".slideUp()"/>
<example>
<desc>Animates all divs to slide up, completing the animation within 400 milliseconds.</desc>
<code><![CDATA[
View
5 entries/submit-selector.xml
@@ -9,10 +9,7 @@
<longdesc>
<p>The <code>:submit</code> selector typically applies to button or input elements. Note that some browsers treat <code>&lt;button&gt;</code> element as <code>type="default"</code> implicitly while others (such as Internet Explorer) do not. </p>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:submit</placeholder>
- <placeholder name="alt">[type="submit"]</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":submit" data-alt="[type=&quot;submit&quot;]"/>
<example>
<desc>Finds all submit elements that are descendants of a td element.</desc>
<code><![CDATA[
View
5 entries/text-selector.xml
@@ -14,10 +14,7 @@
$('&lt;input&gt;').is(':text'); // true
</pre>
</longdesc>
- <note id="jquery-selector-extension-alt" type="additional">
- <placeholder name="selector">:text</placeholder>
- <placeholder name="alt">[type="text"]</placeholder>
- </note>
+ <note id="jquery-selector-extension-alt" type="additional" data-selector=":text" data-alt="[type=&quot;text&quot;]"/>
<example>
<desc>Finds all text inputs.</desc>
<code><![CDATA[
View
4 entries/toggle.xml
@@ -79,9 +79,7 @@
}
</pre>
</longdesc>
- <note id="jquery.fx.off" type="additional">
- <placeholder name="title">.toggle()</placeholder>
- </note>
+ <note id="jquery.fx.off" type="additional" data-title=".toggle()"/>
<example>
<desc>Toggles all paragraphs.</desc>
<code><![CDATA[
View
4 entries/visible-selector.xml
@@ -11,9 +11,7 @@
<p>Elements with <code>visibility: hidden</code> or <code>opacity: 0</code> are considered visible, since they still consume space in the layout. During animations that hide an element, the element is considered to be visible until the end of the animation. During animations to show an element, the element is considered to be visible at the start at the animation.</p>
<p>How <code>:visible</code> is calculated was changed in jQuery 1.3.2. The <a href="http://docs.jquery.com/Release:jQuery_1.3.2#:visible.2F:hidden_Overhauled">release notes</a> outline the changes in more detail.</p>
</longdesc>
- <note id="jquery-selector-extension" type="additional">
- <placeholder name="selector">:visible</placeholder>
- </note>
+ <note id="jquery-selector-extension" type="additional" data-selector=":visible"/>
<example>
<desc>Make all visible divs turn yellow on click.</desc>
<code><![CDATA[
View
35 entries2html.xsl
@@ -1,7 +1,9 @@
<xsl:stylesheet version='1.0' xmlns:xsl='http://www.w3.org/1999/XSL/Transform'>
-<xsl:import href="xml2json.xsl"/>
<xsl:output method="html" omit-xml-declaration="yes"/>
+<!-- escape-string, from xml2json.xsl -->
+<xsl:template name="escape-string"><xsl:param name="s"/><xsl:text>"</xsl:text><xsl:call-template name="escape-bs-string"><xsl:with-param name="s" select="$s"/></xsl:call-template><xsl:text>"</xsl:text></xsl:template><xsl:template name="escape-bs-string"><xsl:param name="s"/><xsl:choose><xsl:when test="contains($s,'\')"><xsl:call-template name="escape-quot-string"><xsl:with-param name="s" select="concat(substring-before($s,'\'),'\\')"/></xsl:call-template><xsl:call-template name="escape-bs-string"><xsl:with-param name="s" select="substring-after($s,'\')"/></xsl:call-template></xsl:when><xsl:otherwise><xsl:call-template name="escape-quot-string"><xsl:with-param name="s" select="$s"/></xsl:call-template></xsl:otherwise></xsl:choose></xsl:template><xsl:template name="escape-quot-string"><xsl:param name="s"/><xsl:choose><xsl:when test="contains($s,'&quot;')"><xsl:call-template name="encode-string"><xsl:with-param name="s" select="concat(substring-before($s,'&quot;'),'\&quot;')"/></xsl:call-template><xsl:call-template name="escape-quot-string"><xsl:with-param name="s" select="substring-after($s,'&quot;')"/></xsl:call-template></xsl:when><xsl:otherwise><xsl:call-template name="encode-string"><xsl:with-param name="s" select="$s"/></xsl:call-template></xsl:otherwise></xsl:choose></xsl:template><xsl:template name="encode-string"><xsl:param name="s"/><xsl:choose><!-- tab --><xsl:when test="contains($s,'&#x9;')"><xsl:call-template name="encode-string"><xsl:with-param name="s" select="concat(substring-before($s,'&#x9;'),'\t',substring-after($s,'&#x9;'))"/></xsl:call-template></xsl:when><!-- line feed --><xsl:when test="contains($s,'&#xA;')"><xsl:call-template name="encode-string"><xsl:with-param name="s" select="concat(substring-before($s,'&#xA;'),'\n',substring-after($s,'&#xA;'))"/></xsl:call-template></xsl:when><!-- carriage return --><xsl:when test="contains($s,'&#xD;')"><xsl:call-template name="encode-string"><xsl:with-param name="s" select="concat(substring-before($s,'&#xD;'),'\r',substring-after($s,'&#xD;'))"/></xsl:call-template></xsl:when><xsl:otherwise><xsl:value-of select="$s"/></xsl:otherwise></xsl:choose></xsl:template>
+
<xsl:template match="option|property">
<h5 class="option">
<xsl:value-of select="@name" />
@@ -22,6 +24,23 @@
</xsl:template>
<!--
+ Notes
+-->
+<xsl:template match="@* | note/node()">
+ <xsl:copy>
+ <xsl:apply-templates select="@* | node()"/>
+ </xsl:copy>
+</xsl:template>
+<xsl:template match="note/note">
+ <xsl:apply-templates select="@* | node()"/>
+</xsl:template>
+<xsl:template match="note//placeholder">
+ <xsl:variable name="name" select="concat('data-',@name)"/>
+ <xsl:value-of select="ancestor::note/@*[name()=$name]"/>
+</xsl:template>
+
+
+<!--
Render type(s) for a parameter or argument element.
Type can either by a @type attribute or one or more <type> child elements.
-->
@@ -107,8 +126,8 @@
<script>
{
- "title": <xsl:apply-templates select="//entry/title/text()" />,
- "excerpt": <xsl:apply-templates select="//entry[1]/desc/text()|//entry[1]/desc/*" />,
+ "title": <xsl:call-template name="escape-string"><xsl:with-param name="s" select="//entry/title/text()"/></xsl:call-template>,
+ "excerpt": <xsl:call-template name="escape-string"><xsl:with-param name="s" select="//entry[1]/desc/text()|//entry[1]/desc/*"/></xsl:call-template>,
"termSlugs": {
"category": [
<xsl:for-each select="//entry/category"><xsl:if test="position() &gt; 1"><xsl:text>,</xsl:text></xsl:if>"<xsl:value-of select="@slug"/>"</xsl:for-each>
@@ -318,6 +337,16 @@
<xsl:copy-of select="longdesc/*" />
</div>
</xsl:if>
+ <xsl:if test="note">
+ <h3>Additional Notes:</h3>
+ <div class="longdesc">
+ <ul>
+ <xsl:for-each select="note">
+ <li><xsl:apply-templates select="."/></li>
+ </xsl:for-each>
+ </ul>
+ </div>
+ </xsl:if>
<xsl:if test="$number-examples &gt; 0">
<h3>Example<xsl:if test="$number-examples &gt; 1">s</xsl:if>:</h3>
<div class="entry-examples">
View
62 grunt.js
@@ -5,15 +5,16 @@ var // modules
fs = require( "fs" ),
path = require( "path" ),
pygmentize = require( "pygmentize" ),
+ rimraf = require( "rimraf" ),
spawn = require( "child_process" ).spawn,
// files
pageFiles = grunt.file.expandFiles( "pages/*.html" ),
entryFiles = grunt.file.expandFiles( "entries/*.xml" ),
- categoryFiles = grunt.file.expandFiles( "categories/*.xml" ),
+ noteFiles = grunt.file.expandFiles( "notes/*.xml" ),
resourceFiles = grunt.file.expandFiles( "resources/*" ),
- xmlFiles = [].concat( entryFiles, categoryFiles, "cat2tax.xsl", "categories.xml", "entries2html.xsl", "xml2json.xsl" );
+ xmlFiles = [].concat( entryFiles, noteFiles, "cat2tax.xsl", "categories.xml", "entries2html.xsl", "xml2json.xsl" );
function pathSlug( fileName ) {
return path.basename( fileName, path.extname( fileName ) );
@@ -61,7 +62,7 @@ grunt.registerTask( "xmllint", function() {
taskDone();
return;
}
- grunt.log.writeln( "Lint free files: " + entryFiles.length );
+ grunt.log.writeln( "Lint free files: " + xmlFiles.length );
taskDone();
});
});
@@ -76,6 +77,7 @@ grunt.registerTask( "build-pages", function() {
grunt.utils.async.forEachSeries( pageFiles, function( fileName, fileDone ) {
var targetFileName = targetDir + path.basename( fileName );
grunt.verbose.write( "Reading " + fileName + "..." );
+ grunt.verbose.ok();
grunt.verbose.write( "Pygmentizing " + targetFileName + "..." );
pygmentize.file( fileName, function( error, data ) {
if ( error ) {
@@ -110,12 +112,11 @@ grunt.registerTask( "build-entries", function() {
grunt.file.mkdir( targetDir );
grunt.utils.async.forEachSeries( entryFiles, function( fileName, fileDone ) {
- grunt.verbose.write( "Reading " + fileName + "..." );
+ grunt.verbose.write( "Transforming (pass 1: preproc-xinclude.xsl) " + fileName + "..." );
grunt.utils.spawn({
cmd: "xsltproc",
- args: [ "entries2html.xsl", fileName ]
- }, function( err, result ) {
- var targetFileName;
+ args: [ "preproc-xinclude.xsl", fileName ]
+ }, function( err, pass1result ) {
if ( err ) {
grunt.verbose.error();
grunt.log.error( err );
@@ -123,25 +124,42 @@ grunt.registerTask( "build-entries", function() {
return;
}
grunt.verbose.ok();
-
- targetFileName = targetDir + path.basename( fileName );
- targetFileName = targetFileName.substr( 0, targetFileName.length - "xml".length ) + "html";
-
- grunt.verbose.write( "Pygmentizing " + targetFileName + "..." );
- pygmentize.file( result, function( error, data ) {
- if ( error ) {
+
+ var targetXMLFileName = "entries_tmp/" + path.basename( fileName );
+
+ grunt.file.write( targetXMLFileName, pass1result );
+
+ grunt.verbose.write( "Transforming (pass 2: entries2html.xsl) " + fileName + "..." );
+ grunt.utils.spawn({
+ cmd: "xsltproc",
+ args: [ "--xinclude", "entries2html.xsl", targetXMLFileName ]
+ }, function( err, pass2result ) {
+ if ( err ) {
grunt.verbose.error();
- grunt.log.error( error );
+ grunt.log.error( err );
fileDone();
return;
}
grunt.verbose.ok();
- grunt.file.write( targetFileName, data );
+ var targetHTMLFileName = targetDir + path.basename( fileName );
+ targetHTMLFileName = targetHTMLFileName.substr( 0, targetHTMLFileName.length - "xml".length ) + "html";
+
+ grunt.verbose.write( "Pygmentizing " + targetHTMLFileName + "..." );
+ pygmentize.file( pass2result, function( error, data ) {
+ if ( error ) {
+ grunt.verbose.error();
+ grunt.log.error( error );
+ fileDone();
+ return;
+ }
+ grunt.verbose.ok();
- fileDone();
- });
+ grunt.file.write( targetHTMLFileName, data );
+ fileDone();
+ });
+ });
});
}, function() {
if ( task.errorCount ) {
@@ -149,6 +167,7 @@ grunt.registerTask( "build-entries", function() {
taskDone();
return;
}
+ rimraf.sync( "entries_tmp" );
grunt.log.writeln( "Built " + entryFiles.length + " entries." );
taskDone();
});
@@ -210,12 +229,13 @@ grunt.registerTask( "build-resources", function() {
grunt.registerTask( "xmltidy", function() {
var task = this,
- taskDone = task.async();
+ taskDone = task.async(),
+ filesToTidy = [].concat( entryFiles, noteFiles, "categories.xml" );
// Only tidy files that are lint free
task.requires( "xmllint" );
- grunt.utils.async.forEachSeries( entryFiles, function( fileName, fileDone ) {
+ grunt.utils.async.forEachSeries( filesToTidy, function( fileName, fileDone ) {
grunt.verbose.write( "Tidying " + fileName + "..." );
grunt.utils.spawn({
cmd: "xmllint",
@@ -239,7 +259,7 @@ grunt.registerTask( "xmltidy", function() {
taskDone();
return;
}
- grunt.log.writeln( "Tidied " + entryFiles.length + " files." );
+ grunt.log.writeln( "Tidied " + filesToTidy.length + " files." );
taskDone();
});
});
View
5 notes/document-order.xml
@@ -1 +1,4 @@
-Selected elements are in the order of their appearance in the document.
+<?xml version="1.0"?>
+<note>
+ Selected elements are in the order of their appearance in the document.
+</note>
View
6 notes/domlint.xml
@@ -1,2 +1,4 @@
-Forms and their child elements should not use input names or ids that conflict with properties of a form, such as <code>submit</code>, <code>length</code>, or <code>method</code>. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see <a href=\"http://kangax.github.com/domlint/\">DOMLint</a>.
-
+<?xml version="1.0"?>
+<note>
+ Forms and their child elements should not use input names or ids that conflict with properties of a form, such as <code>submit</code>, <code>length</code>, or <code>method</code>. Name conflicts can cause confusing failures. For a complete list of rules and to check your markup for these problems, see <a href="http://kangax.github.com/domlint/">DOMLint</a>.
+</note>
View
8 notes/jquery-selector-extension-alt.xml
@@ -1,4 +1,4 @@
-<note id="jquery-selector-extension-alt" type="additional">
- <desc>Because <code>%selector%</code> is a jQuery extension and not part of the CSS specification, queries using <code>%selector%</code> cannot take advantage of the performance boost provided by the native DOM <code>querySelectorAll()</code> method. For better performance in modern browsers, use <code>%alt%</code> instead.
- </desc>
-</note>
+<?xml version="1.0"?>
+<note>
+ Because <code><placeholder name="selector"/></code> is a jQuery extension and not part of the CSS specification, queries using <code><placeholder name="selector"/></code> cannot take advantage of the performance boost provided by the native DOM <code>querySelectorAll()</code> method. For better performance in modern browsers, use <code><placeholder name="alt"/></code> instead.
+</note>
View
8 notes/jquery-selector-extension.xml
@@ -1,4 +1,4 @@
-<note id="jquery-selector-extension" type="additional">
- <desc>Because <code>%selector%</code> is a jQuery extension and not part of the CSS specification, queries using <code>%selector%</code> cannot take advantage of the performance boost provided by the native DOM <code>querySelectorAll()</code> method. To achieve the best performance when using <code>%selector%</code> to select elements, first select the elements using a pure CSS selector, then use <a href="http://api.jquery.com/filter/"><code>.filter("%selector%")</code></a>.
- </desc>
-</note>
+<?xml version="1.0"?>
+<note>
+ Because <code><placeholder name="selector"/></code> is a jQuery extension and not part of the CSS specification, queries using <code><placeholder name="selector"/></code> cannot take advantage of the performance boost provided by the native DOM <code>querySelectorAll()</code> method. To achieve the best performance when using <code><placeholder name="selector"/></code> to select elements, first select the elements using a pure CSS selector, then use <a href="http://api.jquery.com/filter/"><code>.filter("<placeholder name="selector"/>")</code></a>.
+</note>
View
5 notes/jquery.fx.off.xml
@@ -1 +1,4 @@
-All jQuery effects, including <code>%title%</code>, can be turned off globally by setting <code>jQuery.fx.off = true</code>, which effectively sets the duration to 0. For more information, see <a href=\"http://api.jquery.com/jquery.fx.off\">jQuery.fx.off</a>.
+<?xml version="1.0"?>
+<note>
+ All jQuery effects, including <code><placeholder name="title"/></code>, can be turned off globally by setting <code>jQuery.fx.off = true</code>, which effectively sets the duration to 0. For more information, see <a href="http://api.jquery.com/jquery.fx.off">jQuery.fx.off</a>.
+</note>
View
5 notes/no-data-on-xml.xml
@@ -1 +1,4 @@
-Note that this method currently does not provide cross-platform support for setting data on XML documents, as Internet Explorer does not allow data to be attached via expando properties.
+<?xml version="1.0"?>
+<note>
+ Note that this method currently does not provide cross-platform support for setting data on XML documents, as Internet Explorer does not allow data to be attached via expando properties.
+</note>
View
5 notes/prop-memory-leaks.xml
@@ -1 +1,4 @@
-In Internet Explorer prior to version 9, using <code><a href=\"http://api.jquery.com/prop/\">.prop()</a></code> to set a DOM element property to anything other than a simple primitive value (number, string, or boolean) can cause memory leaks if the property is not removed (using <a href=\"http://api.jquery.com/removeProp/\"><code>.removeProp()</code></a>) before the DOM element is removed from the document. To safely set values on DOM objects without memory leaks, use <a href=\"http://api.jquery.com/data/\"><code>.data()</code></a>.
+<?xml version="1.0"?>
+<note>
+ In Internet Explorer prior to version 9, using <code><a href="http://api.jquery.com/prop/">.prop()</a></code> to set a DOM element property to anything other than a simple primitive value (number, string, or boolean) can cause memory leaks if the property is not removed (using <a href="http://api.jquery.com/removeProp/"><code>.removeProp()</code></a>) before the DOM element is removed from the document. To safely set values on DOM objects without memory leaks, use <a href="http://api.jquery.com/data/"><code>.data()</code></a>.
+</note>
View
5 notes/propagation-for-live-or-delegate.xml
@@ -1 +1,4 @@
-Since the <a href=\"http://api.jquery.com/live\"><code>.live()</code></a> method handles events once they have propagated to the top of the document, it is not possible to stop propagation of live events. Similarly, events handled by <code><a href=\"http://api.jquery.com/delegate/\">.delegate()</a></code> will propagate to the elements to which they are delegated; event handlers bound on any elements below it in the DOM tree will already have been executed by the time the delegated event handler is called. These handlers, therefore, may prevent the delegated handler from triggering by calling <code><a href=\"http://api.jquery.com/event.stopPropagation/\">event.stopPropagation()</a></code> or returning <code>false</code>.
+<?xml version="1.0"?>
+<note>
+ Since the <a href="http://api.jquery.com/live"><code>.live()</code></a> method handles events once they have propagated to the top of the document, it is not possible to stop propagation of live events. Similarly, events handled by <code><a href="http://api.jquery.com/delegate/">.delegate()</a></code> will propagate to the elements to which they are delegated; event handlers bound on any elements below it in the DOM tree will already have been executed by the time the delegated event handler is called. These handlers, therefore, may prevent the delegated handler from triggering by calling <code><a href="http://api.jquery.com/event.stopPropagation/">event.stopPropagation()</a></code> or returning <code>false</code>.
+</note>
View
5 notes/same-origin-policy-exceptions.xml
@@ -1 +1,4 @@
-Script and JSONP requests are not subject to the same origin policy restrictions.
+<?xml version="1.0"?>
+<note>
+ Script and JSONP requests are not subject to the same origin policy restrictions.
+</note>
View
8 notes/same-origin-policy.xml
@@ -1,4 +1,4 @@
-<note id="same-origin-policy" type="additional">
- <desc>Due to browser security restrictions, most "Ajax" requests are subject to the <a title="Same Origin Policy on Wikipedia" href="http://en.wikipedia.org/wiki/Same_origin_policy">same origin policy</a>; the request can not successfully retrieve data from a different domain, subdomain, or protocol.
- </desc>
-</note>
+<?xml version="1.0"?>
+<note>
+ Due to browser security restrictions, most "Ajax" requests are subject to the <a title="Same Origin Policy on Wikipedia" href="http://en.wikipedia.org/wiki/Same_origin_policy">same origin policy</a>; the request can not successfully retrieve data from a different domain, subdomain, or protocol.
+</note>
View
8 notes/use-ajaxerror.xml
@@ -1,4 +1,4 @@
-<note id="use-ajaxerror" type="additional">
- <desc>If a request with %title% returns an error code, it will fail silently unless the script has also called the global <a href="http://api.jquery.com/ajaxError/">.ajaxError() </a> method. Alternatively, as of jQuery 1.5, the <code>.error()</code> method of the <code>jqXHR</code> object returned by %title% is also available for error handling.
- </desc>
-</note>
+<?xml version="1.0"?>
+<note>
+ If a request with <placeholder name="title"/> returns an error code, it will fail silently unless the script has also called the global <a href="http://api.jquery.com/ajaxError/">.ajaxError() </a> method. Alternatively, as of jQuery 1.5, the <code>.error()</code> method of the <code>jqXHR</code> object returned by <placeholder name="title"/> is also available for error handling.
+</note>
View
3  package.json
@@ -24,7 +24,8 @@
"grunt": "0.3.x",
"grunt-clean": "0.1.0",