CKTIS / JavaScript
DOMRect: bordo superiore (`top`) e altezza (`height`)
`top` indica dove si trova il bordo superiore del rettangolo, mentre `height` indica l’altezza con segno. Le due proprietà forniscono informazioni diverse, sia quando crei un rettangolo sia quando misuri un elemento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top e rect.height sono proprietà di istanza, non metodi. top è la coordinata verticale del bordo superiore. height è l’altezza con segno, non una coordinata. Entrambi i valori sono numeri e possono avere una parte frazionaria.
Per valori finiti di y e height, top vale y + height se height < 0, altrimenti vale y. Un’altezza negativa in un rettangolo costruito manualmente rimane negativa: non viene convertita nel suo valore assoluto. In un DOMRect puoi assegnare un valore a height; quando leggi top, il valore tiene conto della modifica. top è di sola lettura in entrambe le interfacce; height è di sola lettura in DOMRectReadOnly.
Nel risultato di element.getBoundingClientRect(), entrambi i valori sono in pixel CSS. top è relativo al bordo superiore dell’area di visualizzazione e può essere negativo se il bordo superiore del rettangolo è più in alto. height è l’altezza non negativa del rettangolo delimitatore e tiene conto dello spazio interno (padding) e dei bordi, non solo del contenuto. Il risultato non si aggiorna automaticamente: chiama di nuovo il metodo dopo uno scorrimento o una modifica del layout per ottenere una nuova misurazione. Modificare il rettangolo restituito non cambia l’elemento.
DOMRect è un’API Web, non fa parte di ECMAScript 2024. Non dare per scontato che sia disponibile in ogni ambiente di esecuzione JavaScript.
Esempi
{
const y = 20;
const height = 8;
// Without DOMRect, model only top and signed height for finite values.
const rect = typeof DOMRect === "function"
? new DOMRect(0, y, 10, height)
: {
y,
height,
get top() {
return this.height < 0 ? this.y + this.height : this.y;
},
};
console.log(`top=${rect.top}, height=${rect.height}`);
rect.height = -8;
console.log(`top=${rect.top}, height=${rect.height}`);
}Risultato
top=20, height=8 top=12, height=-8
L’esempio non richiede elementi della pagina. `y` rimane `20`, ma dopo l’assegnazione `height = -8` il bordo superiore si trova a `12`.
Lezioni correlate
- JavaScript · Lezione 34 · Intermedio · Versione: 3