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 obsolete HTMLImageElement
property border 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.
You should not use this property! Instead, you should use CSS to style the
border. The border property or its longhand properties to not only set
the thickness of the border but to potentially apply a wide variety of other styling
options to it.
The width, specifically, is controlled using the writing-mode aware
border-block-start-width, border-block-end-width,
border-inline-start-width, and border-inline-end-width
properties.
For compatibility (or perhaps other) reasons, you can use the older properties instead
(or in addition): border-top-width, border-right-width,
border-bottom-width, and border-left-width.
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 = "".
Usage notes
Do not use border. It is obsolete. Instead, use the CSS
border property and its longhand properties to establish borders around
images.
For example, if you have the following HTML:
<img src="image.png" border="2" />
The following will provide the same appearance using CSS instead of this obsolete property:
<img src="image.png" style="border: 2px;" />
You can further provide additional information to change the color and other features of the border:
<img src="image.png" style="border: dashed 2px #333388;" />
Specifications
| Specification |
|---|
| HTML Standard # dom-img-border |
Browser compatibility
BCD tables only load in the browser