CKTIS / JavaScript
HTMLElement: viditelnost, interakce a výška prvku
Poznejte hidden, draggable, tabIndex, click(), offsetHeight a title v HTMLElement. Rozlišujte zapisovatelné vlastnosti, aktivační metodu a měření pouze pro čtení a berte v úvahu navigaci klávesnicí i rozvržení CSS.
Verze: 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 poskytuje rozhraní prohlížeče pro HTML prvky, nikoli funkce samotného ECMAScriptu. Přítomnost Node 24 v projektu nedokazuje, že jsou tato rozhraní dostupná. Základní popsané funkce jsou široce podporované; podporu zvláštní hodnoty "until-found" ověřte zvlášť v cílových prohlížečích.
HTMLElement.hidden odráží atribut hidden: true znamená skrytý stav, false znamená, že tento stav není nastaven, a "until-found" umožňuje zobrazit obsah pomocí hledání na stránce nebo navigace na fragment. Nejde o obecný test viditelnosti: zobrazení ovlivňuje také CSS. HTMLElement.draggable je logická hodnota určující, zda lze prvek přetahovat; neimplementuje úplnou operaci puštění. Samotný HTML atribut draggable je výčtový, nikoli logický: používá hodnoty "true" a "false"; při vynechání platí chování auto.
HTMLElement.tabIndex je celé číslo. Hodnota 0 umožňuje zařadit prvek do sekvenční navigace klávesnicí, pokud splňuje ostatní podmínky. Samotné nastavení hodnoty 0 nezajistí, že při této navigaci dostane fokus skrytý či neaktivní (inert) prvek nebo zakázaný ovládací prvek. Pořadí závisí na oblastech navigace fokusu a ne vždy odpovídá pořadí v celém dokumentu. Hodnota -1 prvek obvykle z této sekvence vyřadí, ale stále mu lze programově nastavit fokus, pokud ho může přijmout. V rámci téže oblasti mají kladné hodnoty přednost před 0; vyhněte se jim, aby navigace nebyla matoucí. HTMLElement.click() je metoda, nikoli logická vlastnost: programově vyvolá kliknutí, kromě případu zakázaného ovládacího prvku formuláře. Nenahrazuje úplné gesto uživatele.
HTMLElement.offsetHeight je pouze pro čtení: vrací celočíselnou výšku rozvržení v pixelech CSS, včetně vnitřního odsazení, okrajů a případného vodorovného posuvníku, nikoli však vnějších okrajů. Pokud má prvek nebo některý jeho předek display: none, výsledek je 0. HTMLElement.title obsahuje doplňující informace, které se obvykle zobrazí jako tooltip při přejetí ukazatelem nad prvkem.
Příklad vytvoří prvek a tlačítko, nastaví vlastnosti, zavolá click() a přečte výšku. Výslovně nastavené rozměry dávají očekávanou hodnotu 34; po nastavení display: none se očekává 0. Odstraněním prvků na konci se dokument uklidí.
Příklady
(() => {
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();
})();Výsledek
false | true | 0 | Demo panel | 1 | 34 true | 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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