CKTIS / JavaScript
HTMLElement: vidnost, interakcija in višina elementa
Spoznajte hidden, draggable, tabIndex, click(), offsetHeight in title v HTMLElement. Razlikujte zapisljive lastnosti, metodo za aktiviranje in meritev samo za branje ter upoštevajte navigacijo s tipkovnico in postavitev CSS.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 zagotavlja brskalniške API-je za elemente HTML, ne pa funkcij samega ECMAScripta. Prisotnost Node 24 v projektu ne dokazuje, da so ti API-ji na voljo. Opisane osnovne funkcije so široko podprte; podporo posebni vrednosti "until-found" preverite posebej v ciljnih brskalnikih.
HTMLElement.hidden odraža atribut hidden: true pomeni, da je element skrit, false pomeni, da to stanje ni nastavljeno, "until-found" pa omogoča razkritje vsebine z iskanjem na strani ali navigacijo do fragmenta. To ni splošni preizkus vidnosti: na prikaz vpliva tudi CSS. HTMLElement.draggable je logična vrednost, ki določa, ali je element mogoče povleči; ne izvaja celotnega postopka spuščanja. Sam atribut HTML draggable je naštet, ne logičen: uporablja vrednosti "true" in "false"; če je izpuščen, velja vedenje auto.
HTMLElement.tabIndex je celo število. Vrednost 0 omogoča vključitev elementa v zaporedno navigacijo s tipkovnico, če element izpolnjuje druge pogoje. Sama nastavitev vrednosti 0 ne omogoči, da bi pri tej navigaciji fokus prejel skrit ali neaktiven (inert) element ali onemogočen kontrolnik. Vrstni red je odvisen od območij navigacije fokusa in ne ustreza vedno vrstnemu redu v celotnem dokumentu. Vrednost -1 element navadno izključi iz zaporedja, še vedno pa mu je mogoče programsko nastaviti fokus, če ga lahko prejme. Znotraj istega območja imajo pozitivne vrednosti prednost pred 0; izogibajte se jim, da navigacija ne bo zmedena. HTMLElement.click() je metoda, ne logična lastnost: programsko sproži klik, razen na onemogočenem kontrolniku obrazca. Ne nadomesti celotne uporabniške kretnje.
HTMLElement.offsetHeight je samo za branje: vrne celoštevilsko višino postavitve v slikovnih pikah CSS, vključno z notranjim odmikom, robovi in morebitnim vodoravnim drsnikom, ne pa zunanjih odmikov. Če ima element ali njegov prednik display: none, je rezultat 0. HTMLElement.title vsebuje dodatne informacije, ki so običajno prikazane kot namig, ko kazalec lebdi nad elementom.
Primer ustvari element in gumb, nastavi lastnosti, pokliče click() in prebere višino. Izrecne dimenzije dajo pričakovano vrednost 34; po nastavitvi display: none je pričakovan rezultat 0. Z odstranitvijo elementov na koncu počisti dokument.
Primeri
(() => {
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();
})();Rezultat
false | true | 0 | Demo panel | 1 | 34 true | 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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