HTMLImageElement : propriété y
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 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.
Note :
La propriété y n'est valide que si la valeur calculée de la propriété display de l'image est table-column ou table-column-group : soit l'une de ces valeurs est définie directement sur l'élément <img>, soit elle est héritée d'un parent, soit l'image se trouve dans une colonne définie par <col> ou <colgroup>.
Exemple
Voir HTMLImageElement.x pour un exemple de code qui montre l'utilisation de HTMLImageElement.y (et HTMLImageElement.x).
Spécifications
| Specification |
|---|
| CSSOM View Module # dom-htmlimageelement-y |
Compatibilité des navigateurs
Loading…