CSS border-color Property

The border-color CSS property is a shorthand for setting the color of the four sides of an element's border: border-top-color, border-right-color, border-bottom-color, border-left-color. Each side can have its own value. The border-color property is used with the border-style property. If the value is 0, the border-color property has no effect.

This property takes any CSS colors value. Default color is the current color of the element.

The border-color property can have 4 values. If it has one value, the color is applied to all four borders. If it has two values, the first value is set to the top and bottom borders, the second value is set to the right and left. If it has three values, the first one is applied to the top border, the second one to the right and left, and the third one to the bottom. If it has four values the first is set to the top, the second to the right, the third to the bottom and the fourth to the left.

Initial Value currentColor
Applies to All elements. It also applies to ::first-letter.
Inherited No.
Animatable Yes. The borders of the box are animatable.
Version CSS1
DOM Syntax object.style.borderStyle = "dotted double";

Syntax

border-color: color | transparent | initial | inherit;

Here we have an example where only one value is applied. It sets the color to all fours sides of the element.

Example

<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      .dotted {
        border-style: dotted;
        border-color: #1c87c9;
        padding: 5px;
      }
    </style>
  </head>
  <body>
    <div class="dotted">Example with blue dotted border.</div>
  </body>
</html>

Let’s see another example where three values are applied. The first one is used to the top border, the second one to the right and left, and the third one to the bottom.

Example

<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      .solid {
        border-style: solid;
        border-color: #1c87c9 cyan yellow #8ebf42;
        padding: 5px;
      }
    </style>
  </head>
  <body>
    <div class="solid">Example with border-color property.</div>
  </body>
</html>

You can set hexadecimal, RGB, RGBA, HSL, HSLA or color names as a value for the border-color property.

Learn more about HTML Colors.

Now, let’s see an example illustrated with hexadecimal, RGB, HSL and named color values set for the border-color .

Example

<!DOCTYPE html>
<html>
  <head>
    <style> 
      p {
      border: 5px solid #666;
      width: 60%;
      padding: 5px;
      }
      .name {  
      border-color: lightblue;
      }
      .hex {
      border-color: #1c87c9;
      }
      .rgb { 
      border-color: rgba(0,0,0,0.15);
      }
      .hsl { 
      border-color:  hsl(89, 43%, 51%);
      }
    </style>
  </head>
  <body>
    <p class="name">Border with a named color.</p>
    <p class="hex">Border with a hexadecimal value.</p>
    <p class="rgb">Border with a RGB color value.</p>
    <p class="hsl">Border with a HSL color value.</p>
  </body>
</html>

Values

Value Description
color Sets a color for the borders. Default color is the current color of the element. Color names, hexadecimal color codes, rgb(), rgba(), hsl(), hsla() can be used. Required value.
transparent Makes the border color transparent.
initial Sets the property to its default value.
inherit Inherits the property from its parent element.

Related resources

Border, border-style, CSS colors, border-top-color, border-right-color, border-bottom-color, border-left-color.

Browser support

1.0+ 12.0+ 1.0+ 1.0+ 3.5+

Practice Your Knowledge

If the border-color has three values




Related articles