Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

anchor-scope: opakované názvy kotev uvnitř komponenty

Omezte definice a vyhledávání pojmenovaných kotev, aby dvě komponenty mohly používat stejný název.

Verze: CSS Modules

Syntaxe

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

anchor-scope vytváří místní rozsah vybraných názvů kotev v prvku a jeho podstromu. Počáteční hodnota none rozsah nemění. Seznam názvů začínajících dvěma spojovníky, oddělených čárkami, izoluje tyto názvy; all zahrnuje všechny příslušné názvy ve stejném rozsahu stromu. Vlastnost se nedědí: účinek vzniká vymezením rozsahu, nikoli předáním hodnoty dětem.

Hranice omezuje viditelnost definic i vyhledávání potomky. Sama kotvu nevytváří: k tomu slouží anchor-name, zatímco position-anchor nebo výslovný odkaz anchor() kotvu vybírá. Běžná pravidla přípustnosti kotev a rozvržení stále platí. Implicitní kotvy nejsou ovlivněny a na hranicích stínových stromů zůstávají důležitá pravidla rozsahu stromu. Jde o pojmenování v rozvržení, nikoli bezpečnostní hranici nebo náhradu polohování.

Příklad opakuje komponentu dvakrát s kotvami na vodorovných souřadnicích 20 a 200. Bez hranice obě místní značky i vnější značka přiřadí stejný název poslední přípustné kotvě: 200,200,200. Omezení názvu v každé komponentě změní výsledek na 20,200,-999; vnější značka použije výslovnou náhradní hodnotu, protože žádnou místní definici nevidí. Omezení všech názvů dává stejný naměřený výsledek. Jde o skutečné souřadnice rozvržení v Chromium 157, ne pouze přijatou deklaraci.

Příklady

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

Výsledek

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

Kotvy a značky jsou sourozeneckými potomky kontejnerů komponent, nikoli předky značek. Test záměrně používá společný obsahující blok; -999px je diagnostická náhradní hodnota, ne doporučená poloha rozhraní.

Zdroje