re:re:actable
Урок 073 минуты чтения

Почему в 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 в HTML
JSX: 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>

Таблица соответствий

HTMLJSX (React DOM)Почему
classclassNameИмя DOM-свойства
for (у label)htmlForИмя DOM-свойства
tabindextabIndexcamelCase DOM-свойства
readonly, maxlengthreadOnly, maxLengthcamelCase
onclickonClickСобытия React в camelCase
aria-labelaria-labelИсключение: как в HTML
data-iddata-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" → HTML class="card".
  • htmlFor, tabIndex, readOnly, onClick — camelCase.
  • aria-label, data-id — как в HTML.
  • Несколько классов — строка или clsx(...).

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам