Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DOMRectReadOnly.width — šířka obdélníku

Vlastnost `width` je pouze pro čtení a vrací uloženou šířku obdélníku jako číslo se zachovaným znaménkem i případnou desetinnou částí.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

rect.width

DOMRectReadOnly.width je vlastnost instance určená jen pro čtení. Čte se zápisem rect.width bez závorek a vrací hodnotu typu number. Jednotku určuje API, které obdélník poskytlo. Například u prvku HTML udává entry.contentRect.width objektu ResizeObserverEntry šířku oblasti obsahu v CSS pixelech.

Když obdélník vytváříš přímo, hodnotu width určuje třetí argument konstruktoru DOMRectReadOnly. Záporná šířka zůstává záporná: při konečných souřadnicích a záporné šířce platí, že left je x + width a right je x. Pro nezáporný vodorovný rozměr obdélníku s konečnou šířkou použij Math.abs(rect.width).

Přiřazení do width instanci DOMRectReadOnly nezmění: v přísném režimu vyvolá výjimku TypeError, jinak se ignoruje. Pokud potřebuješ jinou šířku, vytvoř nový obdélník nebo použij zapisovatelnou vlastnost width objektu DOMRect. DOMRectReadOnly patří mezi webová API, nikoli do ECMAScriptu; ověř jeho dostupnost v cílovém prostředí.

Příklady

(() => {
  "use strict";

  // Local fallback for runtimes without the Web API. It models only these three properties.
  function demoReadOnlyRect(x, width) {
    return {
      get width() { return width; },
      get left() { return width < 0 ? x + width : x; },
      get right() { return width < 0 ? x : x + width; },
    };
  }

  const rect = typeof DOMRectReadOnly === "function"
    ? new DOMRectReadOnly(10, 0, -4.5, 3)
    : demoReadOnlyRect(10, -4.5);
  console.log(`width=${rect.width}, left=${rect.left}, right=${rect.right}`);

  try {
    rect.width = 8;
  } catch (error) {
    console.log(`TypeError=${error instanceof TypeError}, width=${rect.width}`);
  }
})();

Výsledek

width=-4.5, left=5.5, right=10
TypeError=true, width=-4.5

Spusť kód v konzoli prohlížeče, který podporuje `DOMRectReadOnly`, abys použil nativní API. Pokud `DOMRectReadOnly` není k dispozici, jako v Node.js, příklad používá místní náhradu, která napodobuje jen `width`, `left` a `right`. Záporná šířka zůstane `-4.5` a přiřazení v přísném režimu vyvolá výjimku `TypeError`, kterou příklad zachytí.

Související lekce

  • JavaScript · Lekce 32 · Středně pokročilá · Verze: 3

Zdroje