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.
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