Quick Tip: Add or Remove a CSS Class with Vanilla JavaScript

Share this article

Laptop with CSS word on screen.

Sometimes you need to add or remove a CSS class with JavaScript, and you don’t want to include an entire library like jQuery to do it.

This is useful in situations when you want your page elements to change in response to user actions.

Example uses include:

  • Showing or hiding a menu
  • Highlighting a form error
  • Showing a dialog box
  • Showing different content in response to a selection
  • Animating an element in response to a click

There are two JavaScript properties that let you work with classes: className and classList. The former is widely compatible, while the latter is more modern and convenient. If you don’t need to support IE 8 and 9, you can skip className.

We’ll start with the compatible version first.

Note: This tutorial assumes some familiarity with JavaScript concepts like functions and variables.

Modifying Classes the Compatible Way

The JavaScript className property lets you access the class attribute of an HTML element. Some string manipulation will let us add and remove classes.

We’ll access HTML elements using querySelectorAll(), which is compatible with browsers from IE8 and up.

Add a Class

To add a class, we’ll write a function that takes in the elements we want to change and adds a specified class to all of them.

function addClass(elements, myClass) {

  // if there are no elements, we're done
  if (!elements) { return; }

  // if we have a selector, get the chosen elements
  if (typeof(elements) === 'string') {
    elements = document.querySelectorAll(elements);
  }

  // if we have a single DOM element, make it an array to simplify behavior
  else if (elements.tagName) { elements=[elements]; }

  // add class to all chosen elements
  for (var i=0; i<elements.length; i++) {

    // if class is not already found
    if ( (' '+elements[i].className+' ').indexOf(' '+myClass+' ') < 0 ) {

      // add class
      elements[i].className += ' ' + myClass;
    }
  }
}

You’ll see how the function works soon, but to watch the function in action, feel free to use this CSS:

.red {
  background: red;
}

.highlight {
  background: gold;
}

…and this HTML:

<div id="iddiv" class="highlight">ID div</div>

<div class="classdiv">Class div</div>
<div class="classdiv">Class div</div>
<div class="classdiv">Class div</div>

Here are some usage examples of the function itself:

addClass('#iddiv','highlight');
addClass('.classdiv','highlight');

addClass(document.getElementById('iddiv'),'highlight');
addClass(document.querySelector('.classdiv'),'highlight');
addClass(document.querySelectorAll('.classdiv'),'highlight');

Notice that you can identify the HTML elements you want to change through a selector or you can directly pass in the elements themselves.

How Our addClass Function Works

Our addClass function first takes two parameters: the HTML elements we want to modify and the class we want to add. Our goal is to loop through each HTML element, make sure the class is not already there, and then add the class.

First, if the list of elements is empty, our function has nothing left to do, so we can get out early.

// if there are no elements, we're done
if (!elements) { return; }

Next, if we’ve chosen to identify our HTML elements through a selector such as #iddiv or .classdiv, then we can use querySelectorAll() to grab all of our desired elements.

// if we have a selector, get the chosen elements
if (typeof(elements) === 'string') {
  elements = document.querySelectorAll(elements);
}

However, if DOM elements are fed into the function directly, we can loop through them. If there’s a single DOM element (rather than a list), we’ll make it an array so we can use the same loop and simplify our code. We can tell if there’s only one element because an element has a tagName property, while a list does not.

// if we have a single DOM element, make it an array to simplify behavior
else if (elements.tagName) { elements=[elements]; }

Now that we have our elements in a format we can loop over, we’ll go through each one, check if the class is already there, and if not, we’ll add the class.

// add class to all chosen elements
for (var i=0; i<elements.length; i++) {

  // if class is not already found
  if ( (' '+elements[i].className+' ').indexOf(' '+myClass+' ') < 0 ) {

    // add class
    elements[i].className += ' ' + myClass;
  }
}

Notice we’re adding a space at the beginning and end in order to simplify the pattern we’re looking for and avoid needing a regular expression.

In any case, we’re done — you can now add a class!

Remove a Class

To remove a class, we can use the following function:

function removeClass(elements, myClass) {

  // if there are no elements, we're done
  if (!elements) { return; }

  // if we have a selector, get the chosen elements
  if (typeof(elements) === 'string') {
    elements = document.querySelectorAll(elements);
  }

  // if we have a single DOM element, make it an array to simplify behavior
  else if (elements.tagName) { elements=[elements]; }

  // create pattern to find class name
  var reg = new RegExp('(^| )'+myClass+'($| )','g');

  // remove class from all chosen elements
  for (var i=0; i<elements.length; i++) {
    elements[i].className = elements[i].className.replace(reg,' ');
  }
}

Most of this removeClass function works the same way as our addClass function; by gathering the desired HTML elements and looping through them. The only difference is the part where the class gets removed.

Here’s the class removal in more detail:

// create pattern to find class name
var reg = new RegExp('(^| )'+myClass+'($| )','g');

// remove class from all chosen elements
for (var i=0; i<elements.length; i++) {
  elements[i].className = elements[i].className.replace(reg,' ');
}

First, we create a regular expression to look for all instances of our desired class. The expression '(^| )'+myClass+'($| )' means the beginning or a space followed by myClass followed by the end or a space. The 'g' means global match, which means find all instances of the pattern.

Using our pattern, we replace the class name with a space. That way, class names in the middle of the list will remain separated, and there’s no harm done if the removed class is on the ends.

Modifying Classes the Modern Way

Browsers from IE10 and up support a property called classList, which makes an element’s classes much easier to deal with.

In a previous article, Craig Buckler provided a list of things classList can do:

The following properties are available:

length — the number of class names applied item(index) — the class name at a specific index contains(class) — returns true if a node has that class applied add(class) — applies a new class to the node remove(class) — removes a class from the node toggle(class) — removes or adds a class if it’s applied or not applied respectively

We can use this in preference to the clunkier className property:

document.getElementById("myelement").classList.add("myclass");

Let’s use this information to create functions that add and remove classes from all elements that match a selector.

These functions will get all desired elements, loop through them, and add or remove a class to each one.

Add Class

function addClass(selector, myClass) {

  // get all elements that match our selector
  elements = document.querySelectorAll(selector);

  // add class to all chosen elements
  for (var i=0; i<elements.length; i++) {
    elements[i].classList.add(myClass);
  }
}

// usage examples:
addClass('.class-selector', 'example-class');
addClass('#id-selector', 'example-class');

Remove class

function removeClass(selector, myClass) {

  // get all elements that match our selector
  elements = document.querySelectorAll(selector);

  // remove class from all chosen elements
  for (var i=0; i<elements.length; i++) {
    elements[i].classList.remove(myClass);
  }
}

// usage examples:
removeClass('.class-selector', 'example-class');
removeClass('#id-selector', 'example-class');

Conclusion

We’ve covered how to add and remove classes through className (the compatible way) and classList (the more modern way).

When you can control CSS classes through JavaScript, you unlock a lot of functionality including content display updates, animations, error messages, dialogs, menus, and more.

I hope this article has been helpful, and if you have any questions or thoughts, please feel free to share them in the comments.

Frequently Asked Questions (FAQs) on Adding and Removing CSS Classes with Vanilla JS

What is the purpose of adding or removing CSS classes using Vanilla JS?

The primary purpose of adding or removing CSS classes using Vanilla JS is to manipulate the appearance and behavior of HTML elements dynamically. By adding or removing CSS classes, you can change the style of an element, hide or show elements, animate elements, and much more. This is particularly useful in creating interactive web pages where the appearance of elements changes in response to user actions or other events.

How can I add multiple classes using classList.add()?

The classList.add() method allows you to add multiple classes to an element. You simply need to pass the class names as separate arguments. Here’s an example:
element.classList.add("class1", "class2", "class3");
This will add class1, class2, and class3 to the element.

Can I remove a class that does not exist on an element?

Yes, you can. The classList.remove() method will not throw an error if you try to remove a class that does not exist on an element. It will simply do nothing.

How can I check if an element has a specific class?

You can use the classList.contains() method to check if an element has a specific class. This method returns a boolean value – true if the class exists, and false if it doesn’t. Here’s an example:
if (element.classList.contains("myClass")) {
// do something
}

Can I add or remove classes to/from multiple elements at once?

Yes, you can. You would need to select all the elements you want to manipulate, loop through them, and add or remove the class for each one. Here’s an example using the querySelectorAll() method to select multiple elements and a forEach loop to add a class to each one:
document.querySelectorAll(".myElements").forEach(function(element) {
element.classList.add("myClass");
});

How can I toggle a class on an element?

The classList.toggle() method allows you to toggle a class on an element. If the element already has the class, it will be removed. If it doesn’t have the class, it will be added. Here’s an example:
element.classList.toggle("myClass");

What is the difference between className and classList?

className is a property that gets or sets the class attribute of an element as a string. classList, on the other hand, is a read-only property that returns a live DOMTokenList collection of the class attributes of the element, providing methods to manipulate classes.

Can I use classList with SVG elements?

Yes, you can. The classList property is applicable to SVG elements as well, allowing you to add, remove, and toggle classes on SVG elements just like on HTML elements.

Is classList supported in all browsers?

The classList property is widely supported in all modern browsers. However, it is not supported in Internet Explorer 9 and earlier versions.

Can I chain classList methods?

Yes, you can. The classList methods return the classList object, allowing you to chain methods. Here’s an example:
element.classList.remove("oldClass").add("newClass");
This will remove oldClass and add newClass in a single line of code.

Yaphi BerhanuYaphi Berhanu
View Author

Yaphi Berhanu is a web developer who loves helping people boost their coding skills. He writes tips and tricks at http://simplestepscode.com. In his completely unbiased opinion, he suggests checking it out.

css classesJS Quick Tipsvanilla javascript
Share this article
Read Next
Get the freshest news and resources for developers, designers and digital creators in your inbox each week