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

CKTIS / JavaScript

DOMRectReadOnly.width — šírka obdĺžnika

Vlastnosť `width` je iba na čítanie a vracia uloženú šírku obdĺžnika ako číslo so zachovaným znamienkom aj prípadnou desatinnou časťou.

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

Syntax

rect.width

DOMRectReadOnly.width je vlastnosť inštancie určená iba na čítanie. Číta sa zápisom rect.width bez zátvoriek a vracia hodnotu typu number. Jednotku určuje API, ktoré obdĺžnik poskytlo. Napríklad pri prvku HTML udáva entry.contentRect.width objektu ResizeObserverEntry šírku oblasti obsahu v pixeloch CSS.

Keď obdĺžnik vytváraš priamo, hodnotu width určuje tretí argument konštruktora DOMRectReadOnly. Záporná šírka zostáva záporná: pri konečných súradniciach a zápornej šírke sa left rovná x + width a right sa rovná x. Na získanie nezáporného vodorovného rozmeru obdĺžnika s konečnou šírkou použi Math.abs(rect.width).

Priradenie do width inštanciu DOMRectReadOnly nezmení: v striktnom režime vyvolá výnimku TypeError, inak sa ignoruje. Ak potrebuješ inú šírku, vytvor nový obdĺžnik alebo použi zapisovateľnú vlastnosť width objektu DOMRect. DOMRectReadOnly je webové API, nie súčasť ECMAScriptu; over jeho dostupnosť v cieľovom prostredí.

Prí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ýsledok

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

Ak chceš použiť natívne API, spusť kód v konzole prehliadača, ktorý podporuje `DOMRectReadOnly`. Ak `DOMRectReadOnly` nie je k dispozícii, ako v Node.js, príklad použije lokálnu náhradu, ktorá napodobňuje iba `width`, `left` a `right`. Záporná šírka zostane `-4.5` a priradenie v striktnom režime vyvolá výnimku `TypeError`, ktorú príklad zachytí.

Súvisiace lekcie

  • JavaScript · Lekcia 32 · Stredne pokročilá · Verzia: 3

Zdroje