База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Element.className — прочитане и замяна на класове

При HTML елемент свойството `className` позволява да се прочете или замени стойността на атрибута `class`. Тази стойност е низ, а не масив от класове. Свойството `SVGElement.className` е само за четене и връща обект `SVGAnimatedString`.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

// For an HTML element:
element.className
element.className = "class1 class2";

Element.className отразява атрибута class. При HTML елемент прочитането връща стойността на атрибута като низ; ако атрибутът липсва, връща "".

При HTML елемент присвояването element.className = "card selected" задава цялата стойност на атрибута. Следващо присвояване заменя предишните класове, вместо да добави нов. Разделяйте имената на класовете с празни знаци от набора ASCII, а не със запетаи. Неразривният интервал (U+00A0) остава част от едно име на клас, вместо да разделя две имена.

Свойството SVGElement.className е само за четене и връща обект SVGAnimatedString, а не низ.

Използвайте className, когато искате да замените целия набор от класове на HTML елемент. За операции с отделни класове използвайте element.classList, който предоставя DOMTokenList. Това е API на DOM, а не функция на езика ECMAScript.

Примери

const element = document.createElement("div");
console.log(JSON.stringify(element.className));
element.className = "card selected";
console.log(element.getAttribute("class"));
element.className = "compact";
console.log(element.className);

Резултат

""
card selected
compact

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници