CKTIS / JavaScript
HTMLElement: visibilidad, interacción y altura del elemento
Aprende a usar hidden, draggable, tabIndex, click(), offsetHeight y title en HTMLElement. Distingue las propiedades modificables, un método de activación y una medición de solo lectura, teniendo en cuenta la navegación con teclado y el diseño CSS.
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.hidden = true; // Alternatives: false or "until-found"
element.draggable = true; // Alternative: false
element.tabIndex = integer;
element.click();
const height = element.offsetHeight;
element.title = "Supplementary information";HTMLElement ofrece API del navegador para los elementos HTML, no funciones propias de ECMAScript. Que un proyecto use Node 24 no demuestra que estas API estén disponibles. Las funciones básicas descritas aquí cuentan con amplio soporte; comprueba por separado el soporte del valor especial "until-found" en los navegadores de destino.
HTMLElement.hidden refleja el atributo hidden: true significa que el elemento está oculto, false que ese estado no está activo, y "until-found" permite mostrar el contenido mediante la búsqueda en la página o la navegación por fragmentos. No es una comprobación general de visibilidad: CSS también afecta a la visualización. HTMLElement.draggable es un valor booleano que controla si un elemento se puede arrastrar; no implementa una operación completa de soltar. El atributo HTML draggable es enumerado, no booleano: usa "true" y "false"; si se omite, se aplica el comportamiento auto.
HTMLElement.tabIndex es un entero. El valor 0 permite que un elemento participe en la navegación secuencial con teclado si cumple las demás condiciones. Asignar 0 no hace que un elemento oculto o inerte (inert), ni un control deshabilitado, reciba el foco en esa secuencia. El orden depende de los ámbitos de navegación del foco y no siempre coincide con el orden global del documento. El valor -1 suele excluir al elemento de la secuencia, pero permite enfocarlo mediante programación si puede recibir el foco. Dentro de un mismo ámbito, los valores positivos tienen prioridad sobre 0; evítalos para no complicar la navegación. HTMLElement.click() es un método, no una propiedad booleana: activa un clic mediante programación, salvo en un control de formulario deshabilitado. No sustituye un gesto completo del usuario.
HTMLElement.offsetHeight es de solo lectura: devuelve la altura de diseño como un entero en píxeles CSS, incluidos el relleno, los bordes y cualquier barra de desplazamiento horizontal, pero no los márgenes. Si el elemento o uno de sus antecesores tiene display: none, el resultado es 0. HTMLElement.title contiene información complementaria, que normalmente se muestra como información emergente cuando el puntero pasa sobre el elemento.
El ejemplo crea un elemento y un botón, establece las propiedades, llama a click() y lee la altura. Las dimensiones explícitas dan un valor esperado de 34; después de display: none, el resultado esperado es 0. Al final, elimina los elementos para limpiar el documento.
Ejemplos
(() => {
const panel = document.createElement("div");
const button = document.createElement("button");
button.type = "button";
button.textContent = "Show panel";
panel.textContent = "Demo";
panel.hidden = true;
panel.draggable = true;
panel.tabIndex = 0;
panel.title = "Demo panel";
panel.style.cssText = "box-sizing:content-box;height:20px;padding:5px;border:2px solid black;overflow:hidden";
document.body.append(button, panel);
let clicks = 0;
button.addEventListener("click", () => {
clicks += 1;
panel.hidden = false;
});
button.click();
console.log(`${panel.hidden} | ${panel.draggable} | ${panel.tabIndex} | ${panel.title} | ${clicks} | ${panel.offsetHeight}`);
panel.hidden = true;
panel.style.display = "none";
console.log(`${panel.hidden} | ${panel.offsetHeight}`);
button.remove();
panel.remove();
})();Resultado
false | true | 0 | Demo panel | 1 | 34 true | 0
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
- HTMLElement - Web APIs | MDN
- HTMLElement: hidden property - Web APIs | MDN
- HTMLElement: draggable property - Web APIs | MDN
- tabindex HTML global attribute - HTML | MDN
- HTMLElement: click() method - Web APIs | MDN
- HTMLElement: offsetHeight property - Web APIs | MDN
- HTMLElement: title property - Web APIs | MDN
- draggable HTML global attribute - HTML | MDN