Почему в React используют className вместо class
На этой странице
React DOM называет props встроенных элементов по именам свойств DOM API, а не по HTML-атрибутам: у DOM-элемента свойство называется element.className, поэтому в JSX пишут className, а React при рендере выставляет HTML-атрибут class. Так же устроены htmlFor (атрибут for), tabIndex, readOnly. Историческая причина — в старом JavaScript (ES3) зарезервированные слова class и for нельзя было использовать как имена свойств объектов, а props — это объект; DOM API по той же причине назвал свойство className. В современном JS { class: "card" } — валидный код, но соглашение React осталось. Если написать class, React DOM выведет атрибут, но предупредит в консоли.
Вопрос
Почему в JSX пишут className, а не class? Какие ещё атрибуты называются иначе, чем в HTML?
Откуда берётся имя
// DOM API: HTML-атрибут class доступен через свойство className
const el = document.querySelector("section");
el.className = "preview dark"; // свойство
el.getAttribute("class"); // "preview dark" — атрибут
// JSX компилируется в объект props
jsx("section", { className: "preview dark" })
// React DOM переводит prop className → атрибут class в HTMLJSX: className="card" → props: { className: "card" } → DOM: <div class="card">Пример: класс зависит от состояния
import { useState } from "react";
export default function ThemePreview() {
const [isDark, setIsDark] = useState(false);
return (
<section className={isDark ? "preview dark" : "preview light"}>
<label htmlFor="dark-mode">Тёмная тема</label>
<input
id="dark-mode"
type="checkbox"
checked={isDark}
onChange={(event) => setIsDark(event.currentTarget.checked)}
/>
<p>Пример текста.</p>
</section>
);
}<!-- Итог в браузере после переключения -->
<section class="preview dark">
<label for="dark-mode">Тёмная тема</label>
...
</section>Таблица соответствий
| HTML | JSX (React DOM) | Почему |
|---|---|---|
class | className | Имя DOM-свойства |
for (у label) | htmlFor | Имя DOM-свойства |
tabindex | tabIndex | camelCase DOM-свойства |
readonly, maxlength | readOnly, maxLength | camelCase |
onclick | onClick | События React в camelCase |
aria-label | aria-label | Исключение: как в HTML |
data-id | data-id | Исключение: как в HTML |
style="…" | style={{ … }} | Объект, свойства в camelCase |
Несколько и условные классы
// Строка с пробелами
<button className="btn btn-primary">Купить</button>
// Условия — шаблонной строкой
<button className={`btn ${isActive ? "btn-active" : ""}`}>…</button>
// Удобнее — утилита clsx (или classnames)
import clsx from "clsx";
<button className={clsx("btn", isActive && "btn-active", { "btn-disabled": disabled })}>…</button>
// CSS Modules
import styles from "./Button.module.css";
<button className={clsx(styles.button, isActive && styles.active)}>…</button>Массив напрямую передавать нельзя: className={["a", "b"]} превратится в строку "a,b".
className у своего компонента
// ✗ Класс никуда не попадёт: компонент его не использует
function Card({ title }) {
return <article><h2>{title}</h2></article>;
}
<Card title="React" className="featured" />
// ✓ Компонент принимает className и передаёт на корневой элемент
function Card({ title, className }) {
return (
<article className={clsx("card", className)}>
<h2>{title}</h2>
</article>
);
}className у собственного компонента — обычный prop. Он работает, только если компонент сам передаст его DOM-элементу.
Что важно помнить
- React DOM использует имена DOM-свойств:
className,htmlFor,tabIndex. - Исторически это связано с запретом
class/forкак имён свойств в старом JS; сейчас это просто соглашение. aria-*иdata-*пишутся через дефис, как в HTML.- Для условных классов удобны
clsx/classnames. - Свой компонент должен явно прокинуть
classNameна элемент.
Мини-шпаргалка
- JSX
className="card"→ HTMLclass="card". htmlFor,tabIndex,readOnly,onClick— camelCase.aria-label,data-id— как в HTML.- Несколько классов — строка или
clsx(...).