CKTIS / JavaScript
HTMLElement: Sichtbarkeit, Interaktion und Elementhöhe
Lerne hidden, draggable, tabIndex, click(), offsetHeight und title bei HTMLElement kennen. Unterscheide schreibbare Eigenschaften, eine Aktivierungsmethode und eine schreibgeschützte Messung und berücksichtige dabei Tastaturnavigation und CSS-Layout.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 stellt Browser-APIs für HTML-Elemente bereit, keine Funktionen von ECMAScript selbst. Dass ein Projekt Node 24 verwendet, belegt nicht, dass diese APIs verfügbar sind. Die hier beschriebenen grundlegenden Funktionen werden breit unterstützt; prüfe die Unterstützung des besonderen Werts "until-found" für die Zielbrowser gesondert.
HTMLElement.hidden bildet das Attribut hidden ab: true bedeutet ausgeblendet, false bedeutet, dass dieser Zustand nicht gesetzt ist, und "until-found" ermöglicht, Inhalte über die Seitensuche oder die Fragmentnavigation sichtbar zu machen. Es ist kein allgemeiner Sichtbarkeitstest: Auch CSS beeinflusst die Anzeige. HTMLElement.draggable ist ein boolescher Wert, der steuert, ob ein Element gezogen werden kann; er implementiert keinen vollständigen Ablegevorgang. Das HTML-Attribut draggable selbst ist aufzählbar, nicht boolesch: Es verwendet "true" und "false"; fehlt es, gilt das Verhalten auto.
HTMLElement.tabIndex ist eine Ganzzahl. Mit 0 kann ein Element an der sequenziellen Tastaturnavigation teilnehmen, sofern es die übrigen Voraussetzungen erfüllt. Allein durch 0 erhält ein ausgeblendetes oder inertes (inert) Element oder ein deaktiviertes Steuerelement bei dieser Navigation keinen Fokus. Die Reihenfolge hängt von den Bereichen der Fokusnavigation ab und entspricht nicht immer der Reihenfolge im gesamten Dokument. Mit -1 wird das Element in dieser Reihenfolge üblicherweise übersprungen, kann aber weiterhin programmgesteuert fokussiert werden, sofern es fokussierbar ist. Innerhalb desselben Bereichs haben positive Werte Vorrang vor 0; vermeide sie, damit die Navigation nicht verwirrend wird. HTMLElement.click() ist eine Methode und keine boolesche Eigenschaft: Sie löst programmgesteuert einen Klick aus, jedoch nicht bei einem deaktivierten Formularsteuerelement. Sie ersetzt keine vollständige Benutzergeste.
HTMLElement.offsetHeight ist schreibgeschützt: Der Wert gibt die ganzzahlige Layout-Höhe in CSS-Pixeln zurück, einschließlich Innenabstand, Rahmen und eines gegebenenfalls vorhandenen horizontalen Scrollbalkens, aber ohne Außenabstände. Hat das Element oder ein Vorfahr display: none, ist das Ergebnis 0. HTMLElement.title enthält ergänzende Informationen, die normalerweise als Tooltip angezeigt werden, wenn der Zeiger über dem Element schwebt.
Das Beispiel erstellt ein Element und einen Button, setzt die Eigenschaften, ruft click() auf und liest die Höhe aus. Die expliziten Maße ergeben erwartungsgemäß 34; nach display: none wird 0 erwartet. Am Ende entfernt das Beispiel die Elemente und bereinigt so das Dokument.
Beispiele
(() => {
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();
})();Ergebnis
false | true | 0 | Demo panel | 1 | 34 true | 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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