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

CKTIS / JavaScript

Element: seleccionar descendientes, comprobar atributos y medir rectángulos

Usa `querySelectorAll()` para encontrar descendientes que coincidan, `hasAttribute()` para comprobar si existe un atributo y `getClientRects()` para leer la geometría de la página. Ningún resultado por sí solo indica que el usuario pueda ver el elemento.

Versión: Current web platform; runtime support varies

Sintaxis

element.querySelectorAll(selectors) → NodeList
element.hasAttribute(name) → boolean
element.getClientRects() → DOMRectList

Estos tres métodos de Element responden a preguntas distintas: qué coincide en el DOM, qué atributo está presente y qué rectángulos genera la disposición de la página. Son API de la plataforma web, no de ECMAScript 2024. El ejemplo requiere un navegador con DOM y un motor de maquetación.

element.querySelectorAll(selectors) recibe una cadena con un selector CSS o una lista de selectores. Devuelve una NodeList estática con los descendientes que coinciden, en orden del documento, sin incluir el elemento sobre el que se llama. Si no hay coincidencias, la lista está vacía; una sintaxis de selector no válida lanza una DOMException denominada SyntaxError. Los cambios en el DOM no alteran qué nodos figuran en la lista guardada, pero sus entradas siguen apuntando a los nodos originales. Los ancestros situados fuera del elemento pueden intervenir en la coincidencia; :scope > .card selecciona solo sus hijos directos de clase .card. Aplica CSS.escape() al identificador dinámico, no al selector completo.

element.hasAttribute(name) comprueba si ese elemento tiene el atributo indicado: devuelve true incluso si el valor está vacío y false si el atributo no existe. No lee el valor ni comprueba los descendientes. Para leer el valor, usa getAttribute(name). Para buscar por espacio de nombres y nombre local sin prefijo, usa hasAttributeNS(namespace, localName).

element.getClientRects() no recibe argumentos. Para un elemento HTML suele devolver una colección de objetos DOMRect, uno por fragmento de caja CSS hasta el borde exterior. Un elemento en línea repartido en varias líneas puede tener varios rectángulos. Las coordenadas se expresan en píxeles CSS respecto al área de visualización y tienen en cuenta el desplazamiento. Vuelve a medir si cambia la disposición de la página. Para obtener un solo rectángulo envolvente, usa getBoundingClientRect().

display: none produce una colección de rectángulos vacía, pero el elemento sigue en el DOM y puede coincidir con un selector. Una colección no vacía no demuestra que sea visible: el elemento puede estar fuera del área de visualización o tener visibility: hidden. hasAttribute("hidden") solo comprueba el atributo HTML, no el estado de renderizado.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element layout example</title>
</head>
<body>
<script>
(() => {
  const root = document.createElement("section");
  const shown = document.createElement("div");
  const hidden = document.createElement("div");
  shown.className = hidden.className = "card";
  shown.setAttribute("data-flag", "");
  shown.style.cssText = "display: block; width: 10px; height: 10px";
  hidden.style.display = "none";
  root.append(shown, hidden);
  document.body.append(root);

  try {
    const selector = ":scope > .card";
    const cards = root.querySelectorAll(selector);
    for (const card of cards) {
      console.log(`flag=${card.hasAttribute("data-flag")} boxes=${card.getClientRects().length}`);
    }
    hidden.remove();
    console.log(`saved=${cards.length} fresh=${root.querySelectorAll(selector).length}`);
  } finally {
    root.remove();
  }
})();
</script>
</body>
</html>

Resultado

flag=true boxes=1
flag=false boxes=0
saved=2 fresh=1

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y comprueba el resultado en la consola. Los dos hijos coinciden: el primero tiene un atributo `data-flag` vacío y un rectángulo; el segundo no tiene el atributo ni rectángulos debido a `display: none`. Tras eliminar el segundo, la lista guardada conserva dos entradas, pero una nueva consulta devuelve una.

Lecciones relacionadas

  • JavaScript · Lección 40 · Intermedio · Versión: 3

Fuentes