Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

DOMRectReadOnly.width — largura de um retângulo

A propriedade `width`, só de leitura, devolve a largura guardada do retângulo como um número, mantendo o sinal e a eventual parte fracionária.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

rect.width

DOMRectReadOnly.width é uma propriedade de instância só de leitura. Lê-a com rect.width, sem parênteses. O resultado é do tipo number. A unidade depende da API que fornece o retângulo. Por exemplo, para um elemento HTML, entry.contentRect.width de um objeto ResizeObserverEntry indica a largura da caixa de conteúdo em píxeis CSS.

Ao criares um retângulo, o terceiro argumento de DOMRectReadOnly define width. Uma largura negativa mantém-se negativa: com coordenadas finitas e largura negativa, left é igual a x + width e right é igual a x. Para obteres a extensão horizontal não negativa de um retângulo com largura finita, usa Math.abs(rect.width).

Atribuir um valor a width não altera uma instância de DOMRectReadOnly: em modo estrito, a atribuição lança um TypeError; fora desse modo, é ignorada. Se precisares de outra largura, cria um novo retângulo ou usa a propriedade gravável width de um DOMRect. DOMRectReadOnly é uma API da Web e não faz parte de ECMAScript; verifica se está disponível no ambiente de execução de destino.

Exemplos

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

Resultado

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

Executa o código na consola de um navegador que suporte `DOMRectReadOnly` para usares a API nativa. Se `DOMRectReadOnly` não estiver disponível, como no Node.js, o exemplo usa um modelo local que reproduz apenas `width`, `left` e `right`. A largura negativa mantém-se em `-4.5` e a atribuição em modo estrito lança um `TypeError` que o exemplo interceta.

Lições relacionadas

  • JavaScript · Lição 32 · Intermédio · Versão: 3

Fontes