Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

DOMRectReadOnly.width — širina pravokotnika

Lastnost `width` je namenjena samo branju in vrne shranjeno širino pravokotnika kot število, pri čemer ohrani predznak in morebitni ulomljeni del.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

rect.width

DOMRectReadOnly.width je lastnost primerka, namenjena samo branju. Prebereš jo z zapisom rect.width, brez oklepajev. Vrne vrednost tipa number. Merska enota je odvisna od API-ja, ki vrne pravokotnik. Pri elementu HTML na primer entry.contentRect.width objekta ResizeObserverEntry poda širino polja vsebine v slikovnih pikah CSS.

Ko pravokotnik ustvariš neposredno, tretji argument konstruktorja DOMRectReadOnly določi width. Negativna širina ostane negativna: pri končnih koordinatah in negativni širini je left enak x + width, right pa x. Za nenegativni vodoravni razpon pravokotnika s končno širino uporabi Math.abs(rect.width).

Prirejanje vrednosti lastnosti width ne spremeni primerka DOMRectReadOnly: v strogem načinu sproži izjemo TypeError, sicer pa se prirejanje prezre. Če potrebuješ drugo širino, ustvari nov pravokotnik ali uporabi zapisljivo lastnost width objekta DOMRect. DOMRectReadOnly je spletni API, ne del ECMAScripta; preveri, ali je na voljo v ciljnem izvajalnem okolju.

Primeri

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

Zaženi kodo v konzoli brskalnika, ki podpira `DOMRectReadOnly`, da uporabiš vgrajeni API. Če `DOMRectReadOnly` ni na voljo, tako kot v okolju Node.js, primer uporabi lokalni model, ki posnema samo `width`, `left` in `right`. Negativna širina ostane `-4.5`, prirejanje v strogem načinu pa sproži izjemo `TypeError`, ki jo primer prestreže.

Povezane lekcije

  • JavaScript · Lekcija 32 · Srednja · Različica: 3

Viri