JavaScript na página: DOM e eventos

Selecionar elementos, mudar a página e reagir a cliques e formulários, com segurança e sem recarregar.

Cerca de 16 min · Revisado em

Ao final, você vai conseguir

  • Selecionar elementos com querySelector
  • Alterar texto, classes e atributos
  • Reagir a eventos com addEventListener
  • Criar elementos a partir de dados sem usar innerHTML com texto externo

Até agora seu JavaScript conversava só com o console. Nesta aula ele passa a mexer na página: mudar um preço, contar curtidas, filtrar uma lista enquanto a pessoa digita. É assim que funcionam o carrinho do iFood, o botão de favoritar e a busca de qualquer loja. Depois desta aula, a página deixa de ser um cartaz e vira uma conversa.

A página é uma árvore viva

Quando o navegador lê o seu HTML, ele não guarda o texto do arquivo. Ele monta na memória uma árvore de objetos, um para cada elemento. Essa árvore se chama DOM (Modelo de Objetos do Documento).

Um cartão de produto e a árvore que o navegador monta a partir dele.

<article class="cartao">
  <h2>Pastel de feira</h2>
  <p>R$ <span id="preco">8,00</span></p>
  <button type="button">Adicionar</button>
</article>

Cada caixinha da árvore é um nó. O JavaScript pode encontrar qualquer nó, ler o que tem dentro e mudá-lo. Quando ele muda, o navegador redesenha aquele pedaço da tela na hora, sem recarregar a página.

Um script troca o preço do pastel de 8,00 para 7,00. Você abre o arquivo index.html no editor. O que aparece lá?

  • 8,00, o valor original
  • 7,00, porque o script salvou a mudança
  • Os dois valores, um embaixo do outro

Encontrar um elemento e mudá-lo

Para mudar algo, primeiro você precisa pegar o elemento. A boa notícia: você já sabe a linguagem para isso. document.querySelector aceita os mesmos seletores do CSS e devolve o primeiro elemento que combina.

Uma linha que encontra o preço e troca o texto dele.

const preco = document.querySelector('#preco');
preco.textContent = '7,00';
  • Variável: Guarda o elemento encontrado. Daqui para frente, preco é o próprio <span> da página, não uma cópia.
  • O documento: O objeto que representa a página inteira, a raiz da árvore. Toda busca começa por ele.
  • Buscar um elemento: Procura na árvore e devolve o primeiro elemento que combina com o seletor. Se não achar nenhum, devolve null.
  • Seletor CSS: O mesmo seletor que você usaria no CSS: #preco é o id, .cartao é uma classe, button é a tag. Sempre entre aspas, porque é um texto.
  • O texto do elemento: Lê ou troca o texto dentro do elemento. Ao atribuir um valor, a tela atualiza imediatamente.

Precisa de todos os elementos que combinam, e não só do primeiro? Use document.querySelectorAll. Ele devolve uma lista que você percorre com for...of, como os arrays da aula anterior.

elemento.textContent
O texto de dentro. titulo.textContent = "Promoção" troca o que está escrito.
elemento.classList
As classes do elemento. .add("ativo") coloca, .remove("ativo") tira e .toggle("ativo") alterna: coloca se não tem, tira se tem. O visual fica no CSS; o JavaScript só troca a classe.
elemento.setAttribute
Define um atributo. botao.setAttribute("aria-pressed", "true") avisa ao leitor de tela que o botão está ligado.
campo.value
O que a pessoa digitou num <input>. É sempre texto, mesmo num campo de número: "3", e não 3.

Ligar o modo escuro: o CSS define a aparência da classe, o JavaScript só a coloca no lugar.

const pagina = document.querySelector('body');
pagina.classList.add('tema-escuro');

const itens = document.querySelectorAll('.produto');
console.log(itens.length);
4

A página tem três botões com a classe comprar. O que este código faz?

const botao = document.querySelector('.comprar');
botao.textContent = 'Esgotado';
  • Troca o texto só do primeiro botão
  • Troca o texto dos três botões
  • Dá erro, porque existem três botões
  • Troca o texto do último botão

Complete para marcar o item #frete como selecionado: coloque a classe selecionado e troque o texto para “Frete grátis”.

const frete = document.____('#frete');
frete.classList.____('selecionado');
frete.____ = 'Frete grátis';

Reagir ao que a pessoa faz

Um evento é algo que acontece na página: um clique, uma tecla, um formulário enviado. Para reagir, você registra uma função com addEventListener. Essa função se chama ouvinte (ou handler) e só roda quando o evento acontece.

Registrar uma função para o clique do botão.

botaoCurtir.addEventListener('click', curtir);
  • Quem escuta: O elemento que você pegou com querySelector. O evento precisa acontecer nele (ou dentro dele).
  • Registrar um ouvinte: Literalmente “adicionar um ouvinte de evento”. Ele não roda nada agora: só deixa combinado o que fazer depois.
  • Qual evento: O nome do evento, em texto. Outros comuns: input (o valor de um campo mudou), submit (formulário enviado), keydown (tecla pressionada).
  • A função: O nome da função, sem parênteses. Você entrega a função para o navegador chamar na hora certa. Com parênteses, ela rodaria agora, uma vez só.

O que acontece entre o clique e a mudança na tela

  1. Pessoa → Navegador: clique no botão. A pessoa toca no botão Curtir. O navegador percebe o clique e descobre em qual elemento ele aconteceu.
  2. Navegador → Sua função: chama curtir(evento). O navegador procura ouvintes de click registrados naquele botão e chama cada um, entregando um objeto com detalhes do evento.
  3. Sua função → Sua função: curtidas = curtidas + 1. Sua função roda do começo ao fim: atualiza a variável com o novo número de curtidas.
  4. Sua função → DOM: textContent = 1. A função muda o DOM: troca o texto do contador e coloca a classe curtido no botão.
  5. DOM → Pessoa: tela redesenhada. O navegador redesenha só o que mudou. Para a pessoa, o número subiu no mesmo instante do toque.

Acompanhe quando cada linha roda. Repare que a função só executa nos cliques.

const botao = document.querySelector('#curtir');
let curtidas = 0;

botao.addEventListener('click', () => {
  curtidas = curtidas + 1;
  console.log('Curtidas:', curtidas);
});

console.log('Pronto, esperando cliques');
  1. Linha 1: Encontra o botão na árvore e guarda em botao.
  2. Linha 2: Cria o contador começando em zero.
  3. Linha 4: Registra a função para o clique. Ela não roda agora: o navegador só anota o combinado.
  4. Linha 9: O script segue e termina. A página fica parada, esperando. Saída: Pronto, esperando cliques
  5. Linha 5: Primeiro clique: o navegador chama a função e ela soma 1.
  6. Linha 6: Mostra o valor atual. Saída: Curtidas: 1
  7. Linha 5: Segundo clique: a mesma função roda de novo. A variável lembra o valor anterior.
  8. Linha 6: Cada clique é uma nova execução da função. Saída: Curtidas: 2

O navegador entrega à sua função um objeto de evento, normalmente chamado evento. A propriedade mais útil é evento.target: o elemento onde o evento aconteceu. Num campo de texto, evento.target.value é o que a pessoa acabou de digitar.

Dois eventos que você vai usar o tempo todo: input e submit.

const campoNome = document.querySelector('#nome');
campoNome.addEventListener('input', (evento) => {
  console.log('Digitou:', evento.target.value);
});

const formulario = document.querySelector('form');
formulario.addEventListener('submit', (evento) => {
  evento.preventDefault();
  console.log('Enviado sem recarregar a página');
});

Um botão de curtir de verdade

Complete a função curtir para somar 1, mostrar o número no contador, colocar a classe curtido no botão e mudar aria-pressed para "true". Depois, ligue a função ao clique. Teste clicando na prévia.

<article class="cartao">
  <h2>Pastel de feira</h2>
  <p>Curtidas: <span id="contador">0</span></p>
  <button type="button" id="botao-curtir" aria-pressed="false">Curtir</button>
</article>
body { font-family: system-ui, sans-serif; padding: 16px; }
.cartao { border: 1px solid #ccc; border-radius: 12px; padding: 16px; max-width: 260px; }
button { font: inherit; padding: 8px 16px; border-radius: 999px; border: 2px solid #e11d48; background: white; color: #e11d48; cursor: pointer; }
button.curtido { background: #e11d48; color: white; }
const botaoCurtir = document.querySelector('#botao-curtir');
const contador = document.querySelector('#contador');
let curtidas = 0;

function curtir() {
  // 1. some 1 em curtidas
  // 2. mostre o novo valor no contador com textContent
  // 3. coloque a classe 'curtido' no botão com classList.add
  // 4. mude o atributo aria-pressed do botão para 'true'
}

// 5. ligue a função curtir ao evento 'click' do botão
  • Cada clique soma 1 ao contador
  • Depois do clique, o botão tem a classe curtido
  • Depois do clique, aria-pressed vale "true"

Uma lista tem um ouvinte de clique. A pessoa clica no terceiro item. O que evento.target contém dentro da função?

  • O elemento <li> em que a pessoa clicou
  • O texto do item clicado
  • A palavra "click"
  • O número 3, a posição do item

Criar elementos a partir de dados

Num catálogo de verdade, os produtos não estão escritos no HTML: eles chegam como um array de dados. O JavaScript percorre o array e cria um elemento para cada item. São sempre três passos.

  1. Criar

    document.createElement("li") fabrica um elemento novo. Ele existe na memória, mas ainda não está na página.

    const item = document.createElement('li');
  2. Preencher

    Coloque o conteúdo com textContent e, se precisar, classes e atributos.

    item.textContent = produto.nome;
    item.classList.add('produto');
  3. Encaixar

    lista.append(item) pendura o elemento na árvore, como filho de lista. Só agora ele aparece na tela.

    lista.append(item);

Desenhar uma lista inteira a partir de um array.

const sabores = ['Calabresa', 'Margherita', 'Portuguesa'];
const lista = document.querySelector('#sabores');

for (const sabor of sabores) {
  const item = document.createElement('li');
  item.textContent = sabor;
  lista.append(item);
}

O mesmo comentário de cliente, mostrado de dois jeitos.

Perigoso: innerHTML

// comentario veio de um formulário que qualquer pessoa preenche
const comentario = '<img src="x" onerror="roubarSessao()">';

caixa.innerHTML = comentario;
// O navegador cria uma imagem quebrada e roda roubarSessao().

Seguro: textContent

const comentario = '<img src="x" onerror="roubarSessao()">';

caixa.textContent = comentario;
// Na tela aparecem os caracteres <img src=...> como texto comum.
// Nada é executado.

Você vai mostrar o nome que a pessoa digitou no cadastro numa mensagem de boas-vindas. Qual linha usar?

  • saudacao.textContent = "Olá, " + nome;
  • saudacao.innerHTML = "Olá, " + nome;
  • Tanto faz, os dois são iguais

Busca que filtra enquanto você digita

Termine a função renderizar (criar, preencher, encaixar) para a lista aparecer. Depois faça filtrar mostrar só as frutas que contêm o texto digitado, sem diferenciar maiúsculas, e ligue filtrar ao evento input do campo.

<label for="busca">Buscar fruta</label>
<input id="busca" type="search" placeholder="Ex.: manga">
<ul id="lista"></ul>
<p id="aviso" role="status" hidden>Nenhuma fruta encontrada.</p>
body { font-family: system-ui, sans-serif; padding: 16px; }
input { display: block; font: inherit; padding: 8px; margin: 4px 0 12px; width: 100%; max-width: 280px; }
li { padding: 4px 0; }
const frutas = ['Abacaxi', 'Banana', 'Caju', 'Goiaba', 'Manga', 'Maracujá'];
const campoBusca = document.querySelector('#busca');
const lista = document.querySelector('#lista');
const aviso = document.querySelector('#aviso');

function renderizar(itens) {
  lista.replaceChildren(); // esvazia a lista antes de desenhar de novo
  for (const fruta of itens) {
    const item = document.createElement('li');
    // 1. coloque o nome da fruta no item com textContent
    // 2. encaixe o item na lista com append
  }
  aviso.hidden = itens.length > 0;
}

function filtrar() {
  const termo = campoBusca.value.toLowerCase();
  // 3. crie um array só com as frutas que incluem o termo
  //    dica: frutas.filter((fruta) => fruta.toLowerCase().includes(termo))
  // 4. chame renderizar com esse array
}

// 5. chame filtrar sempre que acontecer o evento 'input' no campo

renderizar(frutas);
  • As seis frutas aparecem na lista ao abrir a página
  • Digitar ma deixa só Manga e Maracujá
  • A busca ignora maiúsculas: BAN encontra Banana
  • Sem resultados, a lista fica vazia e o aviso aparece

Coloque em ordem os passos para mostrar um array de produtos na página.

  • Pegar o elemento da lista com querySelector
  • Percorrer o array com for...of
  • Criar um <li> com createElement
  • Colocar o nome do produto com textContent
  • Encaixar o item na lista com append

Os erros que todo mundo comete

Três erros respondem pela maioria dos “meu JavaScript não funciona” de quem está começando. Conhecer cada um economiza horas.

Erro 1

Buscar antes de o elemento existir

O navegador lê o HTML de cima para baixo. Um <script> no <head> roda antes de o <body> ser montado, e querySelector não acha nada.

  • Coloque o script no fim do <body>
  • Ou use <script src="app.js" defer>

Erro 2

querySelector devolveu null

Um seletor errado, como #Preco em vez de #preco, faz a busca devolver null. A linha seguinte quebra com “Cannot read properties of null”.

  • Confira maiúsculas e o # ou .
  • Dê um console.log no elemento

Erro 3

Chamar a função em vez de entregá-la

addEventListener("click", curtir()) roda curtir uma vez, na hora, e entrega o resultado (undefined) como ouvinte. O clique não faz nada.

  • Passe só o nome: curtir
  • Ou uma função: () => curtir()

O console mostra este erro ao abrir a página. Qual a causa mais provável?

const botao = document.querySelector('#enviar');
botao.addEventListener('click', enviar);

// TypeError: Cannot read properties of null
// (reading 'addEventListener')
  • O querySelector não encontrou nenhum elemento com id enviar
  • A função enviar tem um erro dentro dela
  • O evento click não existe em botões

Ao abrir a página, aparece “Adicionado ao carrinho” no console, mas clicar no botão não faz nada. Por quê?

function adicionar() {
  console.log('Adicionado ao carrinho');
}

botao.addEventListener('click', adicionar());
  • Os parênteses em adicionar() executam a função na hora
  • Faltou preventDefault() dentro da função
  • O console impede que o evento chegue ao botão
Por que defer resolve o erro 1, mesmo com o script dentro do <head>?

defer diz ao navegador: “baixe o script agora, mas só execute depois de montar a página inteira”. Quando o código roda, a árvore já está completa e o querySelector encontra tudo. O guia Scripts: normal, async e defer mostra essa linha do tempo em detalhe.

Fechamento

  • O DOM é a árvore que o navegador monta a partir do HTML; mudar o DOM muda a tela, não o arquivo.
  • querySelector usa seletores CSS para encontrar um elemento; textContent, classList e setAttribute o alteram.
  • addEventListener registra uma função que o navegador chama quando o evento acontece; passe a função sem parênteses.
  • Para desenhar dados, crie com createElement, preencha com textContent e encaixe com append.
  • Texto vindo de fora nunca passa por innerHTML: isso abre a porta para XSS.

Comece o seu catálogo

Este é o primeiro passo do projeto Aplicação com API da trilha: um catálogo com busca, feito só com HTML, CSS e JavaScript. Por enquanto os dados ficam num array no próprio código; na próxima aula eles virão de uma API.

  1. Crie index.html, estilo.css e app.js, com o script carregado usando defer
  2. Escreva um array com pelo menos 6 produtos, cada um com nome, preco e categoria
  3. Desenhe um cartão para cada produto com createElement, textContent e append, sem innerHTML
  4. Adicione um campo de busca que filtra os cartões pelo nome a cada evento input
  5. Mostre uma mensagem quando nenhum produto combinar com a busca
  6. Coloque um botão de favoritar em cada cartão que alterna uma classe e o aria-pressed

Referências

Cursos relacionados