The margin-block
CSS shorthand property defines the logical block start and end margins of an element, which maps to physical margins depending on the element's writing mode, directionality, and text orientation.
/* <length> values */ margin-block: 10px 20px; /* An absolute length */ margin-block: 1em 2em; /* relative to the text size */ margin-block: 5% 2%; /* relative to the nearest block container's width */ margin-block: 10px; /* sets both start and end values */ /* Keyword values */ margin-block: auto; /* Global values */ margin-block: inherit; margin-block: initial; margin-block: unset;
These values corresponds to the margin-top
and margin-bottom
, or margin-right
, and margin-left
property depending on the values defined for writing-mode
, direction
, and text-orientation
.
Constituent properties
This property is a shorthand for the following CSS properties:
Syntax
Values
The margin-block
property takes the same values as the margin-left
property.
Formal definition
Initial value | 0 |
---|---|
Applies to | same as margin |
Inherited | no |
Percentages | depends on layout model |
Computed value | if specified as a length, the corresponding absolute length; if specified as a percentage, the specified value; otherwise, auto |
Animation type | discrete |
Formal syntax
<'margin-left'>{1,2}
Examples
Setting block start and end margins
HTML
<div> <p class="exampleText">Example text</p> </div>
CSS
div { background-color: yellow; width: 120px; height: 120px; } .exampleText { writing-mode: vertical-rl; margin-block: 20px 40px; background-color: #c8c800; }
Result
Specifications
Specification | Status | Comment |
---|---|---|
CSS Logical Properties and Values Level 1 The definition of 'margin-block' in that specification. |
Editor's Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
margin-block | Chrome
Full support
69
| Edge
Full support
79
| Firefox Full support 66 | IE No support No | Opera Full support 56 | Safari No support No | WebView Android Full support 69 | Chrome Android
Full support
69
| Firefox Android Full support 66 | Opera Android Full support 48 | Safari iOS No support No | Samsung Internet Android Full support 10.0 |
Legend
- Full support
- Full support
- No support
- No support
- User must explicitly enable this feature.
- User must explicitly enable this feature.
See also
- The mapped physical properties:
margin-top
,margin-right
,margin-bottom
, andmargin-left
writing-mode
,direction
,text-orientation