Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMRectReadOnly.width — szerokość prostokąta

Właściwość `width` zwraca zapisaną szerokość prostokąta jako liczbę, zachowując jej znak i ewentualną część ułamkową.

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

Składnia

rect.width

DOMRectReadOnly.width to właściwość instancji tylko do odczytu. Odczytaj ją przez rect.width, bez nawiasów. Wynik ma typ number. Jednostkę określa API, które dostarczyło prostokąt. Na przykład dla elementu HTML entry.contentRect.width w obiekcie ResizeObserverEntry podaje szerokość obszaru treści w pikselach CSS.

W prostokącie utworzonym samodzielnie trzeci argument konstruktora DOMRectReadOnly określa width. Ujemna wartość pozostaje ujemna: dla skończonych współrzędnych i ujemnej szerokości left wynosi x + width, a right wynosi x. Aby obliczyć nieujemną rozpiętość poziomą dla skończonej szerokości, użyj Math.abs(rect.width).

Przypisanie do width nie zmienia instancji DOMRectReadOnly: w trybie ścisłym zgłasza TypeError, a poza nim jest ignorowane. Jeśli potrzebujesz innej szerokości, utwórz nowy prostokąt albo użyj zapisywalnej właściwości width obiektu DOMRect. DOMRectReadOnly to API platformy WWW, a nie część ECMAScript; sprawdź jego dostępność w docelowym środowisku.

Przykłady

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

Wynik

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

Uruchom kod w konsoli przeglądarki obsługującej `DOMRectReadOnly`, aby użyć natywnego API. Jeśli `DOMRectReadOnly` nie jest dostępny, jak w Node.js, przykład używa lokalnego modelu tylko trzech właściwości: `width`, `left` i `right`. Ujemna szerokość pozostaje równa `-4.5`, a próba przypisania w trybie ścisłym kończy się przechwyconym wyjątkiem `TypeError`.

Powiązane lekcje

  • JavaScript · Lekcja 32 · Średniozaawansowany · Wersja: 3

Źródła