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.

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:
- Ignora i tocchi mentre è bloccato o su una carta aperta: if (lock || card.open) return;
- Apri la carta. Se è la prima, ricordala e fermati: card.open = true; if (!first) { first = card; return; }
- È la seconda carta, quindi conta una mossa: moves++;
- In caso di coppia, tieni entrambe aperte: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
- 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);
- 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.

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.

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.

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
- Prova la demo sui telefoni e sui computer che usano i tuoi giocatori, in entrambi gli orientamenti.
- Verifica che la documentazione online copra ciò che pianifichi di cambiare.
- Scegli prima il tema: sostituire la grafica è un lavoro più piccolo che cambiare le regole.
- Accertati che le 14 lingue dell'interfaccia siano adatte al tuo pubblico.
- Scegli l'indirizzo definitivo prima del lancio: i salvataggi del browser appartengono all'indirizzo del sito.
- Conta i prodotti finali: una licenza copre uno.

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
