Guia

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.

Polarzinho, o panda, virando uma carta numa grade de jogo da memória, com pares de leão e girafa virados para cima e símbolos de código no ar

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:

  1. Ignore toques com o tabuleiro travado ou numa carta aberta: if (lock || card.open) return;
  2. Abra a carta. Se for a primeira, guarde e pare: card.open = true; if (!first) { first = card; return; }
  3. É a segunda carta, então conte uma jogada: moves++;
  4. Se combinarem, deixe as duas abertas: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
  5. 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);
  6. 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.
Fireflip, fase 5: doze cartas-lanterna numa ponte de madeira, um +250 subindo sobre o tabuleiro e o vaga-lume Flick comemorando com Lucky!
Fireflip, Firefly Village: o par achado acende, com os poderes Espiar e Farol ao lado.

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.
Memory Mansion, fase 8: tabuleiro de 20 cartas num salão assombrado, pares achados virados para cima, o fantasminha Wisp à esquerda e os botões Espiar e Vela à direita.
Memory Mansion, Moonlit Manor: os pares achados ficam abertos e acendem, com os poderes Espiar e Vela ao lado.

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.
Jinglewood Memory, fase 30: tabuleiro de 20 cartas numa floresta nevada, com uma carta congelada num bloco de gelo e um cadeado.
Jinglewood Memory, Frosted Forest: cartas congeladas derretem quando o par ao lado é achado.

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

  1. Jogue a demo nos celulares e computadores do seu público, nas duas orientações.
  2. Veja se a documentação online cobre o que você pretende mudar.
  3. Escolha o tema primeiro: trocar a arte dá menos trabalho do que mudar regras.
  4. Confirme se os 14 idiomas da interface atendem o seu público.
  5. Defina o endereço final antes de lançar: o save do navegador pertence ao endereço do site.
  6. Conte os produtos finais: uma licença vale para um.
Safari Memory, fase 57: cartas num formato que não é retangular, na savana à noite, incluindo uma carta de silhueta escura que forma par com o seu animal.
Safari Memory, Starry Plains: junte cada Safari Pal com a sua sombra.

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