border-top-width

The border-top-width CSS property sets the width of the top border of an element.

Syntax

/* Keyword values */
border-top-width: thin;
border-top-width: medium;
border-top-width: thick;

/* <length> values */
border-top-width: 10em;
border-top-width: 3vmax;
border-top-width: 6px;

/* Global keywords */
border-top-width: inherit;
border-top-width: initial;
border-top-width: unset;

Values

<line-width>
Defines the width of the border, either as an explicit nonnegative <length> or a keyword. If it's a keyword, it must be one of the following values:
  • thin
  • medium
  • thick

Note: Because the specification doesn't define the exact thickness denoted by each keyword, the precise result when using one of them is implementation-specific. Nevertheless, they always follow the pattern thin ≤ medium ≤ thick, and the values are constant within a single document.

Formal definition

Initial valuemedium
Applies toall elements. It also applies to ::first-letter.
Inheritedno
Computed valuethe absolute length or 0 if border-top-style is none or hidden
Animation typea length

Formal syntax

<line-width>

where
<line-width> = <length> | thin | medium | thick

Examples

HTML

<div>Element 1</div>
<div>Element 2</div>

CSS

div {
  border: 1px solid red;
  margin: 1em 0;
}

div:nth-child(1) {
  border-top-width: thick;
}
div:nth-child(2) {
  border-top-width: 2em;
}

Result

Specifications

Specification Status Comment
CSS Backgrounds and Borders Module Level 3
The definition of 'border-top-width' in that specification.
Candidate Recommendation No significant change.
CSS Level 2 (Revision 1)
The definition of 'border-top-width' in that specification.
Recommendation No significant change.
CSS Level 1
The definition of 'border-top-width' in that specification.
Recommendation Initial definition.

Browser compatibility

BCD tables only load in the browser

See also