Посібник

Гра на пам'ять на 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 використовуйте, щоб прив'язати кожну картку до її елемента на сторінці.

Перемішуйте за Фішером–Єйтсом, а не через sort

Популярний deck.sort(() => Math.random() - 0.5) упереджений. Sort очікує послідовних порівнянь, тож випадкові відповіді роблять одні порядки значно імовірнішими за інші, і розмір цього перекосу залежить від браузера. Фішер–Єйтс іде з кінця і міняє кожен елемент з випадковою позицією на цій або попередній позиції, і тоді кожен порядок має однаковий шанс:

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 дає дрейф, тоді як позначки часу лишаються точними.

CSS-переворот 3D у два рядки

Переворот роблять два правила: .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, щоб вони вийшли з порядку табуляції.
  • Оголошуйте "Пару знайдено" або "Збігу немає" в live-регіоні, наприклад <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); база даних або обліковий запис автора не потрібні.

Чи можна використати її для клієнта?

Так. Кожна покупка — це безстрокова невиключна ліцензія на один кінцевий продукт, ваш або одного клієнта, і white label дозволено. Перепродавати або передавати шаблон чи його код окремо не можна.

Яка підтримка входить до пакета?

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

Чи взяті фрагменти з цієї статті з шаблонів?

Ні. Це короткі приклади, написані для цього гіду. Кожен шаблон має власну структуру, описану в його документації.

Створити чи купити?

Зробіть цикл самостійно, щоб навчитися або зробити прототип: фрагментів вище достатньо. Для запуску під клієнта чи сезонну дату шаблон дає рівні, арт, мови й тестування, а ваш час іде на брендинг і контент.

Memory Mansion: гра на пам'ять на Геловін, демо і ліцензія

Jinglewood Memory: різдвяна гра на пам'ять, демо і ліцензія

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

Fireflip: казкова гра на пам'ять, демо і ліцензія

Як купити HTML5-ігри для свого сайту

Потрібні зміни або кілька ліцензій? Попросіть пропозицію