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.