addClassToElement

Add a CSS class name to a specified DOM element.

API

addClassToElement

Return

No return value (void)

Parameters

Parameter	Description	Type	Default
element	DOM element	Element	Required
addClass	Class name to add	string	Required

Example

Basic Usage

import { addClassToElement } from 'ranuts';

const element = document.getElementById('myElement');
addClassToElement(element, 'active');
// element now has 'active' class

Avoid Duplicate Addition

import { addClassToElement } from 'ranuts';

const element = document.querySelector('.button');
addClassToElement(element, 'highlighted');
addClassToElement(element, 'highlighted'); // Won't add duplicate

Server-Side Safety

import { addClassToElement } from 'ranuts';

// Won't throw error in server-side environment, fails silently
addClassToElement(element, 'class-name'); // Server-side: no operation

Notes

1. Duplicate check: If element already has the class name, won't add it again.
2. Server-side safety: In server-side environments (no document object), handles silently without throwing errors.
3. Uses classList: Uses modern classList.add() API, safer than directly manipulating className.