CKTIS / JavaScript
DOMRectReadOnly.width — Breite eines Rechtecks
Die schreibgeschützte Eigenschaft `width` liefert die gespeicherte Breite des Rechtecks als Zahl, einschließlich Vorzeichen und Nachkommastellen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.widthDOMRectReadOnly.width ist eine schreibgeschützte Instanzeigenschaft. Lies sie mit rect.width ohne Klammern aus. Das Ergebnis ist vom Typ number. Die Einheit hängt von der API ab, die das Rechteck liefert. Bei einem HTML-Element gibt entry.contentRect.width eines ResizeObserverEntry beispielsweise die Breite der Inhaltsbox in CSS-Pixeln an.
Wenn du ein Rechteck selbst erstellst, bestimmt das dritte Argument von DOMRectReadOnly den Wert von width. Eine negative Breite bleibt negativ: Bei endlichen Koordinaten und negativer Breite ist left gleich x + width und right gleich x. Für die nichtnegative horizontale Ausdehnung bei endlicher Breite verwende Math.abs(rect.width).
Eine Zuweisung an width ändert eine DOMRectReadOnly-Instanz nicht: Im strikten Modus löst sie einen TypeError aus, sonst wird sie ignoriert. Wenn du eine andere Breite brauchst, erstelle ein neues Rechteck oder verwende die beschreibbare Eigenschaft width eines DOMRect. DOMRectReadOnly ist eine Web-API und kein Teil von ECMAScript. Prüfe, ob deine Zielumgebung sie unterstützt.
Beispiele
(() => {
"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}`);
}
})();Ergebnis
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Führe den Code in der Konsole eines Browsers mit Unterstützung für `DOMRectReadOnly` aus, um die native API zu verwenden. Ist `DOMRectReadOnly` nicht verfügbar, wie in Node.js, bildet das Beispiel nur `width`, `left` und `right` lokal nach. Die negative Breite bleibt `-4.5`, und die Zuweisung im strikten Modus löst einen `TypeError` aus, den das Beispiel abfängt.
Zugehörige Lektionen
- JavaScript · Lektion 32 · Mittlere Stufe · Version: 3