Jogo da memória em JavaScript: como o código funciona
Pares embaralhados, a trava de viradas com três estados, a checagem de acerto e a vitória em trechos curtos, e o que um template pronto acrescenta.

Um jogo da memória em JavaScript precisa de quatro coisas: um baralho embaralhado em que cada figura aparece duas vezes, uma máquina de estados para as viradas com três estados (nenhuma carta aberta, uma aberta, duas abertas com o tabuleiro travado), uma checagem que deixa abertos os pares iguais e uma condição de vitória que dispara quando não sobra nenhum par. Todo o resto, do cronômetro à animação da virada, é apresentação em cima dessas quatro partes.
A seguir, cada parte vem com trechos curtos em JavaScript puro escritos para este artigo: exemplos didáticos, não o código dos nossos templates. Depois, vemos o que um jogo pronto acrescenta e quando comprar o código-fonte é mais rápido.
As quatro partes de um jogo da memória em JavaScript
Monte o baralho a partir dos pares
Duplique cada figura única e dê a cada carta uma chave própria. Com symbols = ['owl', 'fox', 'cat', 'bee'], esta linha gera oito cartas: const deck = symbols.flatMap((s) => [s, s]).map((symbol, i) => ({ key: i, symbol, open: false, matched: false })); Compare symbol para achar o par e use key para ligar cada carta ao seu elemento na página.
Embaralhe com Fisher-Yates, não com sort
A famosa deck.sort(() => Math.random() - 0.5) é enviesada: uma ordenação espera comparações coerentes, e com respostas sorteadas algumas ordens saem muito mais que outras, conforme o navegador. O Fisher-Yates percorre a lista do fim para o começo e troca cada elemento com uma posição sorteada igual ou anterior, com a mesma chance para todas as ordens:
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]]; }
O i + 1 importa: j precisa poder ser igual a i; senão, nenhuma carta poderia ficar no lugar.
A trava das viradas: três estados
Toda primeira versão tem o defeito da terceira carta: duas cartas não combinam e, antes de fecharem, o jogador toca numa terceira. Duas variáveis resolvem: first guarda a carta aberta, e lock fica true enquanto um par errado espera para fechar. Daí os três estados: nenhuma aberta (first é null), uma aberta (first tem carta), duas abertas (lock é true). A função do clique:
- Ignore toques com o tabuleiro travado ou numa carta aberta: if (lock || card.open) return;
- Abra a carta. Se for a primeira, guarde e pare: card.open = true; if (!first) { first = card; return; }
- É a segunda carta, então conte uma jogada: moves++;
- Se combinarem, deixe as duas abertas: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
- Se não, trave o tabuleiro e feche as duas depois de uma pausa: lock = true; const a = first; first = null; setTimeout(() => { a.open = card.open = false; lock = false; render(); }, 800);
- Depois de um acerto, confira a vitória: if (pairsLeft === 0) showWin(moves, seconds());
Copie first para a antes de limpar, porque o setTimeout roda 800 milissegundos depois, quando first já precisa estar livre. Defina pairsLeft = symbols.length no início da partida e chame render() depois de cada mudança.
Jogadas, tempo, animação da virada e acessibilidade
Jogadas e tempo
Conte a jogada só na segunda carta. Comece o relógio na primeira virada, não ao carregar a página: let start = null; depois start ??= performance.now(); dentro da função do clique, e const seconds = () => Math.round((performance.now() - start) / 1000); para ler. Os navegadores desaceleram timers em abas em segundo plano, então somar um a cada tique do setInterval atrasa, enquanto marcas de tempo continuam certas.
Virada 3D em CSS com duas linhas
Duas regras fazem a virada: .card { transition: transform 0.4s; transform-style: preserve-3d; } e .card.open { transform: rotateY(180deg); } Dê às duas faces backface-visibility: hidden, comece a frente em transform: rotateY(180deg) e ponha perspective: 800px no tabuleiro. Para quem desliga as animações no sistema: @media (prefers-reduced-motion: reduce) { .card { transition: none; } }
Teclado e leitores de tela
- Faça de cada carta um <button>: Tab, Enter e espaço funcionam sem código extra.
- Mude o rótulo junto com a carta: aria-label="Carta 5, virada para baixo" enquanto escondida, depois "Carta 5, coruja".
- Desative as cartas encontradas com o atributo disabled, para elas saírem da ordem do Tab.
- Anuncie "Par encontrado" ou "Não é par" numa região viva, como <p aria-live="polite">.
- Não dependa da cor: use figuras com formas diferentes e marque os acertos com um contorno ou um sinal de certo.
O que leva um fim de semana e o que leva semanas
Tudo isso cabe num fim de semana, com testes. Um jogo para entregar a jogadores ou a um cliente leva semanas, porque a maior parte do trabalho fica em volta do loop:
- Fases e curva de dificuldade, ajustadas com muito teste.
- Arte coerente para frentes e versos das cartas, fundos e interface, nítida em telas densas.
- Animação e resposta: efeitos de par, combos, telas de vitória e derrota.
- Saves que aguentam um registro ausente ou corrompido.
- Idiomas, com telas que continuam cabendo palavras mais longas.
- Alvos de toque, retrato e paisagem, telas pequenas.
- Música e botões de som que o jogo lembra.
- Testes em cada navegador e aparelho que você atende.

Código-fonte de jogo da memória para comprar: quatro templates Polar
Vendemos quatro jogos da memória prontos como templates HTML5, com a mesma estrutura e temas diferentes. No momento em que escrevemos, todos estão na versão 1.0.0 e custam US$ 49 de tabela.
- Memory Mansion: casa assombrada de Halloween, aconchegante e sem sustos. O fantasminha Wisp, poderes Espiar e Vela, 60 Spookies para colecionar.
- Jinglewood Memory: vila de Natal com cartas de etiqueta de presente. A rena Tinsel, poderes Espiar e Estrela do Norte, 60 Snowpals.
- Safari Memory: cartas de madeira de safári e filhotes de animais. O suricato Kiko, poderes Espiar e Bússola, 60 Safari Pals.
- Fireflip: cartas-lanterna numa vila de conto de fadas. O vaga-lume Flick, poderes Espiar e Farol, 60 Glimmers.

O que os quatro trazem
- 60 fases em 5 mundos, cada um com mapa de fases e uma regra nova: pedidos mostrados num balão, cartas presas até o par ao lado ser achado, um vento que troca duas cartas e personagens que formam par com a própria sombra.
- Limite de jogadas e até três estrelas por fase, um baú de recompensa a cada 9 estrelas, o resgate de +5 jogadas, um álbum de coleção e um tabuleiro diário com calendário e sequência.
- Dois poderes: Espiar mostra todas as cartas por um instante, e o segundo mostra onde está o par de uma carta.
- Interface em 14 idiomas, no celular, no tablet e no computador, em retrato ou paisagem.
- HTML5, Canvas 2D e Web Audio em módulos JavaScript e CSS puros e legíveis, sem dependências, sem build e com testes das regras. Arquivos: HTML, CSS, JavaScript, PNG, WebP, MP3 e WOFF2, com uma pasta game/ pronta para hospedar.
- Um guia ilustrado offline em inglês, português e espanhol e um guia de personalização passo a passo.

O que é fácil de mudar
O CUSTOMIZATION.html mostra qual arquivo desenha cada parte de cada tela, como trocar as figuras das cartas, os versos, os fundos e o mascote, e onde ficam fases, poderes, recompensas e textos. Mascote, tabuleiro diário e coleção são desligados num arquivo de configuração; os nomes dos personagens ficam num arquivo de conjuntos de cartas, para renomear ou traduzir.
Preço, descontos por quantidade e limites
O desconto por quantidade vale para todas as licenças do pedido: 5% com dois templates, 10% com três, 15% com quatro e 20% com cinco ou mais. Promoções valem só como aparecem no checkout. Não incluem apps nativos, hospedagem, desenvolvimento personalizado, multiplayer nem ranking online, compras no app nem SDK de anúncios. O progresso fica salvo no navegador.
Checklist de compra
- Jogue a demo nos celulares e computadores do seu público, nas duas orientações.
- Veja se a documentação online cobre o que você pretende mudar.
- Escolha o tema primeiro: trocar a arte dá menos trabalho do que mudar regras.
- Confirme se os 14 idiomas da interface atendem o seu público.
- Defina o endereço final antes de lançar: o save do navegador pertence ao endereço do site.
- Conte os produtos finais: uma licença vale para um.

Ver todos os templates HTML5 de jogos de quebra-cabeça
Perguntas frequentes
Posso trocar as imagens das cartas?
Sim. O guia de personalização de cada pacote mostra como trocar as figuras das cartas, os versos, os fundos e o mascote.
Precisa de servidor?
Só de hospedagem estática. Envie o conteúdo de game/ para qualquer hospedagem HTTP(S); não precisa de banco de dados nem de conta do autor.
Posso usar para um cliente?
Sim. Cada compra é uma licença perpétua e não exclusiva para um produto final, seu ou de um cliente, e o white label é permitido. Não é permitido revender ou compartilhar o template ou o código isoladamente.
Que suporte está incluído?
Seis meses a partir da data da compra, ou 12 com a extensão no checkout. Personalização e recursos novos são orçados à parte.
Os trechos de código deste artigo vêm dos templates?
Não. São exemplos curtos escritos para este guia. Cada template tem a sua própria estrutura, descrita na documentação.
Fazer ou comprar?
Faça o loop você mesmo para aprender ou prototipar: os trechos acima bastam. Para o lançamento de um cliente ou uma data sazonal, um template já traz fases, arte, idiomas e testes, e o seu tempo vai para a marca e o conteúdo.
Memory Mansion: jogo da memória de Halloween, demo e licença
Jinglewood Memory: jogo da memória de Natal, demo e licença
Safari Memory: jogo da memória de animais do safári, demo e licença
Fireflip: jogo da memória de conto de fadas, demo e licença
Como comprar jogos HTML5 para o seu site
Precisa de mudanças ou de várias licenças? Peça um orçamento
