border-block - CSS | MDN (original) (raw)

Try it

border-block: solid;
writing-mode: horizontal-tb;

border-block: dashed red;
writing-mode: vertical-rl;

border-block: 1rem solid;
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: darkmagenta;
  padding: 0.75em;
  width: 80%;
  height: 100px;
  unicode-bidi: bidi-override;
}

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

border-block: 1px;
border-block: 2px dotted;
border-block: medium dashed blue;

/* Global values */
border-block: inherit;
border-block: initial;
border-block: revert;
border-block: revert-layer;
border-block: unset;

Values

The border-block is specified with one or more of the following, in any order:

<'border-width'>

The width of the border. See border-width.

<'border-style'>

The line style of the border. See border-style.

The color of the border.

border-block can be used to set the values for one or more of border-block-width, border-block-style, and border-block-color setting both the start and end in the block dimension at once. The physical borders to which it maps depends on the element's writing mode, directionality, and text orientation. It corresponds to the border-top and border-bottom or border-right, and border-left properties depending on the values defined for writing-mode, direction, and text-orientation.

The borders in the other dimension can be set with border-inline, which sets border-inline-start, and border-inline-end.

Formal definition

Initial value	as each of the properties of the shorthand:border-block-width: mediumborder-block-style: noneborder-block-color: currentcolor
Applies to	all elements
Inherited	no
Computed value	as each of the properties of the shorthand:border-block-width: absolute length; 0 if the border style is none or hiddenborder-block-style: as specifiedborder-block-color: computed color
Animation type	as each of the properties of the shorthand:border-block-width: by computed value typeborder-block-style: discreteborder-block-color: by computed value type

Formal syntax

border-block =
<'border-block-start'>

=
||
||

=
<length [0,∞]> |
thin |
medium |
thick

Examples

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-rl;
  border-block: 5px dashed blue;
}

Results

Specifications

Specification
CSS Logical Properties and Values Level 1 # propdef-border-block