Guida

Gioco di memoria in JavaScript: come funziona il codice sorgente

Coppie mescolate, un blocco dei giri a tre stati, il controllo delle coppie e la condizione di vittoria in brevi frammenti, più ciò che aggiunge un template finito.

Polarzinho il panda che gira una carta su una griglia di carte da memoria, con coppie di leone e giraffa scoperte e parentesi di codice sospese sopra

Un gioco di memoria in JavaScript richiede quattro cose: un mazzo mescolato in cui ogni simbolo compare due volte, una macchina a stati dei giri con tre stati (nessuna carta scoperta, una carta scoperta, due carte scoperte con la tavola bloccata), un controllo che tiene aperte le coppie giuste, e una condizione di vittoria che scatta quando non restano coppie. Tutto il resto, dal timer all'animazione del giro, è presentazione sopra quelle quattro parti.

Qui sotto, ogni parte è accompagnata da brevi frammenti in JavaScript semplice scritti per questo articolo: esempi didattici, non il codice dentro i nostri template. Poi vediamo cosa aggiunge un gioco finito e quando comprare il codice sorgente di un gioco di memoria è più rapido.

Le quattro parti di un gioco di memoria in JavaScript

Costruisci il mazzo a coppie

Duplica ogni simbolo unico e dai a ogni carta una chiave propria. Con symbols = ['owl', 'fox', 'cat', 'bee'], questa riga crea otto carte: const deck = symbols.flatMap((s) => [s, s]).map((symbol, i) => ({ key: i, symbol, open: false, matched: false })); Confronta symbol per trovare una coppia, e usa key per legare ogni carta al suo elemento nella pagina.

Mescola con Fisher-Yates, non con sort

Il popolare deck.sort(() => Math.random() - 0.5) è sbilanciato. Un sort si aspetta confronti coerenti, quindi risposte casuali rendono alcuni ordini molto più probabili di altri, con una differenza che dipende dal browser. Fisher-Yates parte dalla fine e scambia ogni elemento con una posizione casuale uguale o precedente, il che dà a ogni ordine la stessa probabilità:

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

Il i + 1 è importante: j deve poter essere uguale a i, altrimenti nessuna carta potrebbe mai restare al proprio posto.

Il blocco dei giri: tre stati

Ogni prima versione ha il bug della terza carta: due carte sbagliano e, prima che si richiudano, il giocatore tocca una terza. Due variabili risolvono il problema: first contiene la carta scoperta, e lock è true mentre una coppia sbagliata aspetta di richiudersi. Ne risultano tre stati: nessuna carta scoperta (first è null), una scoperta (first è impostata), due scoperte (lock è true). Il gestore del clic:

  1. Ignora i tocchi mentre è bloccato o su una carta aperta: if (lock || card.open) return;
  2. Apri la carta. Se è la prima, ricordala e fermati: card.open = true; if (!first) { first = card; return; }
  3. È la seconda carta, quindi conta una mossa: moves++;
  4. In caso di coppia, tieni entrambe aperte: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
  5. Altrimenti, blocca la tavola e richiudi entrambe dopo una pausa: lock = true; const a = first; first = null; setTimeout(() => { a.open = card.open = false; lock = false; render(); }, 800);
  6. Dopo una coppia, controlla la vittoria: if (pairsLeft === 0) showWin(moves, seconds());

Copia first in a prima di svuotarla, perché il timeout parte 800 millisecondi dopo, quando first deve essere già libera. Imposta pairsLeft = symbols.length all'inizio di una partita e richiama render() dopo ogni cambiamento.

Mosse, tempo, animazione del giro e accessibilità

Mosse e tempo

Conta una mossa solo sulla seconda carta. Avvia il cronometro al primo giro, non al caricamento della pagina: let start = null; poi start ??= performance.now(); dentro il gestore del clic, e const seconds = () => Math.round((performance.now() - start) / 1000); per leggerlo. I browser rallentano i timer nelle schede in background, quindi sommare un valore a ogni tick di setInterval fa derivare il conteggio, mentre i timestamp restano corretti.

Il giro 3D in CSS in due righe

Due regole fanno il giro: .card { transition: transform 0.4s; transform-style: preserve-3d; } e .card.open { transform: rotateY(180deg); } Assegna a entrambe le facce backface-visibility: hidden, imposta la faccia anteriore su transform: rotateY(180deg) all'inizio e aggiungi perspective: 800px alla tavola. Per chi disattiva le animazioni: @media (prefers-reduced-motion: reduce) { .card { transition: none; } }

Tastiera e lettori di schermo

  • Fai di ogni carta un <button>: Tab, Invio e Spazio funzionano subito, senza codice in più.
  • Cambia l'etichetta insieme alla carta: aria-label="Carta 5, a faccia in giù" finché è coperta, poi "Carta 5, gufo".
  • Disattiva le carte abbinate con l'attributo disabled, così escono dall'ordine di tabulazione.
  • Annuncia "Coppia trovata" o "Nessuna coppia" in una live region, come <p aria-live="polite">.
  • Non affidarti al colore: usa simboli con forme diverse e segna le coppie con un contorno o un segno di spunta.

Cosa richiede un fine settimana e cosa richiede settimane

Tutto quanto sopra entra in un fine settimana, test compresi. Un gioco da consegnare a giocatori o a un cliente richiede settimane, perché la maggior parte del lavoro sta intorno al ciclo di gioco:

  • Livelli e una curva di difficoltà, tarati con il playtesting.
  • Grafica coerente per fronti e retri delle carte, sfondi e interfaccia, nitida anche sugli schermi ad alta densità.
  • Animazioni e feedback: effetti per le coppie, combo, schermate di vittoria e di sconfitta.
  • Salvataggi che gestiscono un record mancante o danneggiato.
  • Lingue, con impaginazioni che reggono parole più lunghe.
  • Aree di tocco adeguate, orientamento verticale e orizzontale, schermi piccoli.
  • Interruttori per musica e suoni che il gioco ricorda.
  • Test su ogni browser e dispositivo che supporti.
Fireflip livello 5: dodici carte lanterna su un ponte di legno, un punteggio +250 che compare sopra la tavola e la lucciola Flick che esulta Lucky!
Fireflip, Firefly Village: una coppia trovata si accende, con i poteri Peek e Beacon sul lato.

Codice sorgente di giochi di memoria in vendita: quattro template Polar

Vendiamo quattro giochi di memoria finiti come template HTML5, con la stessa struttura e temi diversi. Al momento della stesura, ciascuno è alla versione 1.0.0 e costa US$ 49 di listino.

  • Memory Mansion: una casa stregata di Halloween accogliente, mai spaventosa. Wisp il fantasmino, poteri Peek e Candle, 60 Spookies da collezionare.
  • Jinglewood Memory: un villaggio di Natale con carte cartellino regalo. Tinsel la renna, poteri Peek e North Star, 60 Snowpal.
  • Safari Memory: carte safari in legno e cuccioli di animali. Kiko il suricato, poteri Peek e Compass, 60 Safari Pal.
  • Fireflip: carte lanterna in un villaggio da fiaba. Flick la lucciola, poteri Peek e Beacon, 60 Glimmer.
Memory Mansion livello 8: una tavola di 20 carte in una sala stregata, coppie abbinate scoperte, Wisp il fantasma a sinistra e i pulsanti Peek e Candle a destra.
Memory Mansion, Moonlit Manor: le coppie trovate restano aperte e si accendono, con i poteri Peek e Candle sul lato.

Cosa includono tutti e quattro

  • 60 livelli in 5 mondi, ciascuno con la propria mappa e una regola nuova: richieste mostrate in una bolla, carte trattenute finché non si abbina la coppia accanto, una raffica che scambia due carte, e personaggi che si abbinano alla loro ombra.
  • Un limite di mosse e fino a tre stelle per livello, un forziere premio ogni 9 stelle, un salvataggio di +5 mosse, un album Collection e una tavola Daily con calendario e serie di giorni.
  • Due poteri: Peek mostra tutte le carte per un attimo, e il secondo potere mostra dove si trova il gemello di una carta.
  • 14 lingue dell'interfaccia, su telefoni, tablet e computer, in verticale o in orizzontale.
  • HTML5, Canvas 2D e Web Audio in moduli JavaScript semplici e CSS leggibili, senza dipendenze, senza passaggio di build e con test delle regole. File: HTML, CSS, JavaScript, PNG, WebP, MP3 e WOFF2, con una cartella game/ pronta per l'hosting.
  • Una guida illustrata offline per l'acquirente in inglese, portoghese e spagnolo, più una guida passo passo alla personalizzazione.
Jinglewood Memory livello 30: una tavola di 20 carte in una foresta innevata, con una carta congelata in un blocco di ghiaccio sotto un lucchetto.
Jinglewood Memory, Frosted Forest: le carte congelate nel ghiaccio si sciolgono gratis quando si abbina la coppia accanto.

Cosa è facile da cambiare

CUSTOMIZATION.html mostra quale file disegna ogni parte di ogni schermata, come sostituire le immagini delle carte, i retri, gli sfondi e la mascotte, e dove sono livelli, poteri, premi e testi. La mascotte, la tavola Daily e la Collection si disattivano in un solo file di configurazione; i nomi dei personaggi stanno in un unico file del set di carte, per rinominarli o tradurli.

Prezzo, sconti per pacchetto e limiti

Gli sconti per pacchetto si applicano a ogni licenza nell'ordine: 5% per due template, 10% per tre, 15% per quattro e 20% per cinque o più. Le promozioni si applicano solo come mostrato al checkout. Le edizioni escludono app native, hosting, sviluppo su misura, multigiocatore online, classifica online, acquisti in-app e un SDK pubblicitario. I progressi vengono salvati nel browser del giocatore.

Checklist per l'acquirente

  1. Prova la demo sui telefoni e sui computer che usano i tuoi giocatori, in entrambi gli orientamenti.
  2. Verifica che la documentazione online copra ciò che pianifichi di cambiare.
  3. Scegli prima il tema: sostituire la grafica è un lavoro più piccolo che cambiare le regole.
  4. Accertati che le 14 lingue dell'interfaccia siano adatte al tuo pubblico.
  5. Scegli l'indirizzo definitivo prima del lancio: i salvataggi del browser appartengono all'indirizzo del sito.
  6. Conta i prodotti finali: una licenza copre uno.
Safari Memory livello 57: carte in una disposizione non rettangolare sulla savana di notte, inclusa una carta con sagoma scura che si abbina al suo animale.
Safari Memory, Starry Plains: abbina ogni Safari Pal alla sua ombra.

Sfoglia tutti i template di giochi puzzle HTML5

Domande frequenti

Posso cambiare le immagini delle carte?

Sì. La guida alla personalizzazione di ogni pacchetto mostra come sostituire le immagini delle carte, i retri, gli sfondi e la mascotte.

Serve un server?

Solo un hosting statico. Carica il contenuto di game/ su qualsiasi host HTTP(S); non serve alcun database né un account dell'autore.

Posso usarlo per un cliente?

Sì. Ogni acquisto è una licenza perpetua e non esclusiva per un prodotto finale, tuo o di un cliente, e il white label è consentito. Non puoi rivendere o condividere il template né il suo codice da solo.

Quale supporto è incluso?

Sei mesi dalla data d'acquisto, oppure 12 con l'estensione al checkout. Personalizzazioni e nuove funzioni sono preventivate a parte.

I frammenti di questo articolo vengono dai template?

No. Sono brevi esempi scritti per questa guida. Ogni template ha una propria struttura, descritta nella sua documentazione.

Costruirlo o comprarlo?

Costruisci tu il ciclo di gioco per imparare o per fare un prototipo: i frammenti sopra bastano. Per il lancio per un cliente o per una data stagionale, un template ti dà livelli, grafica, lingue e test, e il tuo tempo va in branding e contenuti.

Memory Mansion: gioco di memoria di Halloween, demo e licenza

Jinglewood Memory: gioco di memoria di Natale, demo e licenza

Safari Memory: gioco di memoria con animali della savana, demo e licenza

Fireflip: gioco di memoria da fiaba, demo e licenza

Come comprare giochi HTML5 per il tuo sito

Ti servono modifiche o più licenze? Chiedi un preventivo