Skip to content

Latest commit

 

History

History
300 lines (214 loc) · 12.9 KB

dom-api.md

File metadata and controls

300 lines (214 loc) · 12.9 KB
Raw

DOM

O que é o DOM?

No início, o JavaScript e o DOM estavam fortemente interligados, mas, eventualmente, evoluíram para entidades separadas. O conteúdo da página é armazenado no DOM e pode ser acessado e manipulado via JavaScript.

Embora o DOM seja frequentemente acessado usando JavaScript, não é uma parte da linguagem JavaScript. Ele também pode ser acessado por outras linguagens.

Quando uma página da web é totalmente carregada, o navegador cria um DOM da página. O DOM é a representação de dados dos objetos que compõem a estrutura e o conteúdo de um documento na web.

O DOM trata um documento como uma árvore de objetos em que cada nó representa uma parte do documento. Para permitir que você entenda a árvore de objetos DOM.

Vamos converter os elementos HTML do código abaixo em uma árvore de objetos DOM.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>O DOM</title>
  </head>
  <body>
    <h1>Programa Start</h1>
    <p>Somos a melhor turma de Frontend em linha reta do planeta!</p>
  </body>
</html>

Representação da árvore de objetos do DOM.

E como você pode ver, o primeiro elemento <html> no código é o nó mãe da árvore, enquanto os elementos <head> e <body> são nós filhos do nó mãe <html>. O <title> e os <meta> são filhos do elemento <head>, enquanto os elementos <h1> e o <p> são nós filhos do elemento <body>. Se você já ouviu falar sobre a árvore genealógica em biologia, pense na árvore de objetos DOM como uma réplica semelhante da árvore genealógica

Acessando o DOM

Você não precisa fazer nada de especial para começar a usar o DOM, todo navegador usa um modelo de objeto de documento para tornar as páginas da web acessíveis via JavaScript.

Métodos de acesso DOM

O DOM possui muitos métodos, são eles que fazem a ligação entre os nodes (elementos) e os eventos. Vamos estudar os métodos mais usados lembrando que existem muitos outros e você pode ver todos nesse link.

Selecionando elementos pela identificação

Qualquer elemento HTML pode ter um atributo id. O valor desse atributo deve ser único dentro do documento - dois elementos no mesmo documento não podem ter a mesma identificação. Você pode selecionar um elemento com base nessa identificação exclusiva com o método getElementById do objeto document.

<h1 id="title">Programa Start</h1>

// index.js
const elementTitle = document.getElementById("title");

// Recuperando o valor:
console.log(elementTitle.innerText); // Programa Start

// Alterando o valor:
elementTitle.innerText = "Programa Start 2020";

// Recuperando o novo valor:
console.log(elementTitle.innerTextß); // Programa Start 2020

Selecionando elementos pelo nome

A atributo HTML name se destinava originalmente a atribuir nomes a elementos de formulário e o valor desse atributo é usado quando dados de formulário são enviados para um servidor. Assim como o atributo id, name atribui um nome a um elemento. Ao contrário de id, contudo, o valor de um atributo name não precisa ser único: vários elementos podem ter o mesmo nome e isso é comum no caso de botões de seleção e caixa de seleção em formulários web. Além disso ao contrário de id, o atributo name é válido somente em alguns elementos HTML, incluindo formulários, elementos de formulário, tag iframe e tag img.

<!-- HTML -->
<input type="radio" name="techs" value="react"/>
<input type="radio" name="techs" value="vue"/>
<input type="radio" name="techs" value="angular"/>

//
// JavaScript
//
const elementos = document.getElementsByName("techs");
console.log(elementos);
// NodeList(3) [input, input, input]

// Podemos acessar cada elemento, individualmente, através de seu índice.
console.log(elementos[0].value); // react
console.log(elementos[1].value); // vue
console.log(elementos[2].value); // angular

// Podemos alterar esses valores também:
elementos[2].value = "svelt"
console.log(elementos[2].value); // svelt

Selecionando elementos pela tag

getElementsByTagName permite você percorrer o DOM procurando por todos os elementos em sua página com um nome de tag especificado. Aqui está a sintaxe:

<ul>
  <li>React</li>
  <li>Vue</li>
  <li>Svelt</li>
  <li>Angular</li>
</ul>

const items = document.getElementsByTagName('li');
// HTMLCollection(4) [li, li, li, li]

Selecionando elementos pela classe CSS

O método getElementsByClassName que nos permite selecionar conjuntos de elementos do documento com base nos identificadores que estão em seu atributo class. A função retorna um NodeList contendo todos os descendentes coincidentes do documento ou elemento.

Como parâmetro, ela recebe um único argumento de string e retorna os elementos que coincidirem com a classe seletora repassada no argumento.

<ul class="lista">
  <li class="item-da-lista">React</li>
  <li class="item-da-lista">Vue</li>
  <li class="item-da-lista">Svelt</li>
  <li class="item-da-lista">Angular</li>
</ul>

// Retorna um array com uma únuca posição contendo toda a lista
const minhaLista = document.getElementsByClassName("lista") // HTMLCollection [ul.lista]

// Retorna um array de itens da lista
const itensDaLista = document.getElementsByClassName("item-da-lista") 
//HTMLCollection(4) [li.item-da-lista.primeiro-item, li.item-da-lista, li.item-da-lista, li.item-da-lista]

Selecionando elementos através dos seletores CSS

A função querySelectorAll() recebe um argumento de string contendo um seletor CSS e retorna um objeto NodeList representando os elementos do documento que correspondem ao seletor.

Temos a função querySelector() que retorna somente o primeiro (na ordem do documento) elemento coincidente ou null, caso não haja elementos correspondentes.

  <h1 id="title">Programa Start</h1>
  <p>Somos a melhor turma de Frontend em linha reta do planeta!</p>
  <p>Bora DALE!</p>

  <ul class="lista">
    <li class="item-da-lista">React</li>
    <li class="item-da-lista segundo-item">Vue</li>
    <li class="item-da-lista">Svelt</li>
    <li class="item-da-lista">Angular</li>
  </ul>

// Retorna uma lista com todos elementos que contém a classe item-da-lista
const itensDaLista = document.querySelectorAll(".item-da-lista")

// Retorna todos <h1> e todos <p> encontrado no documento
const elementos= document.querySelectorAll('p, h1')

// Retorna o primeiro elemento que contém o id title
const titulo = document.querySelector('#title')

// Retorna o primeiro elemento <p> encontrado no documento
const paragrafo = document.querySelector('p')

// retorna o primeiro elemento que contém a classe segundo-item
const segundoItem = document.querySelector('.segundo-item') 
// <li class="item-da-lista primeiro-item">React</li>

Métodos node

Métodos pra navegar pela árvore do DOM.

Tenho certeza de que poderia escrever alguns parágrafos sobre os diferentes métodos de acessar "nós" no DOM, mas acho que uma visão geral básica das possibilidades será suficiente para nossos propósitos aqui. Um "nó" é essencialmente qualquer elemento da sua página na estrutura do DOM, incluindo espaço em branco e texto entre tags HTML.

Os diferentes métodos de nó disponíveis através da manipulação do DOM são os seguintes:

node.childNodes
node.firstChild
node.lastChild
node.parentNode
node.nextSibling
node.previousSibling

Em cada exemplo acima, o node seria o objeto que você está fazendo referência. Vamos ilustrar a diversidade desses métodos usando um exemplo simples:

<ul class="lista">
    <li class="item-da-lista">React</li>
    <li class="item-da-lista segundo-item">Vue</li>
    <li class="item-da-lista">Svelt</li>
    <li class="item-da-lista">Angular</li>
  </ul>

Estrutura de um elemento no DOM.

Após ter selecionado um elemento do documento, às vezes você precisa encontrar partes estruturalmente relacionada:

Localizando um pai (parent)

Todo nó de elemento possui um pai, exceto o nó do documento. Consequentemente, cada nó de elemento tem uma propriedade chamada parentNode, uma referência para o pai do elemento distinto.

const lista = document.querySelector(".lista")
const paiDaLista = lista.parentNode // <body>...</body>

Localizando filhos (childrens)

Um elemento só pode ter um pai (parent), mas pode ter muitos filhos (childrens). Você pode encontrar todos os filhos de um elemento, usando a propriedade childNodes. Ela é, na verdade, uma lista de nós que contém todos os filhos do elemento, no ordem de origem.

const lista = document.querySelector(".lista")
const itensDaLista = lista.children; // HTMLCollection(4)
const itensDaListaNode = lista.childNodes; // NodeList(9)

const primeiroItem = lista.firstElementChild // <li class="item-da-lista primeiro-item">React</li>
const ultimoItem = lista.lastElementChild // <li class="item-da-lista">Angular</li>

Localizando irmãos (siblings)

Assim como podemos navegar para cima e para baixo na árvore DOM, também podemos ir de um lado para o outro, obtendo o próximo nó ou o anterior (ambos no mesmo nível). As propriedades que utilizamos para isso são nextSibling e previousSibling.

const lista =  document.querySelectorAll(".item-da-lista") // NodeList(4)
const terceiroItem = lista[2] // <li class="item-da-lista">Svelt</li>
const irmaoAnterior = terceiroItem.previousElementSibling // <li class="item-da-lista">Vue</li>
const proximoIrmao = terceiroItem.nextElementSibling // <li class="item-da-lista">Angular</li>

Acessando os atributos

Os elementos HTML consistem em um nome de tag e um conjunto de pares nome/valor conhecidos como atributos. Por exemplo, o elemento <a> que define um hiperlink utiliza o valor de seu atributo href como destino do link.

<a href=https://programastart2020.gitbook.io/programa-start/r" class="um-link-qualquer">
  Vem aprender com a gente!
</a>

Os valores de atributo dos elementos HTML estão disponíveis como propriedades dos objetos HTMLElement que representam esses elementos. Dessa forma:

const link = document.querySelector(".um-link-qualquer"); // retorna o elemento link acima
const valorDoHref = link.href // "https://programastart2020.gitbook.io/programa-start/r%22"

// Temos várias formas pra mudar os valores dos elementos no DOM, vamos testar alterando o atributo href do link acima:
link.href = "https://github.com/rede-cidada"
link.setAttribute("href", "https://github.com/simoneas02")

Manipulando o DOM

Podemos criar, inserir e excluir elementos da árvore DOM.

A função document.createElement() aceita como parâmetro o nome da tag e retorna o elemento recém criado (mas ainda não inserido).

Vamos adiconar um item na lista criada anteriormente com o valor Graphql

// cria um <li> mas ainda não está inserido na árvore do DOM, então ainda não conseguimos ver na tela
const itemDaLista = document.createElement("li"); //<li></li>

// ```document.createTextNode()``` cria um nó de texto
const texto = document.createTextNode("Graphql"); // "Graphql"

// agora vamos adicionar o texto "Graphql" dentro do elemento <li>
itemDaLista.appendChild(texto) // <li>Graphql</li>

// vamos alocar a lista numa variável
const lista = document.querySelector('.lista'); // <ul class="lista">...</ul>

// agora adicionamos nosso item na nossa lista
lista.appendChild(itemDaLista); // <li>Graphql</li>

Você pode ver nesse link outras formas de adicionar e remover elementos no DOM.

Resumo

  • document.createElement("nome-da-tag") para criar um elemento
  • document.createTextNode("algum texto") para criar um nó de texto
  • elemento_pai.appendChild(elemento_filho) para inserir um elemento na última posição
  • elemento_pai.insertBefore(elemento_filho, elemento_anterior) pra inserir um elemento em posição específica
  • elemento_pai.removeChild(elemento_filho) para remover um elemento

Referências