Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Element — estructura del DOM, geometría y desplazamiento

Element representa un elemento del DOM, no un nodo cualquiera. Proporciona navegación, atributos y sustitución del contenido; en los navegadores también expone medidas de diseño y desplazamiento. Distingue entre la estructura del árbol, las dimensiones del área cliente y los rectángulos relativos a la ventana gráfica.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

element.clientWidth; element.clientHeight; element.clientLeft; element.clientTop; element.scrollHeight; element.scrollTop; element.scrollTop = y; element.getBoundingClientRect(); element.getClientRects(); element.scrollIntoView({ block: "nearest", behavior: "instant" }); element.replaceChildren(...nodesOrStrings); element.children; element.tagName; element.parentElement; element.previousElementSibling; element.nextElementSibling; element.hasAttribute(name); element.toggleAttribute(name, force);

Element representa un elemento del DOM. Element.children es una colección viva de los hijos directos que son elementos; excluye texto y comentarios. Element.parentElement, Element.previousElementSibling y Element.nextElementSibling devuelven un elemento o null. Element.tagName proporciona el nombre cualificado; en los documentos HTML, los nombres de los elementos HTML se escriben en mayúsculas.

Element.hasAttribute(name) comprueba si existe un atributo. Element.toggleAttribute(name, force) fuerza su presencia con true y su ausencia con false; sin force, alterna el estado. Devuelve el estado final de presencia. Element.replaceChildren(...nodesOrStrings) sustituye todos los hijos; las cadenas se tratan como texto, no como HTML. Sin argumentos, elimina todos los hijos.

Para un elemento de bloque típico, Element.clientWidth y Element.clientHeight indican la anchura y la altura interiores, con el relleno pero sin los bordes ni el espacio ocupado por las barras de desplazamiento. En un span en línea normal, ambas propiedades devuelven 0, aunque tenga relleno y contenido visible. En modo estándar, para el elemento raíz devuelven las dimensiones de la ventana gráfica sin las barras de desplazamiento, no las de su propia caja de relleno. Element.clientLeft y Element.clientTop indican el desplazamiento del área cliente respecto al borde; pueden incluir una barra de desplazamiento. Element.scrollHeight incluye el contenido que sobresale verticalmente. Estas medidas son enteros. Element.scrollTop, que se puede modificar, indica el desplazamiento vertical y puede ser fraccionario o negativo en diseños invertidos.

Element.getBoundingClientRect() devuelve un rectángulo envolvente; Element.getClientRects() devuelve los rectángulos de los fragmentos, como las distintas líneas de un elemento en línea. Las coordenadas son relativas a la ventana gráfica y tienen en cuenta las transformaciones CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) desplaza los contenedores para mostrar el elemento. Leer la geometría puede forzar el cálculo del diseño; agrupa esas lecturas antes de escribir estilos.

Esta es una API del entorno del navegador, no de ECMAScript por sí solo; Node 24 no demuestra que esté disponible. La fuente DOM define la estructura y los atributos, no los algoritmos de geometría y desplazamiento de CSSOM View. No se indican versiones mínimas de navegadores; comprueba los métodos necesarios en el entorno de destino. El ejemplo evita deliberadamente medir el diseño.

Ejemplos

(() => {
  const box = document.createElement("div");
  const first = document.createElement("span");
  const last = document.createElement("span");
  box.replaceChildren(first, "text", last);
  box.toggleAttribute("data-ready", true);

  console.log(box.children.length);
  console.log(first.parentElement === box);
  console.log(first.nextElementSibling === last);
  console.log(last.previousElementSibling === first);
  console.log(box.hasAttribute("data-ready"));
  console.log(box.toggleAttribute("data-ready", false));
  box.replaceChildren("done");
  console.log(box.children.length, box.textContent);
})();

Resultado

2
true
true
true
true
false
0 done

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes