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

CKTIS / JavaScript

Buscar un elemento por su ID y cambiar su estado `hidden`

Localiza un elemento HTML por su identificador exacto, gestiona la falta de coincidencias y usa `hidden` para cambiar el atributo sin retirar el elemento del DOM.

Versión: Current web platform; runtime support varies

Sintaxis

// These are web platform APIs, not ECMAScript 2024 features.
const element = document.getElementById(id);
if (element instanceof HTMLElement) {
  element.hidden = true;  // Set the hidden attribute.
  element.hidden = false; // Remove the hidden attribute.
}
// Hidden Until Found depends on the browser's HTML implementation:
// element.hidden = "until-found";

document.getElementById(id) busca en el árbol del documento. Pasa el identificador sin el prefijo # de los selectores CSS; se distinguen mayúsculas y minúsculas. El método devuelve el primer Element que coincide en el orden del árbol, o null. Los identificadores deben ser únicos. Un elemento aún no insertado no se encuentra, pero uno oculto sí.

Comprueba el resultado antes de acceder a .hidden: leer o asignar una propiedad en null lanza un TypeError. La coincidencia también puede ser un elemento no HTML, por ejemplo SVG; instanceof HTMLElement comprueba el tipo en el mismo entorno global. Son API de la plataforma web, no funciones de ECMAScript 2024. La propiedad independiente document.hidden, de solo lectura, informa de la visibilidad del documento, no de la de un elemento.

HTMLElement.hidden refleja el atributo HTML hidden del elemento. Asignar true establece el atributo con un valor vacío y asignar false lo elimina. La lectura devuelve false si no hay atributo y true en el estado oculto normal; incluso setAttribute("hidden", "false") oculta el elemento. Si se admite "until-found", puedes asignar y leer esa cadena: la búsqueda en la página o la navegación a un fragmento pueden revelar el contenido.

hidden no retira el nodo ni protege datos sensibles. Quitar el atributo no garantiza que el elemento sea visible: CSS o un ancestro oculto pueden seguir ocultándolo, y la propiedad CSS display también puede anular la ocultación normal.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>getElementById and hidden</title>
</head>
<body>
<script>
(() => {
  const doc = document.implementation.createHTMLDocument();
  const panel = doc.createElement("section");
  panel.id = "notice";

  console.log(doc.getElementById("notice") === null);
  doc.body.appendChild(panel);

  const match = doc.getElementById("notice");
  if (!(match instanceof HTMLElement)) {
    throw new Error("Expected an HTML element with id notice");
  }

  match.hidden = true;
  console.log(`${match.hidden} ${match.hasAttribute("hidden")} ${doc.getElementById("notice") === match}`);

  match.hidden = false;
  console.log(`${match.hidden} ${match.hasAttribute("hidden")}`);
})();
</script>
</body>
</html>

Resultado

true
true true true
false false

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. El documento independiente aísla el ejemplo de la página actual. Las tres líneas muestran que no hay coincidencia antes de insertar el elemento, que el mismo elemento se encuentra estando oculto y que asignar `false` elimina el atributo.

Lecciones relacionadas

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

Fuentes