CKTIS / JavaScript
HTMLElement.offsetWidth — širina elementa v postavitvi
HTMLElement.offsetWidth vrne celoštevilsko širino elementa v slikovnih pikah CSS. Vključuje notranji odmik in obrobe, ne pa zunanjih odmikov. Transformacije CSS prezre.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.offsetWidthHTMLElement.offsetWidth je lastnost CSSOM View samo za branje, ne funkcija ECMAScript. Vrne celo število v slikovnih pikah CSS. Pri običajnem posameznem okvirju vključuje vsebino, notranji odmik, obrobe in prostor, ki ga zaseda navpični drsni trak, ne vključuje pa zunanjih odmikov.
Natančneje meri širino pravokotnika, poravnanega z osmi postavitve, ki obdaja vse fragmente glavnega okvirja elementa skupaj z njihovimi obrobami. Če potomec na ravni bloka razdeli glavni vrstični okvir elementa, meritev zajame tudi fragmente, ki jih ustvari ta potomec in katerih širina in višina sta različni od nič. Transformacije elementa in njegovih prednikov prezre. Če element nima okvirja, na primer pri display: none, je rezultat 0.
V primeru box-sizing: content-box pomeni, da je rezultat 100 + 2 * 10 + 2 * 2 = 124. Vrednosti ne spremeni niti margin: 30px niti transform: scale(2). Koda zahteva dokument brskalnika; sama različica Node.js ne dokazuje podpore za ta API.
Primeri
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();Rezultat
124 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.