HTMLImageElement: border property

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

The deprecated border property of the HTMLImageElement interface specifies the number of pixels thick the border surrounding the image should be. A value of 0, the default, indicates that no border should be drawn. It reflects the <img> element's border content attribute.

You should instead use the CSS property border or its longhand properties to not only set the thickness of the border but also to potentially apply a wide variety of other styling options to it.

Value

A string containing an integer value specifying the thickness of the border that should surround the image, in CSS pixels. A value of 0, or an empty string, indicates that there should be no border drawn. The default value of border is 0.

When set to the null value, that null value is converted to the empty string (""), so elt.border = null is equivalent to elt.border = "".

Examples

Setting the border attribute

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

Instead of using the deprecated border property, consider setting the CSS border property instead:

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

Specifications

Specification
HTML
# dom-img-border

Browser compatibility