Útmutató

Memória játék JavaScriptben: így működik a forráskód

Megkevert párok, háromállapotú fordítási zár, egyezésellenőrzés és győzelmi feltétel rövid kódrészletekben, plusz az, amit egy kész sablon hozzáad.

Polarzinho, a panda egy kártyát fordít meg a memóriakártyák rácsán, felfordítva egy-egy oroszlán- és zsiráfpár, fölöttük kódzárójelek lebegnek

A JavaScriptben működő memóriajátékhoz négy dolog kell: egy megkevert pakli, amelyben minden szimbólum kétszer szerepel, egy háromállapotú fordítási állapotgép (nincs kártya felfordítva, egy kártya fel van fordítva, két kártya fel van fordítva és a tábla zárva van), egy ellenőrzés, amely az egyező párokat nyitva tartja, és egy győzelmi feltétel, amely akkor lép életbe, ha már nincs több pár. Minden más, az időmérőtől a fordítási animációig, ezeknek a négy résznek a megjelenítése.

Lent minden részhez rövid kódrészletek tartoznak tiszta JavaScriptben, amelyeket ehhez a cikkhez írtunk: tanító példák, nem a sablonjainkban lévő kód. Utána megnézzük, mit ad hozzá egy kész játék, és mikor gyorsabb memória játék forráskódot vásárolni.

A memóriajáték négy része JavaScriptben

A pakli összeállítása párokból

Duplázd meg minden egyedi szimbólumot, és adj minden kártyának saját kulcsot. A symbols = ['owl', 'fox', 'cat', 'bee'] esetén ez a sor nyolc kártyát ad: const deck = symbols.flatMap((s) => [s, s]).map((symbol, i) => ({ key: i, symbol, open: false, matched: false })); A párkereséshez a symbol mezőt hasonlítsd össze, a key segítségével pedig kösd minden kártyát a hozzá tartozó elemhez az oldalon.

Keverés Fisher-Yates-szel, nem sort-tal

A népszerű deck.sort(() => Math.random() - 0.5) torzít. A sort következetes összehasonlításokat vár, így a véletlen válaszok miatt egyes sorrendek sokkal valószínűbbek lesznek másoknál, és a mérték böngészőtől függ. A Fisher-Yates a végétől indul, és minden elemet a tőle elölre eső véletlen pozícióval cserél, így minden sorrend egyforma esélyt kap:

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]]; }

Az i + 1 fontos: j-nek egyenlőnek kell lehetnie i-vel, különben egyetlen kártya sem maradhatna a helyén.

A fordítási zár: három állapot

Minden első változat hordozza a harmadik kártya hibát: két kártya nem egyezik, és mielőtt visszacsukódnának, a játékos megnyom egy harmadikat. Két változó javítja: first tartja a felfordított kártyát, a lock pedig igaz, amíg egy nem egyező pár visszacsukódásra vár. Így a három állapot: nincs kártya felfordítva (first null), egy van felfordítva (first be van állítva), kettő van felfordítva (lock igaz). A kattintáskezelő:

  1. Figyelmen kívül hagyja a koppintásokat zárolt állapotban vagy nyitott kártyán: if (lock || card.open) return;
  2. Felfordítja a kártyát. Ha ez az első, megjegyzi és megáll: card.open = true; if (!first) { first = card; return; }
  3. Ez a második kártya, tehát egy lépést számol: moves++;
  4. Egyezésnél mindkettő nyitva marad: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
  5. Különben zárolja a táblát, és egy szünet után mindkét kártyát visszacsukja: lock = true; const a = first; first = null; setTimeout(() => { a.open = card.open = false; lock = false; render(); }, 800);
  6. Egyezés után ellenőrzi a győzelmet: if (pairsLeft === 0) showWin(moves, seconds());

Másold át a first értékét egy a változóba, mielőtt kiürítenéd, mert az időzítő 800 ezredmásodperccel később fut, akkor pedig a first-nek már szabadnak kell lennie. A játék elején állítsd be a pairsLeft = symbols.length értéket, és minden változás után hívd meg a render() függvényt.

Lépések, idő, fordítási animáció és akadálymentesség

Lépések és idő

Lépést csak a második kártyánál számolj. Az órát az első fordításnál indítsd, nem az oldal betöltésénél: let start = null; majd a kattintáskezelőben start ??= performance.now(); az értékét pedig így olvasd ki: const seconds = () => Math.round((performance.now() - start) / 1000); A böngészők lelassítják az időzítőket a háttérfüleken, így ha minden setInterval-tikkhez hozzáadsz egyet, az eltér, míg az időbélyegek pontosak maradnak.

CSS 3D fordítás két sorban

Két szabály végzi a fordítást: .card { transition: transform 0.4s; transform-style: preserve-3d; } és .card.open { transform: rotateY(180deg); } Mindkét oldalon add meg a backface-visibility: hidden értéket, az elülső oldalt kezdd transform: rotateY(180deg)-val, a táblához pedig adj perspective: 800px-et. Azoknak a játékosoknak, akik kikapcsolják az animációt: @media (prefers-reduced-motion: reduce) { .card { transition: none; } }

Billentyűzet és képernyőolvasók

  • Minden kártya legyen <button>: a Tab, az Enter és a Space így extra kód nélkül működik.
  • A címkét a kártyával együtt változtasd: aria-label="5. kártya, lefelé" rejtett állapotban, majd "5. kártya, bagoly".
  • A megtalált kártyákat tiltsd le a disabled attribútummal, így kikerülnek a Tab-sorrendből.
  • A „Pár találva” vagy „Nincs egyezés” üzenetet jelezd egy élő régióban, például <p aria-live="polite">-ban.
  • Ne támaszkodj a színre: használj különböző alakú szimbólumokat, az egyezéseket pedig körvonallal vagy pipával jelöld.

Mi fér bele egy hétvégébe, és mi tart hetekig

A fentiek mind belefér egy hétvégébe, tesztekkel együtt. A játék, amelyet játékosoknak vagy ügyfélnek át lehet adni, hetekig tart, mert a munka nagy része a ciklus körül van:

  • Pályák és nehézségi görbe, játéktesztelés alapján hangolva.
  • Következetes grafika a kártyák előlapjához, hátlapjához, háttérhez és felülethez, élesen sűrű képernyőkön is.
  • Animáció és visszajelzés: párhatások, kombók, győzelmi és vereségi képernyők.
  • Mentések, amelyek kezelik a hiányzó vagy sérült rekordot.
  • Nyelvek, olyan elrendezésekkel, amelyekbe a hosszabb szavak is beférnek.
  • Érintési célterületek, álló és fekvő tájolás, kis képernyők.
  • Zene- és hangkapcsolók, amelyeket a játék megjegyez.
  • Tesztelés minden támogatott böngészőn és eszközön.
Fireflip 5. pálya: tizenkét lámpás kártya egy fahídon, a tábla fölött felpattanó +250-es pontszám, és Flick, a szentjánosbogár, ezt ünnepli: Lucky!
Fireflip, Firefly Village (szentjánosbogár-falu): a megtalált pár felvillan, oldalt a Peek és a Beacon képességekkel.

Vásárolható memóriajáték forráskód: négy Polar-sablon

Négy kész memóriajátékot árulunk HTML5-sablonként, azonos felépítéssel és más témákkal. Írás idején mindegyik 1.0.0-s verzióban van, és 49 USD-ért szerepel.

  • Memory Mansion: hangulatos halloweeni kísértetház, soha nem ijesztő. Wisp, a kis szellem, Peek és Candle képességek, 60 gyűjthető Spookie.
  • Jinglewood Memory: karácsonyi falu ajándékcímkés kártyákkal. Tinsel, a rénszarvas, Peek és North Star képességek, 60 Snowpal.
  • Safari Memory: fa szafari kártyák és kisállatok. Kiko, a szurikáta, Peek és Compass képességek, 60 Safari Pal.
  • Fireflip: lámpás kártyák egy mesebeli faluban. Flick, a szentjánosbogár, Peek és Beacon képességek, 60 Glimmer.
Memory Mansion 8. pálya: 20 kártyás tábla egy kísérteties teremben, felfordított egyező párokkal, balra Wisp, a szellem, jobbra a Peek és Candle gombok.
Memory Mansion, Moonlit Manor (holdfényes kastély): a megtalált párok nyitva és felvillanva maradnak, oldalt a Peek és a Candle képességekkel.

Mindegyik tartalmazza

  • 60 pálya 5 világban, mindegyiknek saját pályatérképe és új szabálya van: buborékban megjelenő kérések, kártyák, amelyek addig zárolva maradnak, amíg a mellettük lévő párt meg nem találod, egy szél, amely felcserél két kártyát, és karakterek, amelyek az árnyékukkal párosodnak.
  • Lépéskorlát és pályánként legfeljebb három csillag, jutalomláda 9 csillagonként, +5 lépéses mentés, Collection album és Daily board (napi tábla) naptárral és sorozattal.
  • Két képesség: a Peek egy pillanatra megmutatja az összes kártyát, a második képesség pedig megmutatja, hol van egy kártya ikre.
  • 14 felületi nyelv, telefonon, táblagépen és asztali gépen, álló vagy fekvő tájolásban.
  • HTML5, Canvas 2D és Web Audio olvasható, sima JavaScript modulokban és CSS-ben, függőség nélkül, build lépés nélkül, szabálytesztekkel. Fájlok: HTML, CSS, JavaScript, PNG, WebP, MP3 és WOFF2, egy kész tárhelyre feltölthető game/ mappával.
  • Illusztrált, offline vásárlói útmutató angolul, portugálul és spanyolul, plusz lépésenkénti testreszabási útmutató.
Jinglewood Memory 30. pálya: 20 kártyás tábla egy havas erdőben, egy kártya lakat alatt jégtömbbe fagyva.
Jinglewood Memory, Frosted Forest (dermedt erdő): a jégbe fagyott kártyák ingyen felolvadnak, ha a mellettük lévő párt megtalálták.

Könnyen módosítható dolgok

A CUSTOMIZATION.html megmutatja, melyik fájl rajzolja a képernyő egyes részeit, hogyan cseréld le a kártyaképeket, a kártyahátlapokat, a háttereket és a kabalafigurát, valamint hol vannak a pályák, képességek, jutalmak és szövegek. A kabalafigura, a Daily board és a Collection egy konfigurációs fájlban kapcsolható ki; a karakterek nevei egy kártyakészlet-fájlban vannak, átnevezéshez vagy fordításhoz.

Ár, csomagkedvezmények és korlátok

A csomagkedvezmények minden licencre érvényesek a rendelésben: 5% két sablonnál, 10% háromnál, 15% négynél, és 20% öt vagy több esetén. Az akciók csak a pénztárnál látható módon érvényesülnek. A kiadások nem tartalmaznak natív alkalmazásokat, tárhelyet, egyedi fejlesztést, online többjátékos módot, online rangsort, alkalmazáson belüli vásárlást és hirdetési SDK-t. A haladás a játékos böngészőjében mentődik.

Vásárlói ellenőrzőlista

  1. Játszd ki a demót azokon a telefonokon és számítógépeken, amelyeket a játékosaid használnak, mindkét tájolásban.
  2. Ellenőrizd, hogy az online dokumentáció lefedi-e azt, amit módosítani terveztél.
  3. Először válassz témát: a grafika cseréje kisebb munka, mint a szabályok átírása.
  4. Győződj meg róla, hogy a 14 felületi nyelv megfelel a közönségednek.
  5. Az indulás előtt válaszd ki a végleges címet: a böngészős mentések a webcímhez tartoznak.
  6. Számold meg a végtermékeket: egy licenc egyet fed.
Safari Memory 57. pálya: nem téglalap alakú elrendezésű kártyák a szavanna fölött éjszaka, köztük egy sötét sziluettkártya, amely az állatával párosodik.
Safari Memory, Starry Plains (csillagos síkság): párosítsd a Safari Palt az árnyékával.

Böngéssz minden HTML5 puzzle-játéksablon között

Gyakran ismételt kérdések

Megváltoztathatom a kártyaképeket?

Igen. Minden csomag testreszabási útmutatója megmutatja, hogyan cseréld le a kártyaképeket, a kártyahátlapokat, a háttereket és a kabalafigurát.

Kell hozzá szerver?

Csak statikus tárhely. Töltsd fel a game/ mappa tartalmát bármilyen HTTP(S) tárhelyre; adatbázis vagy szerzői fiók nem kell.

Használhatom ügyfélnek?

Igen. Minden vásárlás egy időkorlátlan, nem kizárólagos licenc egy végtermékre, a sajátodra vagy egy ügyfeledére, és a fehércímkés használat engedélyezett. A sablont vagy a kódját önmagában nem adhatod tovább és nem oszthatod meg.

Milyen támogatás jár?

Hat hónap a vásárlás dátumától, vagy 12 a pénztárnál választott bővítéssel. A testreszabást és az új funkciókat külön árajánlatban kérheted.

A cikk kódrészletei a sablonokból származnak?

Nem. Ezek rövid példák, amelyeket ehhez az útmutatóhoz írtunk. Minden sablonnak megvan a saját felépítése, amelyet a dokumentációja ír le.

Építsd vagy vásárold?

Építsd meg a ciklust magad, ha tanulni vagy prototípust készíteni akarsz: a fenti kódrészletek elegendők. Ügyfél indulásához vagy szezonális dátumhoz a sablon adja a pályákat, a grafikát, a nyelveket és a tesztelést, a te időd pedig a márkára és a tartalomra megy.

Memory Mansion: halloweeni memóriajáték, demó és licenc

Jinglewood Memory: karácsonyi memóriajáték, demó és licenc

Safari Memory: szafari állatos memóriajáték, demó és licenc

Fireflip: mesebeli memóriajáték, demó és licenc

Hogyan vegyél HTML5-játékot a weboldaladra

Változtatásokra vagy több licencre van szükséged? Kérj árajánlatot