Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLElement: widoczność, interakcje i wysokość elementu

Poznaj hidden, draggable, tabIndex, click(), offsetHeight i title interfejsu HTMLElement. Rozróżniaj zapisywalne właściwości, metodę aktywacji oraz pomiar tylko do odczytu, uwzględniając nawigację klawiaturą i układ CSS.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

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 udostępnia przeglądarkowe API elementów HTML, a nie funkcje samego ECMAScript. Obecność Node 24 w projekcie nie dowodzi ich dostępności. Opisane podstawowe funkcje są szeroko obsługiwane; obsługę szczególnej wartości "until-found" sprawdzaj osobno dla docelowych przeglądarek.

HTMLElement.hidden odzwierciedla atrybut hidden: true oznacza ukrycie, false brak tego stanu, a "until-found" pozwala ujawnić treść przez wyszukiwanie na stronie lub nawigację do fragmentu. Nie jest to ogólny test widoczności: CSS również wpływa na wyświetlanie. HTMLElement.draggable jest wartością logiczną sterującą możliwością przeciągania; nie implementuje całej operacji upuszczania. Sam atrybut HTML draggable jest wyliczeniowy, nie logiczny: używa wartości "true" i "false", a jego brak oznacza zachowanie auto.

HTMLElement.tabIndex jest liczbą całkowitą. Wartość 0 pozwala uwzględnić element w sekwencyjnej nawigacji klawiaturą, jeśli element spełnia pozostałe warunki. Samo ustawienie 0 nie sprawia, że fokus w tej nawigacji trafi na ukryty lub nieaktywny (inert) element albo wyłączoną kontrolkę. Kolejność zależy od zakresów nawigacji fokusu i nie zawsze odpowiada kolejności w całym dokumencie. Wartość -1 zwykle pomija element w tej sekwencji, ale nadal pozwala ustawić na nim fokus programowo, jeśli element może go otrzymać. W tym samym zakresie wartości dodatnie mają pierwszeństwo przed 0; unikaj ich, by nie zaburzać nawigacji. HTMLElement.click() jest metodą, nie właściwością logiczną: programowo wywołuje kliknięcie, ale nie na wyłączonej kontrolce formularza. Nie zastępuje pełnego gestu użytkownika.

HTMLElement.offsetHeight jest tylko do odczytu: zwraca całkowitą wysokość układu w pikselach CSS, obejmującą padding, obramowanie i ewentualny poziomy pasek przewijania, lecz nie marginesy. Gdy element lub jego przodek ma display: none, wynik wynosi 0. HTMLElement.title przechowuje tekst dodatkowej informacji, zwykle pokazywanej jako dymek po najechaniu wskaźnikiem.

Przykład tworzy element i przycisk, ustawia właściwości, wywołuje click() i odczytuje wysokość. Jawne wymiary dają oczekiwane 34; po display: none oczekiwane jest 0. Usunięcie elementów na końcu sprząta dokument.

Przykłady

(() => {
  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();
})();

Wynik

false | true | 0 | Demo panel | 1 | 34
true | 0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła