HTMLImageElement: border property
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
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
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:
const img = new Image();
img.src = "example.png";
img.style.border = "1px solid black";
Specifications
| Specification |
|---|
| HTML # dom-img-border |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
border
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Deprecated. Not for use in new websites.