Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.offsetWidth

HTMLElement.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.

Zdroje