margin-block
============

**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 initiale | pour chaque propriété individuelle de la propriété raccourcie :* `margin-block-start`: `0`
* `margin-block-end`: `0`
 |
| Applicabilité | identique à `margin` |
| Héritée | non |
| Pourcentages | dépend du modèle en couches |
| Valeur calculée | pour 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'animation | une longueur |

Syntaxe formelle
----------------
```

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

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 with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Les propriétés physiques correspondantes : `margin-top`, `margin-right`, `margin-bottom` et `margin-left`
* Les propriétés qui influencent les propriétés logiques `writing-mode`, `direction`, `text-orientation`