База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

anchor-scope: повтарящи се имена на котви вътре в компонента

Ограничете дефинициите и търсенето на именувани котви, за да могат два компонента да използват едно име.

Версия: CSS Modules

Синтаксис

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

anchor-scope създава локален обхват за избрани имена на котви в елемента и неговото поддърво. Началната стойност none не променя обхвата. Списък от имена, започващи с две тирета и разделени със запетаи, изолира тези имена; all обхваща всички съответни имена в същия дървовиден обхват. Свойството не се наследява: ефектът идва от установения обхват, не от предаване на стойност на децата.

Границата ограничава както видимостта на дефинициите, така и търсенето от потомците. Тя не създава котва: за това служи anchor-name, а за избор — position-anchor или изрична препратка anchor(). Обичайните правила за допустимост на котвите и оформлението продължават да важат. Неявните котви не се засягат, а при границите на сенчестите дървета правилата за дървовидния обхват остават важни. Това е механизъм за имена в оформлението, не защитна граница или заместител на позиционирането.

Примерът повтаря компонент два пъти с котви на хоризонтални координати 20 и 200. Без граница двата локални маркера и външният маркер свързват името с последната допустима котва: 200,200,200. Ограничаването на името във всеки компонент променя резултата на 20,200,-999; външният маркер използва изричната резервна стойност, защото не вижда нито една локална дефиниция. Ограничаването на всички имена дава същия измерен резултат. Това са действителни координати на оформлението в Chromium 157, не само приета декларация.

Примери

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

Резултат

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

Котвите и маркерите са съседни потомци на контейнерите на компонентите; котвите не са предшественици на маркерите. Тестът нарочно използва общ съдържащ блок, а -999px е диагностична резервна стойност, не препоръчителна позиция за интерфейса.

Източници