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

contain-intrinsic-inline-size

Baseline 2023
Newly available

Depuis September 2023, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La propriété logique CSS contain-intrinsic-inline-size définit la taille en ligne d'un élément que le navigateur peut utiliser pour la mise en page lorsque l'élément est soumis à la compartimentation de la taille.

La taille en ligne est la taille de l'élément dans la dimension parallèle au flux de texte au sein d'une ligne. Dans un mode d'écriture horizontal comme le français standard, la taille en ligne correspond à la dimension horizontale (largeur) ; dans un mode d'écriture vertical, elle correspond à la dimension verticale.

Syntaxe

css
/* Valeurs avec un mot-clé */
contain-intrinsic-inline-size: none;

/* Valeurs de type <length> */
contain-intrinsic-inline-size: 1000px;
contain-intrinsic-inline-size: 10rem;

/* Valeurs auto et <length> */
contain-intrinsic-inline-size: auto 300px;

/* Valeurs globales */
contain-intrinsic-inline-size: inherit;
contain-intrinsic-inline-size: initial;
contain-intrinsic-inline-size: revert;
contain-intrinsic-inline-size: revert-layer;
contain-intrinsic-inline-size: unset;

Valeurs

Les valeurs suivantes peuvent être spécifiées pour la taille en ligne intrinsèque d'un élément :

none

L'élément n'a pas de taille en ligne intrinsèque.

<length>

L'élément a la taille en ligne définie (<length>).

auto <length>

Lorsque l'élément est en compartimentation de taille et qu'il omet son contenu (par exemple, lorsqu'il est hors écran et que content-visibility: auto est défini), la taille en ligne est mémorisée à partir de la taille réelle de l'élément lors du dernier rendu de ses éléments enfants. Si l'élément n'a jamais rendu ses éléments enfants et n'a donc pas de valeur mémorisée pour la taille de l'élément rendu normalement, ou s'il n'omettait pas son contenu, la taille en ligne est la <length> définie.

Description

La propriété est généralement appliquée aux éléments susceptibles de déclencher la compartimentation de taille, tels que contain: size et content-visibility.

La compartimentation de taille permet à un agent utilisateur de disposer un élément comme s'il avait une taille fixe, évitant des recalculs de mise en page inutiles en évitant le rerendu des éléments enfants pour déterminer la taille réelle (améliorant ainsi l'expérience utilisateur). Par défaut, la compartimentation de taille considère les éléments comme s'ils n'avaient pas de contenu et peut contracter la mise en page de la même manière que si les contenus n'avaient ni largeur ni hauteur. La propriété contain-intrinsic-inline-size permet aux auteur·ice·s de définir une valeur appropriée à utiliser comme taille en ligne pour la mise en page.

La valeur auto <length> permet de mémoriser la taille en ligne d'un élément si celui‑ci a déjà été « rendu normalement » (avec ses éléments enfants), puis d'utiliser cette valeur mémorisée à la place de la valeur définie lorsque l'élément omet son contenu. Cela permet aux éléments hors écran avec content-visibility: auto de bénéficier de la compartimentation de taille sans que les développeur·euse·s aient à être aussi précis·e·s dans leurs estimations de la taille des éléments. La valeur mémorisée n'est pas utilisée si les éléments enfants sont en cours de rendu (si la compartimentation de taille est activée, la <length> définie est utilisée).

Définition formelle

Valeur initialenone
Applicabilitéelements for which size containment can apply
Héritéenon
Valeur calculéeas specified, with <length>s values computed
Type d'animationby computed value type

Syntaxe formelle

contain-intrinsic-inline-size = 
[ auto | from-element ]? [ none | <length [0,∞]> ]

Exemples

Définir la taille en ligne intrinsèque

Le HTML ci‑dessous définit un élément « contained_element » qui sera soumis à une contrainte de taille, et qui contient un élément enfant.

html
<div id="contained_element">
  <div class="child_element"></div>
</div>

Le CSS ci‑dessous règle content-visibility de contained_element sur auto, donc si l'élément est masqué il sera contraint en taille. La taille de bloc intrinsèque et la taille en ligne intrinsèque utilisées lorsque l'élément est contraint sont définies simultanément à l'aide de contain-intrinsic-block-size et contain-intrinsic-inline-size, respectivement.

css
#contained_element {
  border: 2px solid green;
  inline-size: 151px;
  content-visibility: auto;
  contain-intrinsic-inline-size: 152px;
  contain-intrinsic-block-size: 52px;
}
.child_element {
  border: 1px solid red;
  background: blue;
  block-size: 50px;
  inline-size: 150px;
}

Spécifications

Specification
CSS Box Sizing Module Level 4
# propdef-contain-intrinsic-inline-size

Compatibilité des navigateurs

Voir aussi