addClassToElement

یک نام کلاس CSS را به عنصر DOM مشخصی می‌افزاید.

API

addClassToElement

بازگشت

بدون مقدار بازگشتی (void)

پارامترها

پارامتر	توضیح	نوع	پیش‌فرض
`element`	عنصر DOM	`Element`	الزامی
`addClass`	نام کلاسی که افزوده می‌شود	`string`	الزامی

نمونه

کاربرد پایه

import { addClassToElement } from 'ranuts';

const element = document.getElementById('myElement');
addClassToElement(element, 'active');
// حالا element کلاس 'active' را دارد

پرهیز از افزودن تکراری

import { addClassToElement } from 'ranuts';

const element = document.querySelector('.button');
addClassToElement(element, 'highlighted');
addClassToElement(element, 'highlighted'); // تکراری افزوده نمی‌شود

ایمنی سمت سرور

import { addClassToElement } from 'ranuts';

// در محیط سمت سرور خطا پرتاب نمی‌کند و بی‌صدا رد می‌شود
addClassToElement(element, 'class-name'); // سمت سرور: هیچ کاری نمی‌کند

یادداشت‌ها

بررسی تکرار: اگر عنصر آن کلاس را داشته باشد، دوباره افزوده نمی‌شود.
ایمنی سمت سرور: در محیط سرور (بدون شیء document) بی‌صدا و بدون پرتاب خطا رفتار می‌کند.
از classList استفاده می‌کند: از classList.add() امروزی بهره می‌برد که از دستکاری مستقیم className ایمن‌تر است.