margin-block

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.

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La propriété margin-block définit la marge sur les côtés de l'élément qui sont ceux de l'axe de bloc. Cette propriété logique peut correspondre à différentes marges selon le mode d'écriture de l'élément, sa direction ou l'orientation du texte. Autrement dit, cette propriété peut correspondre aux propriétés margin-top et margin-bottom ou à margin-right et margin-left selon les valeurs des propriétés writing-mode, direction et text-orientation.

css
/* Valeurs de longueur */
/* Type <length> */
margin-block: 10px 20px; /* Une longueur absolue */
margin-block: 1em 2em; /* Une longueur relative à la taille du texte */
margin-block: 5% 2%; /* Une longueur relative à la largeur ou hauteur du bloc englobant */
margin-block: 10px; /* Une valeur utilisée pour les deux côtés */

/* Valeurs avec un mot-clé */
margin-block: auto;

/* Valeurs globales */
margin-block: inherit;
margin-block: initial;
margin-block: unset;

Cette propriété est une propriété raccourcie pour les deux propriétés logiques margin-block-start et margin-block-end. Pour régler les marges selon l'axe en ligne, on pourra utiliser la propriété logique raccourcie margin-inline qui correspond aux propriétés margin-inline-start et margin-inline-end.

Syntaxe

Valeurs

La propriété margin-block peut prendre les mêmes valeurs que la propriété margin-left.

Définition formelle

Valeur initialepour chaque propriété individuelle de la propriété raccourcie :
Applicabilitéidentique à margin
Héritéenon
Pourcentagesdépend du modèle en couches
Valeur calculéepour chaque propriété individuelle de la propriété raccourcie :
  • margin-block-start: si spécifié par une longueur, la valeur absolue correspondante; si spécifié par un pourcentage, la valeur telle que spécifiée; sinon, auto
  • margin-block-end: si spécifié par une longueur, la valeur absolue correspondante; si spécifié par un pourcentage, la valeur telle que spécifiée; sinon, auto
Type d'animationune longueur

Syntaxe formelle

margin-block = 
  <'margin-top'>{1,2}  

<margin-top> = 
  <length-percentage>  |
  auto                 |
  <anchor-size()>      

<length-percentage> = 
  <length>      |
  <percentage>  

<anchor-size()> = 
  anchor-size( [ <anchor-name> || <anchor-size> ]? , <length-percentage>? )  

<anchor-name> = 
  <dashed-ident>  

<anchor-size> = 
  width        |
  height       |
  block        |
  inline       |
  self-block   |
  self-inline

Exemples

CSS

css
div {
  background-color: yellow;
  width: 120px;
  height: 120px;
}

.texteExemple {
  writing-mode: vertical-rl;
  margin-block: 20px 40px;
  background-color: #c8c800;
}

HTML

html
<div>
  <p class="texteExemple">Texte d'exemple</p>
</div>

Résultat

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi