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

CKTIS / CSS

anchor-scope: manter nomes de âncora repetidos dentro do componente

Limite as definições e a procura de âncoras com nome para reutilizar o mesmo nome em vários componentes.

Versão: CSS Modules

Sintaxe

anchor-scope: none | all | --name [, --other-name]*;

anchor-scope cria um âmbito local para determinados nomes de âncora num elemento e na sua subárvore. O valor inicial none não altera o âmbito. Uma lista, separada por vírgulas, de nomes começados por dois hífenes isola esses nomes; all abrange todos os nomes relevantes no mesmo âmbito de árvore. A propriedade não é herdada: o efeito resulta do âmbito estabelecido, não da transmissão de um valor aos filhos.

O limite restringe tanto a visibilidade das definições como a procura pelos descendentes. Não cria uma âncora: para isso usa-se anchor-name; position-anchor ou uma referência explícita anchor() seleciona-a. Continuam a aplicar-se os critérios normais de elegibilidade e as regras de disposição. As âncoras implícitas não são afetadas e as regras do âmbito de árvore continuam relevantes nas fronteiras de Shadow DOM. É um mecanismo de nomes para a disposição, não uma fronteira de segurança nem um substituto do posicionamento.

O exemplo repete um componente com âncoras nas coordenadas horizontais 20 e 200. Sem um limite, as duas dicas locais e uma exterior encontram a última âncora elegível com o mesmo nome: 200,200,200. Limitar o nome a cada componente altera o resultado para 20,200,-999; a dica exterior usa o valor alternativo explícito porque nenhuma definição local está visível. Limitar todos os nomes dá as mesmas medições. São coordenadas reais de disposição no Chromium 157, não apenas uma declaração aceite.

Exemplos

document.body.style.margin='0';
const style=document.createElement('style');
style.textContent='.row{height:60px}.anchor{display:block;width:30px;height:20px;anchor-name:--item}.tip{position:absolute;left:anchor(--item left,-999px);top:anchor(--item bottom,-999px);width:10px;height:10px}';
document.head.append(style);
const rows=[],tips=[];
for(const x of [20,200]){const row=document.createElement('section');row.className='row';const anchor=document.createElement('span');anchor.className='anchor';anchor.style.marginLeft=x+'px';const tip=document.createElement('span');tip.className='tip';row.append(anchor,tip);document.body.append(row);rows.push(row);tips.push(tip)}
const outside=document.createElement('span');outside.className='tip';document.body.append(outside);
const measure=scope=>{for(const row of rows)row.style.setProperty('anchor-scope',scope);return [...tips,outside].map(el=>el.getBoundingClientRect().left).join(',')};
console.log('none='+measure('none')+'; named='+measure('--item')+'; all='+measure('all')+'; syntax='+CSS.supports('anchor-scope','--item'));

Resultado

none=200,200,200; named=20,200,-999; all=20,200,-999; syntax=true

As âncoras são descendentes dos contentores dos componentes e elementos irmãos das dicas, não seus antepassados. O teste usa deliberadamente um bloco de referência comum. -999px é um valor alternativo de diagnóstico, não uma posição recomendada para a interface.

Fontes