.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 ) ExampleTop

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) ExampleTop

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: