CKTIS / JavaScript
HTMLElement : visibilité, interaction et hauteur d’un élément
Découvrez hidden, draggable, tabIndex, click(), offsetHeight et title sur HTMLElement. Distinguez les propriétés modifiables, une méthode d’activation et une mesure en lecture seule, tout en tenant compte de la navigation au clavier et de la mise en page CSS.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 fournit des API du navigateur pour les éléments HTML, et non des fonctionnalités d’ECMAScript lui-même. La présence de Node 24 dans un projet ne prouve pas que ces API y sont disponibles. Les fonctionnalités de base décrites ici sont largement prises en charge ; vérifiez séparément la prise en charge de la valeur particulière "until-found" dans les navigateurs ciblés.
HTMLElement.hidden reflète l’attribut hidden : true signifie que l’élément est masqué, false que cet état n’est pas appliqué, et "until-found" permet de révéler le contenu via la recherche dans la page ou la navigation par fragment. Ce n’est pas un test général de visibilité : CSS influe aussi sur l’affichage. HTMLElement.draggable est une valeur booléenne qui détermine si un élément peut être déplacé ; elle ne met pas en œuvre une opération complète de dépôt. L’attribut HTML draggable est lui-même énuméré, et non booléen : il utilise "true" et "false", tandis que son absence correspond au comportement auto.
HTMLElement.tabIndex est un entier. La valeur 0 permet à un élément de participer à la navigation séquentielle au clavier s’il remplit les autres conditions. Définir cette valeur à 0 ne permet pas à un élément masqué ou inerte (inert), ni à un contrôle désactivé, de recevoir le focus dans cette séquence. L’ordre dépend des périmètres de navigation du focus et ne correspond pas toujours à l’ordre global du document. La valeur -1 exclut généralement l’élément de la séquence, mais permet toujours de lui donner le focus par programmation s’il peut le recevoir. Dans un même périmètre, les valeurs positives passent avant 0 ; évitez-les pour ne pas perturber la navigation. HTMLElement.click() est une méthode, pas une propriété booléenne : elle déclenche un clic par programmation, sauf sur un contrôle de formulaire désactivé. Elle ne remplace pas un geste complet de l’utilisateur.
HTMLElement.offsetHeight est en lecture seule : il renvoie la hauteur de mise en page sous forme d’un entier en pixels CSS, avec le padding, les bordures et une éventuelle barre de défilement horizontale, mais sans les marges. Si l’élément ou un ancêtre a display: none, le résultat est 0. HTMLElement.title contient des informations complémentaires, généralement affichées sous forme d’info-bulle lorsque le pointeur survole l’élément.
L’exemple crée un élément et un bouton, définit les propriétés, appelle click() et lit la hauteur. Les dimensions explicites donnent une valeur attendue de 34 ; après display: none, le résultat attendu est 0. La suppression des éléments à la fin nettoie le document.
Exemples
(() => {
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();
})();Résultat
false | true | 0 | Demo panel | 1 | 34 true | 0
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- 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