Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@position-try — opção de posição alternativa nomeada

A regra @position-try define uma posição alternativa para uma caixa ancorada quando a opção preferida transborda.

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

Sintaxe

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

@position-try <dashed-ident> { <declaration-list> } atribui um nome a uma opção de posição personalizada. A propriedade position-try-fallbacks referencia esse nome; considera-se primeiro o estilo base e depois experimentam-se as alternativas pela ordem da lista se a caixa transbordar do bloco contentor modificado pelos insets. Regras com o mesmo nome entram em cascata como regras de fotogramas-chave.

O bloco aceita apenas propriedades de inset, margem, tamanho, autoalinhamento, âncora e position-area. A marca !important invalida essa declaração sem invalidar toda a regra. Estas declarações usam uma origem de cascata especial entre as origens de autor e animação, podendo mudar a posição sem alterar cores ou conteúdo do componente.

Uma dica, menu ou etiqueta junto ao limite da janela é uma utilização típica. O exemplo prefere block-start, define --below com block-end e mede ambas as caixas. A falta de espaço acima da âncora força a opção inferior; a leitura de CSSPositionTryRule confirma também que o motor reteve a regra no CSSOM.

Exemplos

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

Resultado

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

A regra @position-try define uma posição alternativa para uma caixa ancorada quando a opção preferida transborda.

Fontes