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é n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.

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

Specification
HTML
# dom-img-border

Compatibilité des navigateurs