CKTIS / JavaScript
HTMLElement.offsetWidth — ширина на елемента в оформлението
HTMLElement.offsetWidth връща ширината на елемента като цяло число в CSS пиксели. Включва вътрешните отстояния и рамките, но не и външните отстояния. Игнорира CSS трансформациите.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.offsetWidthHTMLElement.offsetWidth е свойство на CSSOM View само за четене, а не функция на ECMAScript. Връща цяло число в CSS пиксели. При обикновена единична кутия включва съдържанието, вътрешните отстояния, рамките и пространството, заето от вертикална лента за превъртане, но не включва външните отстояния.
По-точно, измерва ширината на правоъгълника, подравнен по осите на оформлението, който обхваща всички фрагменти на главната кутия на елемента заедно с рамките им. Ако потомък на блоково ниво раздели главната редова кутия на елемента, в измерването се включват и фрагментите, създадени от този потомък, които имат ненулева ширина и ненулева височина. Игнорира трансформациите на елемента и предците му. Ако няма кутия, например при display: none, резултатът е 0.
В примера box-sizing: content-box означава, че резултатът е 100 + 2 * 10 + 2 * 2 = 124. Нито margin: 30px, нито transform: scale(2) го променя. Кодът изисква документ на браузър; само версия на Node.js не доказва поддръжка на този API.
Примери
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();Резултат
124 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.