CKTIS / JavaScript
HTMLElement.offsetWidth — szerokość elementu w układzie
HTMLElement.offsetWidth odczytuje całkowitą szerokość elementu w pikselach CSS, obejmującą padding i obramowanie, ale nie marginesy. Pomija transformacje 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.offsetWidthHTMLElement.offsetWidth to właściwość tylko do odczytu z CSSOM View, a nie funkcja ECMAScript. Zwraca liczbę całkowitą w pikselach CSS. Dla zwykłego pojedynczego pudełka obejmuje treść, padding, obramowanie i miejsce zajęte przez pionowy pasek przewijania, lecz nie marginesy.
Ściślej: mierzy szerokość prostokąta równoległego do osi układu, który obejmuje wszystkie fragmenty głównego pudełka elementu aż po ich obramowania. Jeśli potomek blokowy dzieli główne pudełko liniowe elementu, pomiar obejmuje również fragmenty wygenerowane przez tego potomka, których szerokość i wysokość są niezerowe. Ignoruje transformacje elementu i przodków. Brak pudełka, na przykład przy display: none, daje 0.
W przykładzie box-sizing: content-box oznacza wynik 100 + 2 * 10 + 2 * 2 = 124. Ani margin: 30px, ani transform: scale(2) go nie zmieniają. Kod wymaga dokumentu przeglądarki; sama wersja Node.js nie potwierdza obsługi tego API.
Przykłady
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; box-sizing: content-box; width: 100px; height: 20px; padding: 10px; border: 2px solid; margin: 30px; overflow: hidden; transform: scale(2);';
document.body.append(box);
console.log(box.offsetWidth);
box.style.display = 'none';
console.log(box.offsetWidth);
box.remove();Wynik
124 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.