CSS Reference Property

border-top-style

The border-top-style property is used to specify the line style of the top border of an element (solid, double, dashed, etc.), unless there is a border image set.

Official Syntax

  • Syntax:

    border-top-style: none | hidden | dotted | dashed | solid | double | groove | ridge | inset | outset
  • Initial: none
  • Applies To: all elements
  • Animatable: no

Values

none

Displays no border. Color and width set on the border will be ignored. The border width value will be `0` unless there’s a border image set.

In case of table cell and border collapsing, the none value has the lowest priority: it means that if any other conflicting border is set, it will be displayed.

hidden

Similar to none, it displays no border. Color and width set on the border will be ignored. The border width value will be `0` unless there’s a border image set.

In case of table cell and border collapsing, the hidden value has the highest priority: it means that if any other conflicting border is set, it won’t be displayed.

dotted
Displays a border as a set of rounded dots. The radius of the dots is equal to half of the width of the border.
dashed
Displays a border as a series of square-ended dashes.
solid
Displays a border as a solid straight line.
double
Displays two parallel solid lines with some space between them. The thickness of the lines is not specified, but the sum of the lines and the space must equal to the value of the border-top-width property’s value.
groove
The displayed border looks as if it were carved in the canvas. This is typically achieved by creating a “shadow” from two colors that are slightly lighter and darker than the color specified using the border-top-color property.
ridge
The border looks as if it were coming out of the canvas in a 3D effect. It is the opposite of the effect achieved by the groove value.
inset

Displays a border that makes the element look as if it is “sunken” or embedded into the page.

When applied to a table cell with border-collapse set to collapsed, this value behaves like groove.

outset

Displays a border that makes the element look as if it is embossed with a 3D effect. It has the opposite of the effect achieved by the inset property.

When applied to a table cell with border-collapse set to collapsed, this value behaves like ridge.

Notes

The border style value can also be inherited from the element’s parent’s border style property.

The following image shows the result of applying any of the above styles to an element’s border.

borderstyles
The rendering of the predefined border styles.

Not all browsers may render the styles the same way. Chrome, for instance, currently renders the dots as rectangular dots not circular ones.

The specification does not specify the amount of spacing between the dots and the dashes. Browser implementations are encouraged to choose a spacing that makes the corners symmetrical.

The specification also does not define how borders of different styles should be joined in the corner. Also note that rounded corners may cause the corners and the contents to overlap, if the padding is less than the radius of the corner specified using the border-radius property.

The color of borders drawn for values of groove, ridge, inset, and outset depends on the element’s border color properties, but browsers may choose their own algorithm to calculate the actual colors used. For instance, if the border-top-color has the value silver, then a browser could use a gradient of colors from white to dark gray to indicate a sloping border.

Examples

The following are all valid border-top-style values set on an element. The element’s border width and border color are also set using the border-top-width and border-top-color respectively.

.element {
    border-top-width: 10px;
    border-top-color: red;

    border-top-style: dashed;
    /* or */
    border-top-style: inset;
    /* or */
    border-top-style: dotted;
}
                

Live Demo

Have a look at the live demo:

View this demo on the Codrops Playground

Browser Support

The property works in all major browsers: Chrome, Firefox, Safari, Opera, IE, and on Android and iOS.

Written by . Last updated February 4, 2015 at 2:52 pm by Manoela Ilic.

Do you have a suggestion, question or want to contribute? Submit an issue.