Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

block-size

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

La propriété CSS block-size définit la taille du bloc d'un élément selon l'axe du bloc. Si le mode d'écriture (writing-mode) est horizontal, cela correspond à la propriété height ; si le mode d'écriture est vertical, cela correspond à la propriété width. Une propriété associée est inline-size, qui définit l'autre dimension de l'élément.

Exemple interactif

block-size: 150px;
writing-mode: horizontal-tb;
block-size: 150px;
writing-mode: vertical-rl;
block-size: auto;
writing-mode: horizontal-tb;
block-size: auto;
writing-mode: vertical-lr;
<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    Ceci est une boîte où vous pouvez modifier la valeur de block-size.
  </div>
</section>
#example-element {
  display: flex;
  flex-direction: column;
  background-color: #5b6dcd;
  justify-content: center;
  color: white;
}

Syntaxe

css
/* Valeurs de longueur <length> */
block-size: 300px;
block-size: 25em;
block-size: anchor-size(height);
block-size: calc(anchor-size(--my-anchor block) * 0.75);

/* Valeurs en pourcentage <percentage> */
block-size: 75%;

/* Valeurs avec un mot-clé */
block-size: max-content;
block-size: min-content;
block-size: fit-content;
block-size: fit-content(20em);
block-size: auto;

/* Valeurs globales */
block-size: inherit;
block-size: initial;
block-size: revert;
block-size: revert-layer;
block-size: unset;

Valeurs

La propriété block-size peut prendre les mêmes valeurs que width et height.

Définition formelle

Valeur initialeauto
Applicabilitéidentique à width et à height
Héritéenon
Pourcentagesla taille de bloc du bloc englobant
Valeur calculéeidentique à width et à height
Type d'animationune longueur, pourcentage ou calc() ;

Syntaxe formelle

block-size = 
<'width'>

<width> =
auto |
<length-percentage [0,∞]> |
min-content |
max-content |
fit-content( <length-percentage [0,∞]> ) |
<calc-size()> |
<anchor-size()> |
stretch |
fit-content |
contain

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

<calc-size()> =
calc-size( <calc-size-basis> , <calc-sum> )

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

<calc-size-basis> =
<size-keyword> |
<calc-size()> |
any |
<calc-sum>

<calc-sum> =
<calc-product> [ [ '+' | '-' ] <calc-product> ]*

<anchor-name> =
<dashed-ident>

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

<calc-product> =
<calc-value> [ [ '*' | / ] <calc-value> ]*

<calc-value> =
<number> |
<dimension> |
<percentage> |
<calc-keyword> |
( <calc-sum> )

<calc-keyword> =
e |
pi |
infinity |
-infinity |
NaN

Exemples

Taille de bloc avec texte vertical

HTML

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

CSS

css
.texteExemple {
  writing-mode: vertical-rl;
  background-color: yellow;
  block-size: 200px;
}

Résultat

Spécifications

Specification
CSS Logical Properties and Values Module Level 1
# dimension-properties
CSS Box Sizing Module Level 4
# sizing-values

Compatibilité des navigateurs

Voir aussi