Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

@position-try — option de repli nommée

La règle @position-try définit une position de repli pour une boîte ancrée lorsque la position préférée déborde.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

@position-try <dashed-ident> {
  <declaration-list>
}

@position-try <dashed-ident> { <declaration-list> } attribue un nom à une option de position personnalisée. La propriété position-try-fallbacks référence ce nom ; le style de base est examiné en premier, puis les solutions de repli dans l’ordre de la liste si la boîte dépasse son bloc conteneur modifié par les retraits. Les règles de même nom cascadent comme des règles d’images clés.

Le bloc n’accepte que les propriétés de retrait, marge, taille, auto-alignement, ancre et position-area. Le drapeau !important invalide la déclaration concernée sans annuler toute la règle. Ces déclarations utilisent une origine de cascade spéciale entre l’origine auteur et l’origine animation ; elles peuvent donc déplacer la boîte sans modifier couleurs ou contenu.

Une infobulle, un menu ou une étiquette proche du bord de la fenêtre constitue un cas courant. L’exemple préfère block-start, définit --below avec block-end, puis mesure les deux boîtes. Le manque de place au-dessus impose l’option inférieure ; la lecture de CSSPositionTryRule confirme aussi la présence de la règle dans le CSSOM.

Exemples

const style = document.createElement('style');
style.textContent = `.anchor { position: fixed; inset: 0 auto auto 100px; inline-size: 60px; block-size: 20px; anchor-name: --trigger; }
.popup { position: fixed; position-anchor: --trigger; position-area: block-start; position-try-fallbacks: --below; inline-size: 80px; block-size: 30px; }
@position-try --below { position-area: block-end; }`;
document.head.append(style);
const anchor = document.createElement('div');
anchor.className = 'anchor';
const popup = document.createElement('div');
popup.className = 'popup';
document.body.append(anchor, popup);
await new Promise(requestAnimationFrame);
const anchorRect = anchor.getBoundingClientRect();
const popupRect = popup.getBoundingClientRect();
const rule = [...style.sheet.cssRules].find(item => item.cssText.startsWith('@position-try'));
console.log('rule=' + rule.constructor.name + '; fallback=' + (popupRect.top >= anchorRect.bottom ? 'below' : 'above') + '; anchor-bottom=' + anchorRect.bottom + '; popup-top=' + popupRect.top);

Résultat

rule=CSSPositionTryRule; fallback=below; anchor-bottom=20; popup-top=20

La règle @position-try définit une position de repli pour une boîte ancrée lorsque la position préférée déborde.

Sources