9.1. Зачем управлять страницей из кода

В уроке 8 кнопка уже реагировала на клик: срабатывал обработчик, число кликов увеличивалось и уже показывалось на странице в блоке #clickCount. Но, кроме этого числа, на странице ничего не менялось. В уроке 9 страница начинает меняться целиком — появляются сообщение, уровень, блок статистики и класс кнопки.

Пора двигаться дальше. К концу урока на странице появятся сообщение о заклинании и блок статистики со счётчиком и уровнем магии — и всё это будет меняться прямо во время игры. Для этого нужно научиться трём вещам: находить элемент, менять его содержимое и оформление, создавать новые.

Инструмент для всего этого один — DOM. За словом стоит простая идея: браузер превращает текст разметки в набор объектов, с которыми JavaScript умеет работать. Пока ты не умел к ним обращаться, страница была для кода закрытой книгой.

9.2. DOM: страница как дерево

DOM расшифровывается как Document Object Model — «объектная модель документа». Прочитав HTML, браузер строит из тегов дерево: каждый тег становится узлом, а вложенные теги — его детьми. Главный узел — document, внутри него html, дальше head и body и так до самой глубокой кнопки.

Для нашей игры дерево выглядит примерно так:

document
└── html
    ├── head
    │   └── title
    └── body
        └── div.game-container
            ├── h1
            ├── button#magicButton
            ├── p#magicMessage
            └── div.stats
                ├── div.stat-item
                │   └── div.click-count#clickCount
                └── div.stat-item
                    └── span#magicLevel

Каждый узел — это объект: у него есть свойства (текст, класс, стиль) и команды (добавить класс, удалить себя). Работа с DOM — это и есть вызов таких свойств и команд. Дерево удобно тем, что элемент помнит своих детей и родителя.

DOM — это не файл Файл на диске — текст, а DOM — то, что браузер построил из него и держит в памяти. Если файл исправить, DOM сам не изменится: страницу нужно обновить.

9.3. Как увидеть DOM в DevTools

Дерево не нужно представлять в уме — его видно. Открой страницу, нажми F12 и перейди на вкладку Elements (в некоторых браузерах — «Элементы» или «Инспектор»): там та же разметка, что в файле, только свёрнутая в дерево.

Здесь же легко проверить себя: если в дереве у кнопки id="magicBtn", а в скрипте ты ищешь magicButton, код ничего не найдёт и ошибки не покажет.

Правки в Elements не сохраняются Изменения в панели Elements живут только до обновления страницы — файл на диске остаётся прежним. Настоящие правки делают в редакторе.

9.4. Как код находит элемент

Вход в дерево — объект document: он существует с момента загрузки страницы, и через него код ищет элементы. В уроке 8 мы уже пользовались document.getElementById("magicButton") — поиском по id.

При этом id и class получили вторую работу: в уроках 4–6 они были нужны только для CSS, а теперь по ним JavaScript находит элементы. Поэтому id должен быть уникальным, а класс описывает группу похожих элементов.

<button class="magic-button" id="magicButton">✨ МАГИЯ! ✨</button>

<p class="magic-message" id="magicMessage">Нажми на кнопку, чтобы увидеть волшебство!</p>

<div class="stats">
  ...
</div>

Здесь magicButton и magicMessage — имена для поиска, а magic-button и stats — классы для оформления. Один элемент может иметь и то, и другое.

9.5. querySelector: поиск по CSS-селектору

Второй способ — querySelector. В скобках ему передают селектор, ту же запись, что и в CSS. Самые нужные:

const button = document.querySelector("#magicButton");
const message = document.querySelector("#magicMessage");
const stats = document.querySelector(".stats");

console.log(button);
console.log(message);
console.log(stats);

querySelector возвращает первый подходящий элемент. Если их несколько, остальные он не вернёт — для них есть другой способ, о котором ниже. Удобство в том, что запись селектора ровно такая же, как в CSS.

9.6. querySelectorAll: когда элементов несколько

В блоке статистики два одинаковых элемента .stat-item. Чтобы обратиться ко всем сразу, используют querySelectorAll: он возвращает список найденных элементов, по которому можно пройти циклом.

const items = document.querySelectorAll(".stat-item");

console.log(items.length);   // сколько элементов нашлось

items.forEach(function (item) {
  item.classList.add("stat-item-light");
});

console.log(items[0].textContent);   // текст первого элемента

У списка есть длина length и метод forEach: он по очереди передаёт каждый элемент в функцию, которая с ним что-то делает. К отдельному элементу можно обратиться по номеру: items[0] — первый. Нумерация начинается с нуля.

9.7. Если элемент не найден: null

Что будет, если элемента с таким селектором нет? querySelector не выдумывает его и не выбрасывает ошибку сразу — он возвращает особое значение null, то есть «ничего не найдено»:

const message = document.querySelector("#magicMesage");   // опечатка в id
console.log(message);   // null

Само по себе null — не беда. Беда начинается на следующей строке: если попробовать обратиться к свойству несуществующего элемента, браузер остановит скрипт и напишет ошибку вида TypeError: Cannot set properties of null.

Опечатка в id — самая частая причина Если код «не работает», а ошибка говорит про null, сравни посимвольно имя в селекторе и имя в разметке: magicMessage и magicMesage — разные имена. Второй случай — скрипт стоит раньше элемента; об этом в конце урока. Подробный разбор ошибок — в уроке 12.

9.8. textContent: текст элемента

Когда элемент найден, у него можно прочитать или заменить текст. За это отвечает свойство textContent. Читать его можно как обычное значение, а записывать — через знак равенства, как в переменную.

const message = document.querySelector("#magicMessage");

console.log(message.textContent);   // что написано сейчас

message.textContent = "✨ Заклинание сработало!";

console.log(message.textContent);   // что написано после замены

Присваивание заменяет всё содержимое элемента целиком. Если приклеить к строке число, получится «Заклинание №3 сработало» — так же, как мы склеивали строки в уроке 7, только результат виден не в консоли, а на странице.

Нажми на кнопку — текст изменится.
Каждый клик записывает в элемент новую строку через textContent. Сам элемент остаётся тем же — меняется только его содержимое.

9.9. innerHTML: разметка внутри элемента

У элемента есть ещё одно свойство — innerHTML. textContent вставляет символы как текст, а innerHTML сначала разбирает строку как разметку и только потом вставляет результат:

// текст: теги будут видны как обычные символы
message.textContent = "<strong>Магия!</strong>";

// разметка: слово станет жирным
message.innerHTML = "<strong>Магия!</strong>";

В первом случае появится строка с угловыми скобками, во втором — жирное слово «Магия». Отсюда правило: обычный текст — textContent, разметка, которую ты написал сам, — innerHTML. И никогда не передавай в innerHTML то, что ввёл пользователь: чужие теги могут сломать страницу. В нашей игре хватает textContent.

9.10. classList: add, remove, toggle, contains

Классы мы до сих пор писали только в разметке. Из кода их меняет classList — набор команд, привязанный к элементу. Команд четыре:

button.classList.add("magic-active");       // добавить класс
button.classList.remove("magic-active");    // убрать класс
button.classList.toggle("magic-glow");      // включить, если нет; выключить, если есть
button.classList.contains("magic-active");  // проверить: true или false

Не нужно возиться со строкой классов вручную: add не добавит класс второй раз, remove не сломается, если класса не было, а toggle по очереди включает и выключает класс. contains ничего не меняет, а только отвечает на вопрос.

И ещё одно: класс сам по себе ничего не делает — он меняет вид элемента только тогда, когда для него написано правило в CSS. Поэтому в проекте появится правило для класса magic-active.

Карточка с классом
Класс demo-pulse включает покачивание
contains("demo-pulse") → false

9.11. element.style: оформление из кода

Отдельные свойства оформления можно задать напрямую — через style. Запись похожа на CSS, но с двумя отличиями: дефис из названия убирается, а бывшая вторая часть пишется с заглавной буквы; размеры задаются строкой вместе с единицами измерения.

message.style.color = "#ffeb3b";
counter.style.fontSize = "36px";
counter.style.marginTop = "10px";
level.style.letterSpacing = "1px";

В CSS ты писал font-size, а в коде пишешь fontSize. Так же background-color становится backgroundColor. Размеры указывают строкой с единицами: "36px", а не 36. Для безразмерных свойств подходит число: style.opacity = 1.

Есть и setAttribute — он задаёт любой атрибут HTML:

button.setAttribute("title", "Нажми и получи заклинание");
console.log(button.getAttribute("title"));
Класс или style? Если оформление постоянное — пиши правило в CSS и переключай класс. Если значение зависит от данных (например, размер числа кликов), удобнее style. Десять строк style подряд читать труднее, чем одно правило в CSS.

9.12. Создание и удаление элементов

До сих пор мы работали с элементами из разметки. Но код умеет создавать новые: сначала элемент создаётся в памяти, потом вставляется на страницу. Пока не вставлен — его никто не увидит.

const note = document.createElement("p");     // создать абзац в памяти
note.textContent = "Новое заклинание";        // заполнить текстом
note.classList.add("stat-item");              // добавить класс

document.querySelector(".stats").appendChild(note);   // вставить на страницу

note.remove();                                // убрать со страницы

createElement принимает имя тега и возвращает пустой элемент. appendChild вызывается у родителя и вставляет элемент последним ребёнком. remove вызывается у самого элемента и убирает его из дерева; переменная note остаётся, но элемента на странице уже нет.

Обрати внимание на порядок: createElement сам по себе ничего не показывает, элемент появляется только после appendChild. А remove работает с уже вставленным элементом, поэтому вызывать его нужно после вставки. Именно так в практикуме появится строка «Последнее заклинание», а в уроке 11 — искры, которые исчезают сами.

9.13. Порядок в файле и новый код проекта

Есть правило, без которого всё предыдущее не работает: скрипт должен выполняться после того, как разметка загружена. Браузер читает файл сверху вниз, поэтому скрипт в head выполнится, когда body ещё пуст, и любой querySelector вернёт null. В уроке 7 мы поставили скрипт в конец body — после всех элементов.

Скрипт раньше разметки Если перенести <script> в head, игра перестанет работать: код ищет кнопку, которой ещё нет. Ошибка будет та же — Cannot read properties of null (reading 'addEventListener'). Место скрипта — не мелочь.

В разметку добавляется сообщение, а прежний блок #clickCount из урока 8 заменяется новым блоком статистики:

<p class="magic-message" id="magicMessage">Нажми на кнопку, чтобы увидеть волшебство!</p>

<div class="stats">
  <div class="stat-item">
    Количество заклинаний:
    <div class="click-count" id="clickCount">0</div>
  </div>
  <div class="stat-item">
    Уровень магии: <span id="magicLevel">Начинающий волшебник</span>
  </div>
</div>

А в скрипт — четыре найденных элемента и обновление их содержимого по клику. Функция magicClick остаётся: мы её только дополняем.

const button = document.querySelector("#magicButton");
const message = document.querySelector("#magicMessage");
const counter = document.querySelector("#clickCount");
const level = document.querySelector("#magicLevel");

let clicks = 0;

function magicClick() {
  clicks = clicks + 1;

  counter.textContent = clicks;
  message.textContent = "✨ Заклинание №" + clicks + " сработало!";
  level.textContent = "Уровень: " + clicks;

  counter.style.fontSize = (20 + clicks) + "px";
  button.classList.add("magic-active");
}

button.addEventListener("click", magicClick);

Разберём главное. counter.textContent = clicks выводит число на страницу, сообщение собирается из строки и числа. Уровень пока просто число: настоящие названия появятся в уроке 10. Размер числа растёт с каждым кликом — временный эффект. Класс magic-active добавляется один раз и остаётся на кнопке, а чтобы он что-то менял, в <style> нужно правило:

.magic-button.magic-active {
  background: linear-gradient(135deg, #22c55e, #16a34a);
  box-shadow: 0 12px 28px rgba(34, 197, 94, 0.45);
}

Запись .magic-button.magic-active означает «элемент, у которого есть оба класса сразу». Пока класс не добавлен кодом, правило не действует.

9.14. Итог урока

Страница перестала быть неподвижной: код нашёл элементы, поменял их текст, добавил класс и даже создал новые элементы. Всё это — работа с DOM, и устроена она одинаково для любой страницы.

Главный вывод урока DOM — это мост между разметкой и кодом. Пока ты помнишь цепочку «селектор находит элемент → свойство меняет его», любое изменение страницы сводится к одной строке кода: найти нужный объект и записать в него новое значение.