KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

@position-try — benoemde uitwijkpositie

De regel @position-try definieert een uitwijkpositie voor een verankerd vak wanneer de voorkeursoptie overloopt.

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

Syntax

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

@position-try <dashed-ident> { <declaration-list> } geeft een aangepaste positieoptie een naam. De eigenschap position-try-fallbacks verwijst naar die naam; eerst wordt de basisstijl beoordeeld en daarna worden alternatieven in lijstvolgorde geprobeerd als het vak zijn door insets gewijzigde containing block overschrijdt. Regels met dezelfde naam cascaderen zoals keyframeregels.

Het blok aanvaardt alleen inset-, marge-, grootte-, zelfuitlijnings-, anker- en position-area-eigenschappen. !important maakt de betreffende declaratie ongeldig, maar niet de hele regel. Deze declaraties gebruiken een bijzondere cascadeoorsprong tussen auteur en animatie en kunnen daardoor de positie vervangen zonder kleuren of inhoud van de component te wijzigen.

Een tooltip, menu of label dicht bij de viewportrand is een typisch gebruik. Het voorbeeld kiest eerst block-start, definieert --below met block-end en meet beide vakken. Onvoldoende ruimte boven het anker dwingt de onderste optie af; CSSPositionTryRule bevestigt tevens dat de engine de regel in CSSOM heeft bewaard.

Voorbeelden

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);

Resultaat

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

De regel @position-try definieert een uitwijkpositie voor een verankerd vak wanneer de voorkeursoptie overloopt.

Bronnen