DEV Community

Cover image for Traversing the DOM Tutorial
Richard Rembert
Richard Rembert

Posted on • Edited on

Traversing the DOM Tutorial

In this article, we’re going to learn all about traversing DOM elements. When we traverse the DOM, we’re essentially navigating through the DOM. We work with parent, child and sibling properties to apply our JavaScript to DOM elements.

Let's use the following example:

<!DOCTYPE html>
<html>
<head>
  <title>Traversing the DOM</title>
</head>
<body>
  <h1>Traversing the DOM</h1>
  <p>Let's work with this example to <strong>MASTER</strong> the DOM!</p>
  <h2>List of Items..</h2>
  <ul>
    <li>Steak</li>
    <li>Chicken</li>
    <li>Fish</li>
  </ul>
</body>
<script>
  const h1 = document.getElementsByTagName('h1')[0];
  const p = document.getElementsByTagName('p')[0];
  const ul = document.getElementsByTagName('ul')[0];
</script>
</html>
Enter fullscreen mode Exit fullscreen mode

Our file will open up in the browser like so:
Transversing the DOM

Root Nodes

The document object is the root of every node in the DOM.* The next level up is the window object — which includes things such as *browser tabs, toolbars, prompts and alerts. We’ll be working with the DOM and thus the document object, which consists of what is inside of the inner window.

By default, every document contains the html, head, and body elements.

Check the contents of each by running the following in your console:

document.head;     // ► <head>...</head>
document.body;     // ► <body>...</body>
Enter fullscreen mode Exit fullscreen mode

Parent Nodes

As mentioned earlier, the nodes in the DOM are referred to as parents, children, and siblings, depending on their relation to other nodes. The parent of any particular node is the node that is one level above it in the DOM hierarchy.

In our example:

  • html is the parent of head, body, and script.
  • body is the parent of h1, h2, p and ul, but not li, as li is two levels down from body.

We can check the parent of our p element for example, with the parentNode property. As we’ve assigned p to a variable all we need to do is type:

p.parentNode;      // ► <body>...</body>
Enter fullscreen mode Exit fullscreen mode

We can even go two levels up with:

p.parentNode.parentNode;      // ► <html>...</html>
Enter fullscreen mode Exit fullscreen mode

Child Nodes

The children of a node are the nodes that are one level below. Any nodes beyond one level of nesting are usually referred to as descendants.

There are a number of properties we’ll often be working with here, such as childNodes, firstChild, lastChild, children, firstElementChild and lastElementChild.

Let's start with the childNodes property, it will return a list of every child of a given node:

ul.childNodes   // ► NodeList(7) [text, li, text, li, text, li, text]
Enter fullscreen mode Exit fullscreen mode

Perhaps you were expecting just three li’s to be returned? The text nodes are actually whitespace caused by indentation between elements — which the DOM considers as nodes. You can’t see them under your Elements tab, as Dev Tools removes these nodes automatically.

For this reason, if we attempt to alter the background color of the first child node for example, it’d fail as the first child is text.

ul.firstChild.style.background = "blue";

// output:

Uncaught TypeError: Cannot set property 'background' of undefined
Enter fullscreen mode Exit fullscreen mode

When we want to work with element nodes only, we should use the children, firstElementChild and lastElementChild properties.

ul.children would return only the three li elements.

And to change just our first li, we’d use:

ul.firstElementChild.style.background = 'blue';
Enter fullscreen mode Exit fullscreen mode

Here’s our updated page:
DOM Element
If we want to alter all of our children elements, we could use a for...of loop like so:

for (let element of ul.children) {
  element.style.background = 'blue';
}
Enter fullscreen mode Exit fullscreen mode

Now all our child elements have the background color change:
DOM Elements-2
If we take a look at our p element, we’ll see it contains both text and other elements (our strong tag).

for (let element of p.childNodes) {
  console.log(element);
}

// output:

"Let's work with this example to " 
<strong>MASTER</strong> 
" the DOM!"
Enter fullscreen mode Exit fullscreen mode

The childNodes property is useful when we wish to access that information.

Both childNodes and children do not return traditional JavaScript arrays (with all their associated properties & methods), but rather array-like objects. As you would with an array, however, you can access nodes by index number, or even find their length property.

document.body.children[3].lastElementChild.style.background = 'red';
Enter fullscreen mode Exit fullscreen mode

With this code, we’ll find the last element child li of the fourth child element ul of body and apply our style.
DOM-Elements-3
By using parent and child properties, you can retrieve any node in the DOM!

Sibling Nodes

Let’s now take a look at sibling nodes. Siblings of a node are any node on the same tree level in the DOM. They don’t have to be the same type of node — text, element, and comment nodes can all be siblings. The properties we’ll often work with here are nextSibling, previousSibling, nextElementSibling and previousElementSibling.

Sibling properties work in the same way as child nodes: previousSibling and nextSibling will get the next node that immediately precedes or follows the specified node, and previousElementSibling and nextElementSibling will only get element nodes.

Let’s get the middle element from our ul:

const burger = ul.children[1];
Enter fullscreen mode Exit fullscreen mode

And let’s use the element sibling properties to access the next and previous elements (avoiding the whitespace text):

burger.nextElementSibling.style.background = 'purple';
burger.previousElementSibling.style.background = 'green';
Enter fullscreen mode Exit fullscreen mode

These changes will now show in our example:
DOM-Elements-4
In the next tutorial, we’ll move on to making changes to the DOM. Stay tuned!

Conclusion

If you liked this blog post, follow me on Twitter where I post daily about Tech related things!
Buy Me A Coffee If you enjoyed this article & would like to leave a tip — click here

🌎 Let's Connect

Top comments (0)