This page is In Progress

Notice: The WebPlatform project has been discontinued when the Stewards partnership agreement ended in September 2015. This site has been frozen, and the assets we have created will remain.

border-top

Summary

Shorthand property that defines the border-width, border-style and border-color of an element’s top border in a single declaration. Note that you can use the corresponding longhand properties to set specific individual properties of the top border — border-top-width, border-top-style and border-top-color.

Overview table

Initial value
For style values, the initial value is none. For color values, the initial value is currentColor. For width values, the initial value is medium, which is computed as about 3px in most browsers..
Applies to
All elements
Inherited
No
Media
visual
Computed value
String representation “For <code>style … slucent colors.” is too long.
Animatable
Yes
CSS Object Model Property
borderTop
Percentages
N/A

Syntax

  • border-top: border-width border-style color
  • border-top: inherit

Values

border-width border-style color
The border-top property can contain up to three components:
  • border-width: This takes a numeric value with any of the standard length units.
  • border-style: This takes any of the range of style values available to the border-style property, which includes none, hidden, dotted, dashed, solid, double, groove, ridge, inset, outset. For more details about each, see the border-style page.
  • color: This can take any valid CSS color as its value.
inherit
When we set the value to inherit, the element will inherit the border values set on its parent.

Examples

A simple example showing multiple <div>s, identical in style except that they have different border-top properties applied to them.

<div class="one"><p>One</p></div>
<div class="two"><p>Two</p></div>
<div class="three"><p>Three</p></div>
<div class="four"><p>Four</p></div>
<div class="five"><p>Five</p></div>

View live example

/**
 * border-top example
**/

div {
  width: 150px;
  height: 50px;
  margin: 1rem;
  float: left;
}

p {
  padding: 0.25rem;
}

.one {
  /* The most basic border-top example you can show. */
  border-top: 1px solid black;
}

.two {
  /* If you don't explicitly set a color, currentColor is used, which
     equates to the text colour of the element, in this case black.   */
  border-top: 4px dashed;
}

.three {
  /* When no width is specified, the default width medium is used,
     which computes to about 3px in most browsers */
  border-top: dotted red;
}

.four {
  /* When no border style is specified, the border won't appear,
     as the default border style is none. */
  border-top: 10px black;
}

.five {
  /* A more interesting border example to round things off,
     showing a basic border being set, and then the right
     border being overridden */
  border: 1px inset black;
  border-top: 10px inset rgba(234,190,50,0.75);
}

View live example

Usage

 * It is usual to use the border-top property to set the default state of a box's top border, and then override individual values using more specific propeties, such as border-top-width or border-top-color.
  • border-top can be used as a divider between vertically laid out items, such as a vertical navigation menu, or table cells.

See also

Related articles

Border

Related pages