Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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