Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMRectReadOnly.width — širina pravokutnika

Svojstvo `width` samo je za čitanje i vraća pohranjenu širinu pravokutnika kao broj, uz očuvan predznak i eventualni razlomljeni dio.

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

Sintaksa

rect.width

DOMRectReadOnly.width je svojstvo instance samo za čitanje. Čitaš ga izrazom rect.width, bez zagrada. Vraća vrijednost tipa number. Mjerna jedinica ovisi o API-ju koji je dao pravokutnik. Na primjer, za HTML element entry.contentRect.width objekta ResizeObserverEntry daje širinu okvira sadržaja u CSS pikselima.

Kad samostalno stvaraš pravokutnik, treći argument konstruktora DOMRectReadOnly određuje width. Negativna širina ostaje negativna: uz konačne koordinate i negativnu širinu, left je jednak x + width, a right je jednak x. Za nenegativni vodoravni raspon pravokutnika konačne širine upotrijebi Math.abs(rect.width).

Dodjela vrijednosti svojstvu width ne mijenja instancu DOMRectReadOnly: u strogom načinu rada izaziva iznimku TypeError, a inače se zanemaruje. Ako trebaš drugu širinu, stvori novi pravokutnik ili upotrijebi svojstvo width objekta DOMRect, koje dopušta upis. DOMRectReadOnly je web API, a ne dio ECMAScripta; provjeri je li dostupan u ciljnom okruženju.

Primjeri

(() => {
  "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}`);
  }
})();

Rezultat

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

Pokreni kôd u konzoli preglednika koji podržava `DOMRectReadOnly` da bi koristio ugrađeni API. Ako `DOMRectReadOnly` nije dostupan, kao u okruženju Node.js, primjer koristi lokalni model koji oponaša samo `width`, `left` i `right`. Negativna širina ostaje `-4.5`, a dodjela u strogom načinu rada izaziva iznimku `TypeError` koju primjer hvata.

Povezane lekcije

  • JavaScript · Lekcija 32 · Srednje · Verzija: 3

Izvori