HTMLImageElement : propriété y

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété en lecture seule y de l'interface HTMLImageElement indique la coordonnée y du bord supérieur de l'élément HTML <img> par rapport à l'origine de l'élément racine.

Les propriétés x et y ne sont valides pour une image que si sa propriété display a pour valeur calculée table-column ou table-column-group. Cela signifie que l'une de ces valeurs est définie explicitement, héritée d'un élément parent, ou appliquée parce que l'image se trouve dans une colonne définie par <col> ou <colgroup>.

Valeur

Un entier indiquant la distance en pixels entre le bord supérieur de l'élément racine le plus proche et le bord supérieur de la boîte de bordure de l'élément HTML <img>. L'élément racine le plus proche est l'élément <html> le plus à l'extérieur qui contient l'image. Si l'image est dans un élément HTML <iframe>, sa valeur y est relative à ce cadre.

Dans le schéma ci-dessous, le bord supérieur correspond au bord supérieur de la zone de remplissage bleue. La valeur retournée par y est donc la distance entre ce point et le bord supérieur de la zone de contenu.

Schéma montrant les relations entre les différentes boîtes associées à un élément