Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

anchor-scope: confinare i nomi di ancoraggio ripetuti nel componente

Limita definizioni e ricerca degli ancoraggi con nome, così più componenti possono riutilizzare lo stesso nome.

Versione: CSS Modules

Sintassi

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

anchor-scope crea un ambito locale per determinati nomi di ancoraggio all’interno di un elemento e del suo sottoalbero. Il valore iniziale none non modifica l’ambito. Un elenco separato da virgole di nomi che iniziano con due trattini isola quei nomi; all riguarda tutti i nomi pertinenti nello stesso ambito dell’albero. La proprietà non è ereditata: l’effetto deriva dall’ambito creato, non dal passaggio di un valore ai figli.

Il confine limita sia la visibilità delle definizioni sia la ricerca effettuata dai discendenti. Non crea un ancoraggio: a questo serve anchor-name; position-anchor o un riferimento esplicito anchor() lo seleziona. Restano valide le normali condizioni di ammissibilità degli ancoraggi e le regole di impaginazione. Gli ancoraggi impliciti non cambiano e le regole dell’ambito dell’albero contano anche ai confini dello Shadow DOM. È un meccanismo di nomi per il layout, non una barriera di sicurezza né un sostituto del posizionamento.

L’esempio ripete un componente con ancoraggi alle coordinate orizzontali 20 e 200. Senza confini, i due suggerimenti locali e uno esterno trovano l’ultimo ancoraggio ammissibile con quel nome: 200,200,200. Limitare il nome a ciascun componente produce 20,200,-999; il suggerimento esterno usa il ripiego esplicito perché nessuna definizione locale è visibile. Limitare tutti i nomi dà le stesse misure. Sono coordinate effettive del layout in Chromium 157, non soltanto una dichiarazione accettata.

Esempi

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

Risultato

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

Gli ancoraggi sono discendenti dei contenitori dei componenti ed elementi fratelli dei suggerimenti, non loro antenati. Il test usa appositamente un blocco contenitore comune. -999px è un ripiego diagnostico, non una posizione consigliata per l’interfaccia.

Fonti