Propriété CSS position-try
Baseline 2026>
Nouvellement disponible
Depuis janvier 2026, 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.
Vous voulez une meilleure prise en charge pour cette fonctionnalité ? Dites-nous pourquoi.
La propriété raccourcie CSS position-try correspond aux propriétés position-try-order et position-try-fallbacks.
Propriétés constitutives
Cette propriété est un raccourci pour les propriétés CSS suivantes :
Syntaxe
/* position-try-fallbacks seulement */
position-try: normal flip-block;
position-try: top;
position-try: --position-essai-personnalise;
position-try: flip-block flip-inline;
position-try: top, right, bottom;
position-try: --position-essai-personnalise1, --position-essai-personnalise2;
position-try:
normal flip-block,
right,
--position-essai-personnalise;
/* position-try-order et position-try-fallbacks */
position-try: normal none;
position-try:
most-width --position-essai-personnalise1,
--position-essai-personnalise2;
position-try:
most-height flip-block,
right,
--position-essai-personnalise;
/* Valeurs globales */
position-try: inherit;
position-try: initial;
position-try: revert;
position-try: revert-layer;
position-try: unset;
Valeurs
Cette propriété est définie par l'une ou les deux valeurs suivantes :
position-try-orderFacultatif-
Un mot-clé qui définit l'ordre de priorité des options de repli d'essai de positionnement. Si vous l'omettez, la valeur par défaut est
normal. position-try-fallbacks-
Le mot-clé
none, ou une liste de valeurs<position-area>, d'options<try-tactic>et de positions personnalisées, séparées par des virgules.
Description
La propriété raccourcie position-try permet de définir les propriétés position-try-order et position-try-fallbacks dans une seule déclaration. Elle définit position-try-order et position-try-fallbacks, dans cet ordre. Si vous omettez la composante position-try-order, sa valeur par défaut est normal.
position-try-fallbacks est une liste, séparée par des virgules, d'une ou plusieurs options de repli pour l'essai de positionnement des éléments positionnés par rapport à une ancre associée. Lorsque l'élément déborde autrement de son bloc englobant modifié par les propriétés d'encart, le navigateur essaie de placer l'élément positionné à ces différentes positions de repli, dans l'ordre indiqué, et s'arrête dès qu'il trouve une valeur qui évite le débordement de son conteneur ou de la zone d'affichage.
position-try-order définit la priorité des options position-try-fallbacks appliquées à un élément positionné par rapport à une ancre lors de son premier affichage, selon l'option qui crée le plus d'espace autour de l'élément dans la direction donnée. Si vous l'omettez, cette propriété prend sa valeur initiale, normal, ce qui signifie que les options de repli d'essai de positionnement sont testées dans l'ordre où elles apparaissent dans la propriété.
Définition formelle
| Valeur initiale | pour chaque propriété individuelle de la propriété raccourcie :
|
|---|---|
| Applicabilité | éléments positionnés de manière absolue |
| Héritée | non |
| Pourcentages | pour chaque propriété individuelle de la propriété raccourcie :
|
| Valeur calculée | pour chaque propriété individuelle de la propriété raccourcie :
|
| Type d'animation | pour chaque propriété individuelle de la propriété raccourcie :
|
Syntaxe formelle
position-try =
<'position-try-order'>? <'position-try-fallbacks'>
<position-try-order> =
normal |
<try-size>
<position-try-fallbacks> =
none |
[ [ <dashed-ident> || <try-tactic> ] | <position-area> ]#
<try-size> =
most-width |
most-height |
most-block-size |
most-inline-size
<try-tactic> =
flip-block ||
flip-inline ||
flip-start ||
flip-x ||
flip-y
<position-area> =
[ left | center | right | span-left | span-right | x-start | x-end | span-x-start | span-x-end | self-x-start | self-x-end | span-self-x-start | span-self-x-end | span-all ] || [ top | center | bottom | span-top | span-bottom | y-start | y-end | span-y-start | span-y-end | self-y-start | self-y-end | span-self-y-start | span-self-y-end | span-all ] |
[ block-start | center | block-end | span-block-start | span-block-end | span-all ] || [ inline-start | center | inline-end | span-inline-start | span-inline-end | span-all ] |
[ self-block-start | center | self-block-end | span-self-block-start | span-self-block-end | span-all ] || [ self-inline-start | center | self-inline-end | span-self-inline-start | span-self-inline-end | span-all ] |
[ start | center | end | span-start | span-end | span-all ]{1,2} |
[ self-start | center | self-end | span-self-start | span-self-end | span-all ]{1,2}
Exemples
>Utilisation simple de position-try
Cette démonstration montre l'effet de position-try.
HTML
Le HTML inclut deux éléments HTML <div> qui deviennent une ancre et un élément positionné par rapport à l'ancre.
<div class="ancre">⚓︎</div>
<div class="boite-information">
<p>Ceci est une boîte d'information.</p>
</div>
CSS
Dans le CSS, l'ancre se voit attribuer un anchor-name et une valeur position de absolute. Nous la positionnons dans la moitié supérieure de la fenêtre en utilisant les valeurs top et left :
.ancre {
anchor-name: --mon-ancre;
position: absolute;
top: 100px;
left: 45%;
}
Nous incluons ensuite une option de position personnalisée — --bas-personnalise — qui positionne l'élément sous l'ancre et lui donne une marge appropriée :
@position-try --bas-personnalise {
top: anchor(bottom);
bottom: unset;
margin-top: 10px;
}
Nous positionnons initialement l'élément au-dessus de son ancre, puis nous définissons une valeur position-try qui lui donne un position-try-order de most-height et une liste de position-try-fallbacks qui inclut uniquement notre option de repli personnalisée :
.boite-information {
position: fixed;
position-anchor: --mon-ancre;
bottom: anchor(top);
margin-bottom: 10px;
justify-self: anchor-center;
position-try: most-height --bas-personnalise;
}
Résultat
L'élément apparaît sous son ancre, même s'il est initialement positionné au-dessus. Cela se produit parce qu'il y a plus d'espace vertical sous l'ancre que dessus. L'ordre d'essai most-height fait en sorte que l'option de repli --bas-personnalise soit appliquée, plaçant l'élément positionné dans la position qui donne à son bloc contenant la plus grande hauteur.
Spécifications
| Spécification |
|---|
| CSS Anchor Positioning Module Level 1> # position-try-prop> |
Compatibilité des navigateurs
Voir aussi
- La propriété
position-area - La propriété
position-try-fallbacks - La propriété
position-try-order - La règle
@position-try - Le type de donnée
<position-area> - Le module de positionnement par une ancre CSS
- Le guide d'utilisation du positionnement par une ancre CSS
- Le guide des options de repli et de masquage conditionnel en cas de débordement