CKTIS / JavaScript
HTMLElement: visibilità, interazione e altezza dell’elemento
Scopri hidden, draggable, tabIndex, click(), offsetHeight e title su HTMLElement. Distingui le proprietà modificabili, un metodo di attivazione e una misurazione in sola lettura, tenendo conto della navigazione da tastiera e del layout CSS.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
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 fornisce API del browser per gli elementi HTML, non funzionalità di ECMAScript in sé. La presenza di Node 24 in un progetto non dimostra che queste API siano disponibili. Le funzionalità di base descritte qui sono ampiamente supportate; verifica separatamente il supporto del valore speciale "until-found" nei browser di destinazione.
HTMLElement.hidden riflette l’attributo hidden: true significa che l’elemento è nascosto, false che tale stato non è attivo e "until-found" consente di mostrare il contenuto tramite la ricerca nella pagina o la navigazione tramite frammento. Non è un controllo generale della visibilità: anche CSS influisce sulla visualizzazione. HTMLElement.draggable è un valore booleano che controlla se un elemento può essere trascinato; non implementa un’operazione completa di rilascio. L’attributo HTML draggable è enumerato, non booleano: usa "true" e "false", mentre la sua omissione corrisponde al comportamento auto.
HTMLElement.tabIndex è un intero. Il valore 0 consente a un elemento di partecipare alla navigazione sequenziale da tastiera se soddisfa gli altri requisiti. Impostare 0 non fa sì che un elemento nascosto o inerte (inert), o un controllo disabilitato, riceva il focus durante questa navigazione. L’ordine dipende dagli ambiti di navigazione del focus e non coincide sempre con l’ordine complessivo del documento. Il valore -1 in genere esclude l’elemento dalla sequenza, ma consente comunque di assegnargli il focus via programma se può riceverlo. Nello stesso ambito i valori positivi hanno la precedenza su 0; evitali per non rendere confusa la navigazione. HTMLElement.click() è un metodo, non una proprietà booleana: attiva un clic via programma, tranne che su un controllo di modulo disabilitato. Non sostituisce un gesto completo dell’utente.
HTMLElement.offsetHeight è di sola lettura: restituisce l’altezza del layout come intero in pixel CSS, includendo padding, bordi ed eventuale barra di scorrimento orizzontale, ma non i margini. Se l’elemento o un suo antenato ha display: none, il risultato è 0. HTMLElement.title contiene informazioni supplementari, di solito mostrate come suggerimento quando il puntatore passa sull’elemento.
L’esempio crea un elemento e un pulsante, imposta le proprietà, chiama click() e legge l’altezza. Le dimensioni esplicite producono il valore atteso 34; dopo display: none, il risultato atteso è 0. Alla fine rimuove gli elementi per ripulire il documento.
Esempi
(() => {
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();
})();Risultato
false | true | 0 | Demo panel | 1 | 34 true | 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- 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