8.1. Кнопка, которая пока молчит

В прошлом уроке в проекте появился JavaScript: переменная clicks, команда console.log и тег script в конце страницы. Скрипт запускается, выводит сообщение в консоль — но сама кнопка по-прежнему ничего не делает. Нажимаешь — и ничего не происходит.

Это не поломка. Кнопка нарисована в HTML, а переменная живёт в JavaScript. Пока между ними нет связи, браузер считает кнопку просто прямоугольником с текстом и даже не сообщает скрипту, что кто-то нажал.

Сегодня мы эту связь построим. В конце урока кнопка #magicButton будет считать клики: число увеличится и появится на странице.

8.2. Что такое событие

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

Браузер замечает такие действия постоянно, даже без JavaScript. Событие — это факт: «вот здесь произошёл клик». Реагировать на него или нет, решает программа.

У каждого события есть имя. В коде оно записывается строкой в кавычках. Самые частые:

Нас интересует 'click': оно возникает, когда пользователь нажимает на кнопку и отпускает кнопку мыши над ней. Имя пишется маленькими латинскими буквами и в кавычках. Click или 'onclick' — уже не то имя, браузер такое событие не узнает.

8.3. Обработчик — это функция

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

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

function magicClick() {
  console.log('Кнопка нажата!');
}

В этом примере есть имя magicClick, пустые скобки и тело в фигурных скобках. Никакого вывода в консоль пока не произойдёт: мы только описали действие. Консольное сообщение появится в тот момент, когда функция будет вызвана — например, по клику.

Функция — это инструкция, а не результат Объявление функции похоже на записку «когда попросят, сделай вот это». Записка сама ничего не делает: действие начинается после вызова magicClick() или по клику, если функция назначена обработчиком.

8.4. Объявление функции и её вызов

Разберём два действия, которые новички часто путают. Объявить функцию — описать её и дать имя. Вызвать функцию — заставить её выполниться прямо сейчас.

function magicClick() {
  console.log('Клик!');
}

magicClick();

Здесь сверху функция объявлена, а снизу вызвана. Если убрать последнюю строку, в консоли будет пусто. Если оставить только вызов без объявления, браузер выдаст ошибку: magicClick is not defined — «такой функции нет».

Разница видна по скобкам. Запись magicClick без скобок означает саму функцию: её можно передать, сохранить в переменную, отдать браузеру. Запись magicClick() со скобками означает «выполни её немедленно». Для обработчика нужна именно первая форма: браузер сам решит, когда её запускать.

8.5. Как передать функцию, а не её результат

Теперь главная ловушка урока. Чтобы назначить обработчик, функцию передают по имени, без скобок:

button.addEventListener('click', magicClick);

Если случайно добавить скобки, произойдёт совсем другое:

button.addEventListener('click', magicClick());

Во второй строке браузер видит magicClick() и сразу вызывает функцию — ещё при загрузке страницы, до всякого клика. Функция выполняется и возвращает undefined, потому что return в ней нет. Именно это значение попадает в addEventListener вместо обработчика: функция вызовется сразу, а клики останутся без реакции.

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

Самая частая ошибка урока addEventListener('click', magicClick()) — вызов вместо функции. Функция сработает один раз при загрузке страницы, а клики перестанут работать. Правильно: addEventListener('click', magicClick) — без скобок.

8.6. Находим кнопку по id

Прежде чем назначать обработчик, скрипт должен понять, о какой именно кнопке речь. На странице может быть несколько кнопок, и клик по каждой должен обрабатываться по-своему. Помогает id — уникальное имя элемента, которое мы задали ещё в уроке 3:

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

Из JavaScript элемент ищут так:

const button = document.getElementById('magicButton');

Разберём по частям. document — главный объект страницы. getElementById — команда «найди элемент по id». В скобках — строка с именем id, без решётки: 'magicButton', а не '#magicButton'. Результат сохраняется в переменную button.

Имя в скрипте должно совпадать с именем в разметке символ в символ. magicButton и magicbutton — разные id: JavaScript различает большие и маленькие буквы. Если id не найден, команда вернёт null — особое значение «ничего нет». Тогда следующая строка с button.addEventListener выдаст ошибку.

8.7. Подписываемся на событие: addEventListener

Команда addEventListener переводится как «добавить слушателя события». Она говорит браузеру: «следи за этим элементом и, когда произойдёт такое-то событие, вызови такую-то функцию».

const button = document.getElementById('magicButton');

function magicClick() {
  console.log('Кнопка нажата!');
}

button.addEventListener('click', magicClick);

У команды два обязательных аргумента. Первый — имя события строкой: 'click'. Второй — функция-обработчик без скобок: magicClick. Между аргументами стоит запятая, после всей строки — точка с запятой.

Порядок строк в этом примере удобный, но не единственный: функцию можно объявить и до поиска кнопки. Важно другое — к моменту вызова addEventListener кнопка должна быть найдена, а функция — существовать. На один элемент можно повесить несколько обработчиков одного события: браузер вызовет их всех по порядку.

8.8. Что происходит по шагам

Соберём последовательность целиком, чтобы не потеряться в строках.

  1. Страница загружается, браузер строит разметку сверху вниз.
  2. Дойдя до конца body, браузер выполняет скрипт.
  3. Скрипт находит кнопку и объявляет функцию magicClick.
  4. addEventListener подписывает кнопку на событие 'click'.
  5. Скрипт заканчивается, страница ждёт действий пользователя.
  6. При клике браузер создаёт событие и вызывает подписанную функцию.

Обработчик не «срабатывает однажды»: он остаётся подписанным до конца жизни страницы, пока его не снимут. Сколько раз нажмёшь, столько раз функция и выполнится.

8.9. Счётчик: clicks = clicks + 1

Теперь вернёмся к переменной clicks из урока 7. Она хранит число нажатий. Начальное значение — ноль:

let clicks = 0;

При каждом клике число должно увеличиваться на единицу. Записывается это так:

clicks = clicks + 1;

Строка выполняется справа налево. Сначала JavaScript берёт текущее значение clicks, прибавляет единицу, а потом кладёт результат обратно в переменную. Был ноль — станет один; при следующем клике — два.

Короткая запись clicks += 1; делает то же самое. Ещё короче — clicks++;, но полная форма нагляднее: видно, что новое значение вычисляется из старого.

Добавим увеличение в обработчик:

function magicClick() {
  clicks = clicks + 1;
  console.log(clicks);
}

Обрати внимание: браузер сам ничего не считает. Счётчик — это наша переменная и наша строка сложения. Если убрать clicks = clicks + 1, функция будет выполняться, но число останется нулём. Если убрать только console.log, число продолжит расти, но мы этого не увидим.

8.10. Показываем число на странице

Консоль видит разработчик, а зрителю нужно число на экране. Добавим в разметку отдельный элемент с id clickCount. Это обычный HTML-блок, в нём пока стоит ноль:

<div class="game-container">
  <h1>Волшебная кнопка</h1>
  <p class="subtitle">Кликай и создавай магию!</p>
  <button class="magic-button" id="magicButton">✨ МАГИЯ! ✨</button>
  <div id="clickCount">0</div>
</div>

Найти этот блок из скрипта можно той же командой, что и кнопку:

const counter = document.getElementById('clickCount');

Осталось записать в него новое число. Для этого служит свойство textContent — «текстовое содержимое элемента». Присваивание заменяет весь текст внутри элемента на то, что стоит справа:

counter.textContent = clicks;

Обрати внимание: textContent заменяет текст целиком, а не добавляет новый. Если вызвать его дважды, останется только последнее значение. Для счётчика это и нужно: каждое новое число заменяет предыдущее.

Соберём полный скрипт. Замени им содержимое script из урока 7: clicks объявляется только один раз, иначе браузер сообщит о повторном объявлении переменной.

let clicks = 0;

const button = document.getElementById('magicButton');
const counter = document.getElementById('clickCount');

function magicClick() {
  clicks = clicks + 1;
  counter.textContent = clicks;
  console.log(`Кликов: ${clicks}`);
}

button.addEventListener('click', magicClick);

Вот живой счётчик, собранный по этому коду. Нажимай и следи за числом.

0

кликов

Счётчик ждёт первого клика

Счётчик работает на коде из урока: переменная, обработчик и textContent.
Переменная и экран — не одно и то же clicks хранит число в памяти, а counter.textContent выводит его на страницу. Обновишь только переменную — на экране останется старое значение. Обновишь только текст — следующий клик посчитает от старого числа. Нужны обе строки.

8.11. onclick в атрибуте и addEventListener

Есть и второй способ назначить обработчик — записать его прямо в HTML-атрибут onclick:

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

Работает это так же: по клику браузер вызовет magicClick. Но у атрибута есть ограничения.

Поэтому в проекте используем addEventListener: код поведения собран в одном месте, а разметка остаётся разметкой.

8.12. Порядок выполнения и место для скрипта

Браузер читает файл сверху вниз и выполняет JavaScript там, где встретил тег script. Поэтому к моменту поиска кнопки она уже должна быть построена.

Если поставить скрипт в head или в начало body, он выполнится раньше, чем браузер дойдёт до кнопки. getElementById вернёт null, а следующая строка выдаст ошибку:

Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')

Читается она так: «нельзя прочитать свойство addEventListener у значения null». Искать нужно не в JavaScript, а в порядке строк: элемент ещё не существует. Именно поэтому в уроке 7 мы поставили script в самый конец body, после всей разметки.

Внутри скрипта порядок тоже удобнее держать логичным: найти элементы, объявить функцию, подписаться на событие. Объявление функции JavaScript видит во всём скрипте, а элементы — только после того, как они появились в разметке.

Скрипт до кнопки Если в консоли появилась ошибка про null и addEventListener, первым делом проверь, где стоит script. Он должен быть в конце body, после кнопки и счётчика, а не в head.

8.13. Как снять обработчик

Иногда реакция нужна не всегда: например, после третьего клика счётчик должен остановиться. Для этого есть команда removeEventListener. У неё те же два аргумента, что и у addEventListener:

button.removeEventListener('click', magicClick);

Главное условие — передать ту же самую функцию, а не её копию и не вызов. Функция magicClick объявлена по имени, значит у браузера есть ссылка, по которой он узнаёт обработчик. Безымянную функцию снять нельзя: у неё нет имени, по которому её можно найти.

button.removeEventListener('click', magicClick);
console.log('Обработчик снят');

Если выполнить эти строки — например, из другого обработчика или из консоли, — кнопка отпишется от события. После этого клики по magicButton перестанут увеличивать счётчик.

Снимать нужно ту же функцию removeEventListener('click', magicClick) работает, а removeEventListener('click', magicClick()) — нет: скобки снова вызывают функцию, а не передают её. Имя без скобок — общее правило для обоих методов.

8.14. Итог урока

Кнопка в проекте ожила: она замечает клики, увеличивает счётчик и показывает новое значение. Это первый обработчик события в курсе, и устроен он так же, как в настоящих приложениях.

Главный вывод урока Интерактивность — это связка из трёх частей: событие, обработчик и элемент, который нужно изменить. Браузер сообщает о событии, вызывает функцию, а функция обновляет переменную и текст на странице. Запомнив эту цепочку, ты сможешь оживить любую кнопку.