.parent()S2C Home « Traversal « .parent()

Parent element retrieval.

Description

The .parent() method is used to retrieve the parent of each element within the matched set.

  • The .parent() method will only travel a single level up the DOM tree, use the .parents() method to travel up to grandparents and beyond.

Syntax

Signature Description
.parent()Retrieve the parent of each element within the matched set.
.parent( selector )Retrieve the parent of each element within the matched set that matches the specified selector.

Parameters

Parameter Description Type
selectorA string containing a CSS or custom jQuery selector to match elements against.Selector

Return

A jQuery object either containing the elements matched or empty.

.parent() ExampleTop

Retrieve the parent of each element within the matched set.

In the example below we select the parent of each 'a' element within the #main section of the page and turn the background colour to yellow.


$(function(){
  $('#btn21').on('click', function() {
    $('#main a').parent()
                .css('backgroundColor', 'yellow');
  });
});

Press the button below to action the above code:


.parent( selector ) ExampleTop

Retrieve the parent of each element within the matched set that matches the specified selector.

In the example below we select only 'span' parents of each 'a' element within the #main section of the page and turn the background colour to orange. Notice that with the additional selector filter only the 'span' elements on the right are changed.


$(function(){
  $('#btn22').on('click', function() {
    $('#main a').parent('span')
                .css('backgroundColor', 'orange');
  });
});

Press the button below to action the above code: