border-top-color

Summary

The border-top-color CSS property sets the color of the top border of an element. Note that in many cases the shorthand CSS properties border-color or border-top are more convenient and preferable.

Syntax

border-top-color: red;
border-top-color: rgb(255, 128, 0);
border-top-color: hsla(100%, 50%, 25%, 0.75);
border-top-color: #ffbb00;
border-top-color: currentColor;
border-top-color: transparent;

border-top-color: inherit;

Values

<color>

Is a <color> CSS value describing the color of the top border.

inherit

Is a keyword denoting the color of the top border of the parent's element (which may be different from the border-top-color default value)

Formal syntax

<color>
where 
<color> = <rgb()> | <rgba()> | <hsl()> | <hsla()> | <hex-color> | <named-color> | currentcolor | <deprecated-system-color>
where 
<rgb()> = rgb( <rgb-component>#{3} )
<rgba()> = rgba( <rgb-component>#{3} , <alpha-value> )
<hsl()> = hsl( <hue>, <percentage>, <percentage> )
<hsla()> = hsla( <hue>, <percentage>, <percentage>, <alpha-value> )
<named-color> = <ident>
<deprecated-system-color> = ActiveBorder | ActiveCaption | AppWorkspace | Background | ButtonFace | ButtonHighlight | ButtonShadow | ButtonText | CaptionText | GrayText | Highlight | HighlightText | InactiveBorder | InactiveCaption | InactiveCaptionText | InfoBackground | InfoText | Menu | MenuText | Scrollbar | ThreeDDarkShadow | ThreeDFace | ThreeDHighlight | ThreeDLightShadow | ThreeDShadow | Window | WindowFrame | WindowText
where 
<rgb-component> = <integer> | <percentage>
<alpha-value> = <number>
<hue> = <number>

Examples

A simple div with a border

HTML Content

<div class="mybox">
  <p>This is a box with a border around it.
     Note which side of the box is
     <span class="redtext">red</span>.</p>
</div>

CSS Content

.mybox {
  border: solid 0.3em gold;
  border-top-color: red;
  width: auto;
}

.redtext {
  color: red;
}

Result

Specifications

Browser compatibility

[1] Gecko-based browsers like Firefox also supports the non-standard -moz-border-top-colors CSS properties that sets the top border to multiple colors.

See also

• The border-related CSS shorthand properties border, border-top, and border-color.
• The color-related CSS properties applying to the other borders: border-right-color, border-bottom-color, and border-left-color.
• The other border-related CSS properties applying to the same border: border-top-style and border-top-width.