KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLElement.offsetWidth — lay-outbreedte van een element

HTMLElement.offsetWidth geeft de breedte van een element als geheel getal in CSS-pixels. De waarde omvat opvulling en randen, maar geen marges. CSS-transformaties worden genegeerd.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.offsetWidth

HTMLElement.offsetWidth is een alleen-lezen eigenschap uit CSSOM View, geen ECMAScript-functie. De eigenschap geeft een geheel getal in CSS-pixels terug. Bij een gewone enkele box omvat de waarde de inhoud, opvulling, randen en de ruimte die een verticale schuifbalk inneemt, maar niet de marges.

Preciezer gezegd meet de eigenschap de breedte van de begrenzende rechthoek die evenwijdig aan de assen loopt en alle fragmenten van de hoofdbox van het element omsluit, inclusief hun randen. Als een afstammeling op blokniveau de inline hoofdbox van het element opsplitst, tellen ook de fragmenten mee die deze afstammeling genereert en waarvan zowel de breedte als de hoogte groter is dan nul. Transformaties van het element en zijn voorouders worden genegeerd. Als er geen box is, bijvoorbeeld bij display: none, is het resultaat 0.

In het voorbeeld levert box-sizing: content-box de uitkomst 100 + 2 * 10 + 2 * 2 = 124 op. Noch margin: 30px noch transform: scale(2) verandert deze waarde. De code vereist een browserdocument; alleen een Node.js-versie toont niet aan dat deze API wordt ondersteund.

Voorbeelden

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();

Resultaat

124
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen