HTMLImageElement: y 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

只讀的 HTMLImageElement 屬性 y 指示 <img> 元素的頂邊框邊緣相對於根元素原點的 y 座標。

僅當 xy 屬性的 display 屬性的計算值為 table-columntable-column-group 時,它們才對影像有效。換句話說:它們中的任何一個被顯式設定在其上,或者它從包含元素繼承了該值,或者透過位於由 <col><colgroup> 描述的列中。

一個整數值,表示從元素最近的根元素的頂邊到 <img> 元素的邊框框的頂邊的距離(以畫素為單位)。最近的根元素是包含該影像的最外層的 <html> 元素。如果影像位於 <iframe> 中,則其 y 值是相對於該框架的。

在下面的圖表中,頂邊框邊緣是藍色填充區域的頂邊。因此,y 返回的值將是從該點到內容區域頂邊的距離。

Diagram showing the relationships between the various boxes associated with an element

注意: 僅當影像的 display 屬性的計算值為 table-columntable-column-group 時,y 屬性才有效;換句話說,其中任何一個都直接設定在 <img> 上,或者它們從包含元素繼承而來,或者透過位於由 <col><colgroup> 描述的列中。

示例

有關演示 HTMLImageElement.y(和 HTMLImageElement.x)用法的示例程式碼,請參閱 HTMLImageElement.x

規範

規範
CSSOM 檢視模組
# dom-htmlimageelement-y

瀏覽器相容性