doc: Merge/update old Element.Methods.match docs into source [prototy…

…pejs#85 state:fixed_in_branch]
samleb · Jan 12, 2010 · cb27017 · cb27017
1 parent 21f707d
commit cb27017
Showing 1 changed file with 22 additions and 0 deletions.
diff --git a/src/dom/dom.js b/src/dom/dom.js
@@ -732,6 +732,28 @@ Element.Methods = {
    *  - selector (String): A CSS selector.
    *
    *  Checks if `element` matches the given CSS selector.
+   *
+   *  ##### Examples
+   *  
+   *      <ul id="fruits">
+   *        <li id="apples">
+   *          <ul>
+   *            <li id="golden-delicious">Golden Delicious</li>
+   *            <li id="mutsu" class="yummy">Mutsu</li>
+   *            <li id="mcintosh" class="yummy">McIntosh</li>
+   *            <li id="ida-red">Ida Red</li>
+   *          </ul>
+   *        </li>
+   *      </ul>
+   *  
+   *      $('fruits').match('ul');
+   *      // -> true
+   *      
+   *      $('mcintosh').match('li#mcintosh.yummy');
+   *      // -> true
+   *      
+   *      $('fruits').match('p');
+   *      // -> false
   **/
   match: function(element, selector) {
     element = $(element);