X

Headline

This is an important message requiring you to make a choice if you're based in the EU.

CSS border-color Property

The CSS border-color property is a shorthand for setting the color of the four sides of an element's border. It is shorthand for the following properties:

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 of the border-color property:

<!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 of the border-color property with 3 values:

<!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.

Example of the border-color property with hexadecimal, RGB, HSL and named color values:

<!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.

Browser support

1.0+ 12.0+ 1.0+ 1.0+ 3.5+

Practice Your Knowledge

If the border-color has three values



Do you find this helpful?

Related articles