.pushStack()S2C Home « Core & Internals « .pushStack()

Stack Elements.

Shorthand version  $.pushStack()

Description

The .pushStack() method allows us to put a collection of DOM elements onto the jQuery stack.

Syntax


Signature Description
.pushStack( elementArray )Put a collection of DOM elements onto the jQuery stack.
.pushStack( elementArray, methodName, methodArgs )Put a collection of DOM elements onto the jQuery stack passing across the elementArray along with the methodName and methodArgs used to create it.

Parameters


Parameter Description Type
elementArrayAn array of elements to push onto the stack and make into a new jQuery object.Array
methodNamejQuery method name that created the elementArray.String
methodArgsArguments passed to the jQuery method.Array

Return

None.

.pushStack( elementArray ) Examplego to top of page Top

Put a collection of DOM elements onto the jQuery stack.

In the following example we just create a new jQuery object by pushing all 'p' nodes from this page onto the stack and alert it.


$(function(){
  $('#btn4').on('click', function() { 
    var $hold = $().pushStack( document.getElementsByTagName('p') );
    alert('Our object: ' + JSON.stringify($hold));
  });
}); 

Press the button below to action the above code:


.pushStack(elementArray, methodName, methodArgs) Examplego to top of page Top

Put a collection of DOM elements onto the jQuery stack passing across the elementArray along with the methodName and methodArgs used to create it.

In the following example we just create a variable called $pArray and then push it onto the stack and alert it


$(function(){
  $('#btn5').on('click', function() { 
    var $pArray = $('p').children('em');
    var $hold = $().pushStack( $pArray, 'children', 'em' );
    alert('Our object: ' + JSON.stringify($hold));
  });
}); 

Press the button below to action the above code:


go to home page Homepage go to top of page Top