HTMLImageElement: y-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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.
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