ObsoleteThis feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.
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
.
Syntax
htmlImageElement.border = thickness; let thickness = htmlImageElement.border;
Value
A DOMString
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
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 | Status | Comment |
---|---|---|
HTML Living StandardThe definition of 'HTMLImageElement.border' in that specification. | Living Standard | |
HTML 4.01 SpecificationThe definition of 'HTMLImageElement.border' in that specification. | Recommendation |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
border
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
? |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support Yes |
Opera Android
? |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
HTMLImageElement.border by Mozilla Contributors is licensed under CC-BY-SA 2.5.