CKTIS / JavaScript
HTMLElement.offsetWidth — šířka prvku v rozvržení
HTMLElement.offsetWidth vrací celočíselnou šířku prvku v pixelech CSS. Zahrnuje vnitřní odsazení a okraje, ale nezahrnuje vnější okraje. Transformace CSS ignoruje.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.offsetWidthHTMLElement.offsetWidth je vlastnost CSSOM View určená pouze ke čtení, nikoli funkce ECMAScriptu. Vrací celé číslo v pixelech CSS. U běžného samostatného rámečku zahrnuje obsah, vnitřní odsazení, okraje a prostor zabraný svislým posuvníkem, nezahrnuje však vnější okraje.
Přesněji měří šířku obdélníku rovnoběžného s osami rozvržení, který obklopuje všechny fragmenty hlavního rámečku prvku včetně jejich okrajů. Pokud potomek na úrovni bloku rozdělí hlavní řádkový rámeček prvku, do měření se započítají i fragmenty vytvořené tímto potomkem, které mají nenulovou šířku i výšku. Ignoruje transformace prvku i jeho předků. Pokud prvek nemá rámeček, například při display: none, výsledkem je 0.
V příkladu znamená box-sizing: content-box, že výsledek je 100 + 2 * 10 + 2 * 2 = 124. Hodnotu nemění ani margin: 30px, ani transform: scale(2). Kód vyžaduje dokument prohlížeče; samotná verze Node.js nedokládá podporu tohoto API.
Pří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ýsledek
124 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.