In order to access this site you need to enable JavaScript!

You are here: Reference > JavaScript > client-side > style handling > properties > borderWidth

borderWidth style property

Browser support:

Specifies or returns the width of the element's border.

Syntax:

object.borderWidth;

You can find the related objects in the Supported by objects section below.

This property is read/write.

CSS page for this property: border-width

Possible values:

The type of this property is string.

One of the following values:

•

This value can be used from 1 to 4 times (use the space character to separate them)

•

One of the following values:

•	<border width in non-negative length>
•	medium
•	thin
•	thick

•

inherit

Description of values:

border width in non-negative length

The width of the border in length units. For the supported length units, see the length page.

inherit

Takes the value of this property from the computed style of the parent element.

medium

Default.

thick

Greater than the medium width.

thin

Less than the medium width.

Default: medium.

If only one border-width value is set, it is used for all four borders.
If two border-width values are specified, the first value is used for the top and bottom borders, the second one is for the left and right borders.
If three border-width values are set, the first value is used for the top border, the second one is for the left and right borders and the third one is for the bottom border.
If four border-width values are specified, the order is top, right, bottom, left (clockwise from top).

Example HTML code 1:

This example illustrates the use of the border-width property:

<head>
    <style>
        .example {
            border-color: blue;
            border-width: 1px;
            border-style: solid;
        }
    </style>
</head>
<body>
    <div class="example">Border-width: 1px</div>
</body>

Copy Code

Preview

Syntax Highlighter

Did you find this example helpful? yes no

Example HTML code 2:

This example illustrates the use of the borderWidth property in JavaScript:

<head>
    <script type="text/javascript">
        function ChangeBorder (selectTag) {
            // Returns the index of the selected option
            var whichSelected = selectTag.selectedIndex;

            // Returns the text of the selected option
            var selectState = selectTag.options[whichSelected].text;

            var div = document.getElementById ("myDiv");
            div.style.borderWidth = selectState;
        }
    </script>
</head>
<body>
    <div id="myDiv" style="border: 1px solid blue">Sample division with border</div>

    <select onchange="ChangeBorder (this);" size="5">
        <option selected="selected" />1px
        <option />3px
        <option />8px
        <option />15px
        <option />24px
    </select>
</body>