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: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

La propriété border (obsolète) de HTMLImageElement définit le nombre de pixels d'épaisseur de la bordure entourant l'image. Une valeur de 0, qui est la valeur par défaut, indique qu'aucune bordure ne doit être dessinée.

Vous ne devez pas utiliser cette propriété ! Utilisez plutôt CSS pour styliser la bordure. La propriété border ou ses propriétés détaillées permettent non seulement de définir l'épaisseur de la bordure, mais aussi d'appliquer de nombreuses autres options de présentation.

L'épaisseur, en particulier, se contrôle avec les propriétés sensibles à l'orientation d'écriture : border-block-start-width, border-block-end-width, border-inline-start-width, border-inline-end-width.

Pour des raisons de compatibilité (ou autres), vous pouvez utiliser les anciennes propriétés à la place (ou en complément) : border-top-width, border-right-width, border-bottom-width, border-left-width.

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 = "".

Notes d'utilisation

N'utilisez pas border. Cette propriété est obsolète. Utilisez plutôt la propriété CSS border et ses propriétés détaillées pour définir les bordures autour des images.

Par exemple, si vous avez le HTML suivant :

html
<img src="image.png" border="2" />

Le code suivant produira le même rendu en utilisant CSS à la place de cette propriété obsolète :

html
<img src="image.png" style="border: 2px;" />

Vous pouvez également préciser la couleur et d'autres caractéristiques de la bordure :

html
<img src="image.png" style="border: dashed 2px #333388;" />

Spécifications

Specification
HTML
# dom-img-border

Compatibilité des navigateurs