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

CKTIS / CSS

anchor() — posição de um lado da âncora

`anchor()` calcula um comprimento até um lado escolhido de uma caixa de âncora real e utiliza-o para colocar uma caixa posicionada de forma absoluta.

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

Sintaxe

anchor( <anchor-name>? && <anchor-side> , <length-percentage>? )

anchor() calcula um comprimento até um lado escolhido de uma caixa de âncora real e utiliza-o para colocar uma caixa posicionada de forma absoluta.

O exemplo liga elementos nomeados: anchor(--pin right) alinha a margem esquerda da dica com a direita da âncora, enquanto anchor(--pin bottom) alinha o topo com a base da âncora; os afastamentos medidos são zero.

Gramática: anchor( <anchor-name>? && <anchor-side> , <length-percentage>? ).

A função só é permitida nas propriedades inset de uma caixa com position: absolute. anchor-name: --pin estabelece a âncora e position-anchor: --pin seleciona-a por omissão; um lado físico tem de corresponder ao eixo do inset. Uma referência irresolúvel usa o fallback fornecido ou invalida a declaração no valor calculado quando não existe fallback.

Exemplos

const stage=document.createElement('div'),pin=document.createElement('div'),tip=document.createElement('div');document.body.append(stage);stage.append(pin,tip);stage.style.cssText='position:relative;width:300px;height:180px';pin.style.cssText='position:absolute;left:70px;top:40px;width:80px;height:30px;anchor-name:--pin';tip.style.cssText='position:absolute;position-anchor:--pin;left:anchor(--pin right);top:anchor(--pin bottom);width:20px;height:10px';const a=pin.getBoundingClientRect(),b=tip.getBoundingClientRect(),s=getComputedStyle(tip);const x=Math.round(b.left-a.right),y=Math.round(b.top-a.bottom);if(x!==0||y!==0)throw new Error('anchor relationship did not resolve: '+x+','+y);console.log('edge-gap='+x+','+y+'; computed='+s.left+','+s.top);

Resultado

edge-gap=0,0; computed=150px,70px

`anchor()` calcula um comprimento até um lado escolhido de uma caixa de âncora real e utiliza-o para colocar uma caixa posicionada de forma absoluta.

Fontes