Upgrade to ExtJS 4.0.1 - Released 05/18/2011

[extjs.git] / docs / source / DomQuery.html
diff --git a/docs/source/DomQuery.html b/docs/source/DomQuery.html

index 97bfc25..ae27f15 100644 (file)
--- a/docs/source/DomQuery.html
+++ b/docs/source/DomQuery.html
@@ -1,4 +1,21 @@
-<!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre>/*
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>The source code</title>
+  <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
+  <script type="text/javascript" src="../prettify/prettify.js"></script>
+  <style type="text/css">
+    .highlight { display: block; background-color: #ddd; }
+  </style>
+  <script type="text/javascript">
+    function highlight() {
+      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+    }
+  </script>
+</head>
+<body onload="prettyPrint(); highlight();">
+  <pre class="prettyprint lang-js">/*
   * This is code is also distributed under MIT license for use
   * with jQuery and prototype JavaScript libraries.
   */
@@ -523,7 +540,10 @@ Ext.core.DomQuery = Ext.DomQuery = function(){
          },
  
  <span id='Ext-DomQuery-method-jsSelect'>        /**
-</span>         * Selects a group of elements.
+</span>         * Selects an array of DOM nodes using JavaScript-only implementation.
+         *
+         * Use {@link #select} to take advantage of browsers built-in support for CSS selectors.
+         *
           * @param {String} selector The selector/xpath query (can be a comma separated list of selectors)
           * @param {Node/String} root (optional) The start of the query (defaults to document).
           * @return {Array} An Array of DOM elements which match the selector. If there are
@@ -573,7 +593,23 @@ Ext.core.DomQuery = Ext.DomQuery = function(){
              var docEl = (el ? el.ownerDocument || el : 0).documentElement;
              return docEl ? docEl.nodeName !== &quot;HTML&quot; : false;
          },
-        
+
+<span id='Ext-DomQuery-method-select'>        /**
+</span>         * Selects an array of DOM nodes by CSS/XPath selector.
+         *
+         * Uses [document.querySelectorAll][0] if browser supports that, otherwise falls back to
+         * {@link #jsSelect} to do the work.
+         * 
+         * Aliased as {@link Ext#query}.
+         * 
+         * [0]: https://developer.mozilla.org/en/DOM/document.querySelectorAll
+         *
+         * @param {String} path The selector/xpath query
+         * @param {Node} root (optional) The start of the query (defaults to document).
+         * @return {Array} An array of DOM elements (not a NodeList as returned by `querySelectorAll`).
+         * Empty array when no matches.
+         * @method
+         */
          select : document.querySelectorAll ? function(path, root, type) {
              root = root || document;
              if (!Ext.DomQuery.isXml(root)) {
@@ -948,4 +984,6 @@ Then external links could be gathered with the following statement:
   * @method query
   */
  Ext.query = Ext.DomQuery.select;
-</pre></pre></body></html>
-\ No newline at end of file
+</pre>
+</body>
+</html>