`border-block-style` CSS property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It's been available across browsers since September 2021.
The border-block-style CSS property defines the style of the logical block borders of an element, which maps to a physical border style depending on the element's writing mode, directionality, and text orientation. It corresponds to the border-top-style and border-bottom-style, or border-left-style and border-right-style properties depending on the values defined for writing-mode, direction, and text-orientation.
The border style in the other dimension can be set with border-inline-style, which sets border-inline-start-style, and border-inline-end-style.
Try it
border-block-style: dotted; writing-mode: horizontal-tb;
border-block-style: dotted; writing-mode: vertical-rl;
border-block-style: groove; writing-mode: horizontal-tb; direction: rtl;
<section class="default-example" id="default-example">
<div class="transition-all" id="example-element">
This is a box with a border around it.
</div>
</section>
#example-element {
background-color: #eeeeee;
color: black;
border: 0.75em solid;
padding: 0.75em;
width: 80%;
height: 100px;
unicode-bidi: bidi-override;
}
Syntax
/* Keyword values */ border-block-style: dashed; border-block-style: dotted; border-block-style: groove; /* Global values */ border-block-style: inherit; border-block-style: initial; border-block-style: revert; border-block-style: revert-layer; border-block-style: unset;
Values
-
<line-style> - The line style of the border. See
border-style.
Formal definition
| Initial value | as each of the properties of the shorthand: |
|---|---|
| Applies to | all elements |
| Inherited | no |
| Computed value | as each of the properties of the shorthand: |
| Animation type | discrete |
Formal syntax
border-block-style =
<'border-top-style'>{1,2}
Examples
Dashed border with vertical text
HTML
<div> <p class="exampleText">Example text</p> </div>
CSS
div {
background-color: yellow;
width: 120px;
height: 120px;
}
.exampleText {
writing-mode: vertical-lr;
border: 5px solid blue;
border-block-style: dashed;
}
Results
Specifications
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on iOS | Samsung Internet | WebView Android | WebView on iOS | |
border-block-style |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
dashed |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
dotted |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
double |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
groove |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
hidden |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
inset |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
none |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
outset |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
ridge |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
solid |
87 |
87 |
66 |
73 |
14.1 |
87 |
66 |
62 |
14.5 |
14.0 |
87 |
14.5 |
See also
- CSS Logical Properties and Values
- This property maps to one of the physical border properties:
border-top-style,border-right-style,border-bottom-style, orborder-left-style. -
writing-mode,direction,text-orientation
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/border-block-style