CKTIS / JavaScript
HTMLElement.offsetWidth — šírka prvku v rozložení
HTMLElement.offsetWidth vracia celočíselnú šírku prvku v pixeloch CSS. Zahŕňa vnútorné odsadenie a okraje, ale nie vonkajšie okraje. Transformácie CSS ignoruje.
Verzia: 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.offsetWidthHTMLElement.offsetWidth je vlastnosť CSSOM View určená iba na čítanie, nie funkcia ECMAScriptu. Vracia celé číslo v pixeloch CSS. Pri bežnom samostatnom rámčeku zahŕňa obsah, vnútorné odsadenie, okraje a priestor zabratý zvislým posuvníkom, ale nezahŕňa vonkajšie okraje.
Presnejšie meria šírku obdĺžnika rovnobežného s osami rozloženia, ktorý obklopuje všetky fragmenty hlavného rámčeka prvku vrátane ich okrajov. Ak potomok na úrovni bloku rozdelí hlavný riadkový rámček prvku, do merania sa započítajú aj fragmenty vytvorené týmto potomkom, ktoré majú nenulovú šírku aj výšku. Ignoruje transformácie prvku aj jeho predkov. Ak prvok nemá rámček, napríklad pri display: none, výsledkom je 0.
V príklade znamená box-sizing: content-box, že výsledok je 100 + 2 * 10 + 2 * 2 = 124. Hodnotu nemení ani margin: 30px, ani transform: scale(2). Kód vyžaduje dokument prehliadača; samotná verzia Node.js nedokazuje podporu tohto API.
Príklady
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();Výsledok
124 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.