addClassToElement

Acrescenta um nome de classe CSS a um elemento do DOM.

API

addClassToElement

Retorna

Sem valor de retorno (void)

Parâmetros

Parâmetro	Descrição	Tipo	Padrão
element	Elemento do DOM	Element	Obrigatório
addClass	Nome da classe a acrescentar	string	Obrigatório

Exemplo

Uso básico

import { addClassToElement } from 'ranuts';

const element = document.getElementById('myElement');
addClassToElement(element, 'active');
// agora element tem a classe 'active'

Evitar acrescentar duas vezes

import { addClassToElement } from 'ranuts';

const element = document.querySelector('.button');
addClassToElement(element, 'highlighted');
addClassToElement(element, 'highlighted'); // Não acrescenta em duplicidade

Segurança no servidor

import { addClassToElement } from 'ranuts';

// Num ambiente de servidor não lança erro: falha em silêncio
addClassToElement(element, 'class-name'); // No servidor: não faz nada

Notas

1. Checagem de duplicidade: se o elemento já tem a classe, ela não é acrescentada de novo.
2. Segurança no servidor: em ambientes de servidor (não há objeto document) age em silêncio, sem lançar erros.
3. Usa classList: emprega a API moderna classList.add(), mais segura do que mexer no className direto.