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

CKTIS / JavaScript

Element.hasAttribute() y Element.scrollIntoView()

Comprueba si un elemento tiene un atributo concreto y decide si debes desplazar la vista hasta él. Distingue la presencia del valor del atributo y el desplazamiento del foco.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

element.hasAttribute(name)
element.scrollIntoView()
element.scrollIntoView(alignToTop)
element.scrollIntoView(options)

element.hasAttribute(name) devuelve true si el atributo indicado está presente en el momento de la llamada y false si no lo está. Tanto una cadena vacía como la cadena "false" cuentan como presencia. Usa getAttribute(name) para leer el valor (null si falta) y hasAttributeNS(namespace, localName) para comprobar por espacio de nombres y nombre local. Un atributo booleano de HTML como disabled es verdadero por su mera presencia: "false" no es un valor válido y no lo desactiva.

element.scrollIntoView() desplaza, si es necesario, los contenedores ancestros desplazables, incluida el área visible del navegador, para mostrar el elemento. No le da el foco ni hace que se renderice un elemento sin caja de diseño, por ejemplo, con display: none. Llamar sin argumento o con true equivale a { block: "start", inline: "nearest" }; false cambia block a "end".

En el objeto de opciones, block e inline alinean en los ejes lógicos de bloque y de línea. Admiten "start", "center", "end" o "nearest"; esta última opción limita el movimiento necesario. behavior elige entre animación ("smooth"), salto ("instant") o el ajuste CSS scroll-behavior ("auto", predeterminado). El valor predeterminado container: "all" permite desplazar todos los ancestros desplazables; container: "nearest" limita el desplazamiento al más cercano cuando hay compatibilidad. No es lo mismo que la alineación "nearest".

Ambos métodos se llaman sobre una instancia de Element. Son parte de la plataforma web, no de ECMAScript 2024; antes de llamar, comprueba que la búsqueda del elemento no haya devuelto null. La compatibilidad con las opciones y el valor de retorno varía: scrollIntoView() puede devolver una Promise que se cumple con un objeto que contiene el booleano interrupted. Si la implementación devuelve undefined, await por sí solo no espera a que termine el desplazamiento.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Conditional scrolling</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement("div");
  panel.style.cssText = "position:fixed;top:12px;left:12px;width:220px;height:96px;overflow:auto;border:1px solid;padding:0;writing-mode:horizontal-tb";

  const spacer = document.createElement("div");
  spacer.style.height = "240px";
  const target = document.createElement("div");
  target.style.height = "32px";
  target.textContent = "Target";
  target.setAttribute("data-jump", "false");
  panel.append(spacer, target);
  document.body.append(panel);

  const before = panel.scrollTop;
  for (const element of [spacer, target]) {
    const marked = element.hasAttribute("data-jump");
    console.log(String(marked));
    if (marked) {
      element.scrollIntoView({ behavior: "instant", block: "end", inline: "nearest" });
    }
  }
  requestAnimationFrame(() => console.log(String(panel.scrollTop > before)));
})();
</script>
</body>
</html>

Resultado

false
true
true

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. `spacer` no tiene marcador y `target` tiene `data-jump` con el valor `"false"`, así que solo `target` provoca el desplazamiento. El tercer `true` indica que aumentó el `scrollTop` del panel; no es el valor que devuelve `scrollIntoView()`.

Lecciones relacionadas

  • JavaScript · Lección 37 · Avanzado · Versión: 4

Fuentes