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
- 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