CKTIS / JavaScript
DOMRect: górna krawędź (`top`) i wysokość (`height`)
`top` mówi, gdzie znajduje się górna krawędź prostokąta, a `height` określa jego wysokość ze znakiem. Te właściwości odpowiadają na różne pytania, niezależnie od tego, czy tworzysz prostokąt, czy mierzysz element.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top i rect.height to właściwości instancji, a nie metody. top jest współrzędną pionową górnej krawędzi. height jest wysokością ze znakiem, a nie współrzędną. Obie wartości są liczbami i mogą mieć część ułamkową.
Dla skończonych wartości y i height właściwość top ma wartość y + height, gdy height < 0, a w przeciwnym razie y. Ujemna wysokość w prostokącie utworzonym ręcznie pozostaje ujemna: nie jest zamieniana na wartość bezwzględną. W DOMRect można przypisać nową wartość do height, a odczyt top uwzględni tę zmianę. top jest tylko do odczytu w obu interfejsach, a height jest tylko do odczytu w DOMRectReadOnly.
W wyniku element.getBoundingClientRect() obie wartości są podane w pikselach CSS. top jest mierzony względem górnej krawędzi obszaru widoku i może być ujemny, gdy górna krawędź prostokąta leży powyżej niej. height to nieujemna wysokość prostokąta ograniczającego, która uwzględnia wewnętrzny odstęp (padding) i obramowanie, a nie tylko treść. Wynik nie aktualizuje się automatycznie: po przewinięciu lub zmianie układu wywołaj metodę ponownie, aby uzyskać aktualny pomiar. Zmiana właściwości zwróconego prostokąta nie zmienia elementu.
DOMRect należy do API platformy webowej, a nie do ECMAScript 2024. Nie zakładaj, że jest dostępny w każdym środowisku JavaScript.
Przykłady
{
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}`);
}Wynik
top=20, height=8 top=12, height=-8
Przykład nie wymaga elementu strony. `y` pozostaje równe `20`, ale po przypisaniu `height = -8` górna krawędź ma współrzędną `12`.
Powiązane lekcje
- JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3