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 der oberen Randkante des <img>-Elements relativ zum Ursprung des Root-Elements an.

Die x- und y-Eigenschaften sind nur für ein Bild gültig, wenn dessen display-Eigenschaft den berechneten Wert table-column oder table-column-group hat. Anders gesagt: Es hat entweder einen dieser Werte explizit gesetzt, diesen von einem umschließenden Element geerbt, oder befindet sich in einer Spalte, die entweder durch <col> oder <colgroup> beschrieben wird.

Wert

Ein ganzzahliger Wert, der den Abstand in Pixeln von der oberen Kante des nächstgelegenen Root-Elements bis zur oberen Kante des Randrahmens des <img>-Elements angibt. Das nächstgelegene Root-Element ist das äußerste <html>-Element, das das Bild enthält. Wenn sich das Bild in einem <iframe> befindet, bezieht sich y relativ auf dieses Frame.

Im untenstehenden Diagramm ist die obere Randkante die Oberkante des blauen Padding-Bereichs. Der von y zurückgegebene Wert wäre daher der Abstand von diesem Punkt bis zur oberen Kante des Inhaltsbereichs.

Diagramm, das die Beziehungen zwischen den verschiedenen Kästen, die zu einem Element gehören, zeigt

Hinweis: Die y-Eigenschaft ist nur gültig, wenn der berechnete Wert der display-Eigenschaft des Bildes entweder table-column oder table-column-group ist. Anders gesagt: Einer dieser Werte wurde entweder direkt auf das <img> gesetzt, wurde von einem umschließenden Element geerbt oder stammt von einer Spalte, die entweder durch <col> oder <colgroup> beschrieben wird.

Beispiel

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

Spezifikationen

Specification
CSSOM View Module
# dom-htmlimageelement-y

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
y

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Has more compatibility info.