tadam logo
Did you find an error in the text?
Select this with mouse and press
Ctrl + Enter
Xhtml.co.il Check Spelling
Orphus system

.get( [ index ] )

Returns: Element, Array
version added: 1.0
Description: Retrieve the DOM elements matched by the jQuery object.

Arguments

index (Optional)
A zero-based integer indicating which element to retrieve.

The .get() method grants us access to the DOM nodes underlying each jQuery object. Suppose we had a simple unordered list on the page:

<ul>
  <li id="foo">foo</li>
  <li id="bar">bar</li>
</ul>

Without a parameter, .get() returns all of the elements:

alert($('li').get());

All of the matched DOM nodes are returned by this call, contained in a standard array:

[<li id="foo">, <li id="bar">]

With an index specified, .get() will retrieve a single element:

($('li').get(0));

Since the index is zero-based, the first list item is returned:

<li id="foo">

Each jQuery object also masquerades as an array, so we can use the array dereferencing operator to get at the list item instead:

alert($('li')[0]);

However, this syntax lacks some of the additional capabilities of .get(), such as specifying a negative index:

alert($('li').get(-1));

A negative index is counted from the end of the matched set, so this example will return the last item in the list:

<li id="bar">

Examples

Example 1

Selects all divs in the document and returns the DOM Elements as an Array, then uses the built-in reverse-method to reverse that array.
    function disp(divs) {
      var a = [];
      for (var i = 0; i < divs.length; i++) {
        a.push(divs[i].innerHTML);
      }
      $("span").text(a.join(" "));
    }
    disp( $("div").get().reverse() );
The output of the code above will be:
Full source:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-1.5.js"></script>
  
  <script>

  $(document).ready(function(){
    
    function disp(divs) {
      var a = [];
      for (var i = 0; i < divs.length; i++) {
        a.push(divs[i].innerHTML);
      }
      $("span").text(a.join(" "));
    }
    
    disp( $("div").get().reverse() );

  });
  </script>
  <style>
  span { color:red; }
  </style>

</head>
<body>
  Reversed - <span></span>
  <div>One</div>
  <div>Two</div>

  <div>Three</div>
</body>
</html>

Example 2

Gives the tag name of the element clicked on.
    $("*", document.body).click(function (e) {
      e.stopPropagation();
      var domEl = $(this).get(0);
      $("span:first").text("Clicked on - " + domEl.tagName);
    });

The output of the code above will be:
Full source:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
                    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <script src="http://code.jquery.com/jquery-1.5.js"></script>
  
  <script>

  $(document).ready(function(){
    $("*", document.body).click(function (e) {
      e.stopPropagation();
      var domEl = $(this).get(0);
      $("span:first").text("Clicked on - " + domEl.tagName);
    });
  });
  </script>
  <style>
  span { color:red; }
  div { background:yellow; }
  </style>

</head>
<body>
  <span> </span>
  <p>In this paragraph is an <span>important</span> section</p>

  <div><input type="text" /></div>
</body>
</html>
Was this information helpful?
   

Comments