HTMLImageElement: y-Eigenschaft

Die schreibgeschützte HTMLImageElement-Eigenschaft y gibt die y-Koordinate des oberen Randes des <img>-Elements relativ zum Ursprung des Stamm-Elements an.

Die Eigenschaften x und y sind nur dann für ein Bild gültig, wenn seine display-Eigenschaft den berechneten Wert table-column oder table-column-group hat. Anders ausgedrückt: Es hat entweder einen dieser Werte explizit gesetzt oder erbt sie von einem umgebenden Element oder durch seine Position in einer durch <col> oder <colgroup> beschriebenen Spalte.

Wert

Ein ganzzahliger Wert, der den Abstand in Pixeln vom oberen Rand des nächsten Stamm-Elements zum oberen Rand des Rahmenkastens des <img>-Elements angibt. Das nächste Stamm-Element ist das äußerste <html>-Element, das das Bild enthält. Befindet sich das Bild in einem <iframe>, ist y relativ zu diesem Frame.

Im unten stehenden Diagramm ist der obere Rand des blauen Bereichs der obere Rand des Innenabstands. Der von y zurückgegebene Wert wäre also der Abstand von diesem Punkt zum oberen Rand des Inhaltsbereichs.

Diagramm, das die Beziehungen zwischen den verschiedenen mit einem Element verbundenen Kästen zeigt

Hinweis: Die y-Eigenschaft ist nur dann gültig, wenn der berechnete Wert der display-Eigenschaft des Bildes entweder table-column oder table-column-group ist; mit anderen Worten, einer dieser Werte ist direkt auf dem <img> gesetzt oder wird von einem umgebenden Element geerbt, oder durch seine Position in einer durch <col> oder <colgroup> beschriebenen Spalte.

Beispiel

Siehe HTMLImageElement.x für Beispielcode, der die Verwendung von HTMLImageElement.y (und HTMLImageElement.x) demonstriert.

Spezifikationen

Specification
CSSOM View Module
# dom-htmlimageelement-y

Browser-Kompatibilität

BCD tables only load in the browser