Руководство

Игра на память на JavaScript: как устроен исходный код

Перемешанные пары, трёхсостоятельная блокировка переворота, проверка совпадения и условие победы в коротких фрагментах, плюс то, что добавляет готовый шаблон.

Панда Polarzinho переворачивает карточку на сетке карточек памяти, открыты пары льва и жирафа, над ними плавают скобки кода

Игре на память на JavaScript нужны четыре вещи: перемешанная колода, в которой каждый символ встречается дважды; конечный автомат переворотов с тремя состояниями (ни одна карточка не открыта, одна открыта, две открыты и поле заблокировано); проверка, которая оставляет совпавшие пары открытыми; и условие победы, которое срабатывает, когда пар не осталось. Всё остальное, от таймера до анимации переворота, — это подача поверх этих четырёх частей.

Ниже к каждой части идут короткие фрагменты на чистом JavaScript, написанные специально для этой статьи: это учебные примеры, а не код внутри наших шаблонов. Затем посмотрим, что добавляет готовая игра и когда покупка исходного кода игры на память быстрее.

Четыре части игры на память на JavaScript

Соберите колоду из пар

Продублируйте каждый уникальный символ и дайте каждой карточке свой ключ. Для symbols = ['owl', 'fox', 'cat', 'bee'] эта строка даёт восемь карточек: const deck = symbols.flatMap((s) => [s, s]).map((symbol, i) => ({ key: i, symbol, open: false, matched: false })); Сравнивайте symbol, чтобы найти пару, а key используйте, чтобы связать каждую карточку с её элементом на странице.

Перемешивайте алгоритмом Fisher-Yates, а не через sort

Популярный deck.sort(() => Math.random() - 0.5) смещён. Сортировка ждёт согласованных сравнений, поэтому случайные ответы делают одни порядки намного вероятнее других, и величина перекоса зависит от браузера. Fisher-Yates идёт с конца и меняет каждый элемент местами с случайной позицией, стоящей на нём или раньше, что даёт каждому порядку одинаковый шанс:

for (let i = deck.length - 1; i > 0; i--) { const j = Math.floor(Math.random() * (i + 1)); [deck[i], deck[j]] = [deck[j], deck[i]]; }

Часть i + 1 важна: j должен мочь равняться i, иначе ни одна карточка никогда не останется на месте.

Блокировка переворота: три состояния

В каждой первой версии есть ошибка с третьей карточкой: две карточки не совпали, и до того как они закроются, игрок нажимает третью. Две переменные это исправляют: first хранит открытую карточку, а lock равна true, пока несовпавшая пара ждёт закрытия. Так получаются три состояния: ни одна карточка не открыта (first равно null), одна открыта (first задано), две открыты (lock равна true). Обработчик клика:

  1. Игнорируйте нажатия, пока поле заблокировано или карточка открыта: if (lock || card.open) return;
  2. Откройте карточку. Если она первая, запомните её и остановитесь: card.open = true; if (!first) { first = card; return; }
  3. Это вторая карточка, значит, засчитайте ход: moves++;
  4. При совпадении оставьте обе открытыми: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
  5. Иначе заблокируйте поле и закройте обе после паузы: lock = true; const a = first; first = null; setTimeout(() => { a.open = card.open = false; lock = false; render(); }, 800);
  6. После совпадения проверьте победу: if (pairsLeft === 0) showWin(moves, seconds());

Скопируйте first в a до очистки, потому что таймер сработает через 800 миллисекунд, когда first уже должен быть свободен. В начале игры задайте pairsLeft = symbols.length и вызывайте render() после каждого изменения.

Ходы, время, анимация переворота и доступность

Ходы и время

Засчитывайте ход только на второй карточке. Запускайте часы на первом перевороте, а не при загрузке страницы: let start = null; затем start ??= performance.now(); внутри обработчика клика и const seconds = () => Math.round((performance.now() - start) / 1000); для чтения. Браузеры замедляют таймеры во фоновых вкладках, поэтому если добавлять по одной секунде на каждый тик setInterval, время уплывёт, а отметки времени остаются верными.

3D-переворот в CSS в двух строках

Два правила делают переворот: .card { transition: transform 0.4s; transform-style: preserve-3d; } и .card.open { transform: rotateY(180deg); } Дайте обеим сторонам backface-visibility: hidden, начните лицевую сторону с transform: rotateY(180deg) и добавьте perspective: 800px к полю. Для игроков, которые отключили анимации: @media (prefers-reduced-motion: reduce) { .card { transition: none; } }

Клавиатура и программы чтения с экрана

  • Сделайте каждую карточку <button>: Tab, Enter и Space тогда работают без лишнего кода.
  • Меняйте подпись вместе с карточкой: aria-label="Карточка 5, закрыта", пока она скрыта, затем "Карточка 5, сова".
  • Отключайте совпавшие карточки атрибутом disabled, чтобы они выпали из порядка табуляции.
  • Объявляйте «Pair found» или «No match» в живой области, например в <p aria-live="polite">.
  • Не полагайтесь на цвет: используйте символы разной формы и отмечайте совпадения контуром или галочкой.

Что занимает выходные, а что недели

Всё сказанное выше умещается в выходные, тесты включены. Игра, которую можно отдать игрокам или клиенту, делается неделями, потому что основная работа лежит вокруг цикла:

  • Уровни и кривая сложности, настроенные плейтестами.
  • Единый стиль графики для лицевых сторон карточек, рубашек, фонов и интерфейса, чёткий на плотных экранах.
  • Анимация и обратная связь: эффекты пар, комбо, экраны победы и поражения.
  • Сохранения, которые переживают отсутствующую или повреждённую запись.
  • Языки, с вёрсткой, которая вмещает длинные слова.
  • Зоны касания, портретная и альбомная ориентация, маленькие экраны.
  • Переключатели музыки и звука, которые игра запоминает.
  • Тестирование во всех браузерах и на всех устройствах, которые вы поддерживаете.
Fireflip, уровень 5: двенадцать карточек-фонариков на деревянном мосту, над полем всплывает +250, а светлячок Flick радуется: “Lucky!”
Fireflip, Firefly Village: найденная пара загорается, сбоку способности Peek и Beacon.

Исходный код игры на память, который можно купить: четыре шаблона Polar

Мы продаём четыре готовые игры на память как HTML5-шаблоны с одинаковой структурой и разными темами. На момент написания каждая в версии 1.0.0 и стоит 49 долларов США.

  • Memory Mansion: уютный хеллоуинский дом с привидениями, никогда не страшный. Wisp, маленький призрак, способности Peek и Candle, 60 Spookies для сбора.
  • Jinglewood Memory: рождественская деревня с карточками-бирками. Олень Tinsel, способности Peek и North Star, 60 Snowpals.
  • Safari Memory: деревянные карточки сафари и детёныши животных. Суриката Kiko, способности Peek и Compass, 60 Safari Pals.
  • Fireflip: карточки-фонарики в сказочной деревне. Светлячок Flick, способности Peek и Beacon, 60 Glimmers.
Memory Mansion, уровень 8: поле из 20 карточек в зале с привидениями, совпавшие пары открыты, слева призрак Wisp, справа кнопки Peek и Candle.
Memory Mansion, Moonlit Manor: найденные пары остаются открытыми и светятся, сбоку способности Peek и Candle.

Что есть во всех четырёх

  • 60 уровней в 5 мирах, у каждого своя карта уровня и новое правило: запросы в пузыре, карточки, которые держатся, пока не совпадёт пара рядом, порыв, который меняет две карточки местами, и персонажи, которые совпадают со своей тенью.
  • Лимит ходов и до трёх звёзд за уровень, сундук с наградой каждые 9 звёзд, спасение +5 ходов, альбом Collection и Daily-поле с календарём и серией.
  • Две способности: Peek показывает все карточки на мгновение, а вторая показывает, где находится пара карточки.
  • 14 языков интерфейса, на телефонах, планшетах и компьютерах, в портретной или альбомной ориентации.
  • HTML5, Canvas 2D и Web Audio в читаемых JavaScript-модулях и CSS, без зависимостей, без этапа сборки и с тестами правил. Файлы: HTML, CSS, JavaScript, PNG, WebP, MP3 и WOFF2, с готовой папкой game/ для размещения.
  • Иллюстрированное офлайн-руководство для покупателя на английском, португальском и испанском, плюс пошаговое руководство по кастомизации.
Jinglewood Memory, уровень 30: поле из 20 карточек в заснеженном лесу, одна карточка заморожена в блоке льда под замком.
Jinglewood Memory, Frosted Forest: карточки во льду тают бесплатно, когда совпадает пара рядом с ними.

Что легко поменять

CUSTOMIZATION.html показывает, какой файл рисует каждую часть каждого экрана, как заменить картинки карточек, рубашки, фоны и талисмана, а также где лежат уровни, способности, награды и тексты. Талисман, Daily-поле и Collection выключаются в одном файле конфигурации; имена персонажей лежат в одном файле набора карточек, для переименования или перевода.

Цена, пакеты и ограничения

Скидки за комплект действуют на каждую лицензию в заказе: 5% за два шаблона, 10% за три, 15% за четыре и 20% за пять и более. Акции действуют только в том виде, в каком показаны при оформлении. Издания не включают нативные приложения, хостинг, разработку под заказ, онлайн-мультиплеер, онлайн-рейтинг, покупки в приложении и рекламный SDK. Прогресс сохраняется в браузере игрока.

Чеклист покупателя

  1. Сыграйте в демо на телефонах и компьютерах, которыми пользуются ваши игроки, в обеих ориентациях.
  2. Проверьте, что онлайн-документация покрывает то, что вы планируете менять.
  3. Сначала выберите тему: замена графики — меньшая работа, чем изменение правил.
  4. Убедитесь, что 14 языков интерфейса подходят вашей аудитории.
  5. Выберите итоговый адрес до запуска: сохранения в браузере привязаны к адресу сайта.
  6. Считайте конечные продукты: одна лицензия покрывает один.
Safari Memory, уровень 57: карточки в непрямоугольной раскладке на саванне ночью, включая тёмную карточку-силуэт, которая образует пару со своим животным.
Safari Memory, Starry Plains: совместите каждого Safari Pal с его тенью.

Посмотреть все HTML5-шаблоны головоломок

Часто задаваемые вопросы

Можно ли поменять картинки карточек?

Да. Руководство по кастомизации в каждом пакете показывает, как заменить картинки карточек, рубашки, фоны и талисмана.

Нужен ли сервер?

Только статический хостинг. Загрузите содержимое game/ на любой HTTP(S)-хост; база данных или авторский аккаунт не нужны.

Можно ли использовать её для клиента?

Да. Каждая покупка — бессрочная неисключительная лицензия на один конечный продукт, ваш или одного клиента, и белая метка разрешена. Перепродавать или передавать сам шаблон или его код по отдельности нельзя.

Какая поддержка входит?

Шесть месяцев с даты покупки или 12 при продлении, которое выбирается при оформлении. Кастомизация и новые функции оцениваются отдельно.

Взяты ли фрагменты из этой статьи из шаблонов?

Нет. Это короткие примеры, написанные для этого руководства. У каждого шаблона своя структура, описанная в его документации.

Написать самому или купить?

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

Memory Mansion: игра на память на Хеллоуин, демо и лицензия

Jinglewood Memory: рождественская игра на память, демо и лицензия

Safari Memory: игра на память с животными сафари, демо и лицензия

Fireflip: игра на память в сказочной тематике, демо и лицензия

Как купить HTML5-игры для своего сайта

Нужны изменения или несколько лицензий? Запросите смету