Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLImageElement : propriété border

Obsolète

Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.

La propriété obsolète border de l'interface HTMLImageElement définit le nombre de pixels d'épaisseur que doit avoir la bordure entourant l'image. Une valeur de 0, la valeur par défaut, indique qu'aucune bordure ne doit être dessinée. Elle reflète l'attribut de contenu border de l'élément HTML <img>.

Il est recommandé d'utiliser la propriété CSS border ou ses propriétés détaillées, qui permettent non seulement de définir l'épaisseur de la bordure mais aussi d'appliquer de nombreuses autres options de mise en forme.

Valeur

Une chaîne de caractères contenant une valeur entière qui définit l'épaisseur de la bordure entourant l'image, en pixels CSS. Une valeur de 0 ou une chaîne vide indique qu'aucune bordure ne doit être dessinée. La valeur par défaut de border est 0.

Si on assigne la valeur null, celle-ci est convertie en chaîne vide (""), donc elt.border = null est équivalent à elt.border = "".

Exemples

Définir l'attribut border

js
const img = new Image();
img.src = "exemple.png";
img.border = "1";

Au lieu d'utiliser la propriété obsolète border, il est préférable de définir la propriété CSS border :

js
const img = new Image();
img.src = "exemple.png";
img.style.border = "1px solid black";

Spécifications

Spécification
HTML
# dom-img-border

Compatibilité des navigateurs