CKTIS / JavaScript
DOMRectReadOnly.width — breedte van een rechthoek
De alleen-lezen-eigenschap `width` geeft de opgeslagen breedte van de rechthoek terug als getal, met behoud van het teken en een eventueel fractioneel deel.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.widthDOMRectReadOnly.width is een alleen-lezen-eigenschap van een instantie. Je leest die uit met rect.width, zonder haakjes. Het resultaat heeft het type number. De eenheid hangt af van de API die de rechthoek levert. Voor een HTML-element geeft entry.contentRect.width van een ResizeObserverEntry bijvoorbeeld de breedte van het inhoudsvak in CSS-pixels.
Als je zelf een rechthoek maakt, bepaalt het derde argument van DOMRectReadOnly de waarde van width. Een negatieve breedte blijft negatief: bij eindige coördinaten en een negatieve breedte is left gelijk aan x + width en right gelijk aan x. Gebruik Math.abs(rect.width) voor de niet-negatieve horizontale afstand tussen de randen van een rechthoek met een eindige breedte.
Een toewijzing aan width verandert een DOMRectReadOnly-instantie niet: in strikte modus veroorzaakt die een TypeError, anders wordt de toewijzing genegeerd. Heb je een andere breedte nodig, maak dan een nieuwe rechthoek of gebruik de schrijfbare eigenschap width van een DOMRect. DOMRectReadOnly is een web-API, geen onderdeel van ECMAScript; controleer of je doelomgeving deze API aanbiedt.
Voorbeelden
(() => {
"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}`);
}
})();Resultaat
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Voer de code uit in de console van een browser die `DOMRectReadOnly` ondersteunt om de ingebouwde API te gebruiken. Als `DOMRectReadOnly` niet beschikbaar is, zoals in Node.js, gebruikt het voorbeeld een lokaal model dat alleen `width`, `left` en `right` nabootst. De negatieve breedte blijft `-4.5` en de toewijzing in strikte modus veroorzaakt een `TypeError` die het voorbeeld opvangt.
Gerelateerde lessen
- JavaScript · Les 32 · Gemiddeld · Versie: 3