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

CKTIS / CSS

animation-timeline: изберете какво управлява анимацията

Разграничавайте времето на документа, напредъка на превъртането и видимостта на елемента при избор на времева линия.

Версия: CSS Modules

Синтаксис

animation-timeline: auto | none | <dashed-ident> | scroll() | view();

animation-timeline избира източника на напредък за всяка CSS анимация. auto използва времевата линия на документа, none не свързва никаква линия, а идентификатор с две тирета като --track сочи към именувана линия на превъртане или видимост в съответния обхват. scroll() следва превъртането на избрания контейнер и ос; view() следва преминаването на елемент през видимата област на превъртащ контейнер. Име на ключови кадри не дефинира линия със същото име. Няколко стойности със запетаи съответстват на списъка animation-name.

Липсваща именувана линия не преминава мълчаливо към часовника на документа. Линията на превъртане се нуждае и от валиден източник със съдържание, което може да се превърта по избраната ос. none не е същото като animation-play-state: paused: липсата на свързана линия се различава от запазване и паузиране на текущата позиция. При анимация от превъртане продължителност auto и краен брой итерации могат да разпределят ефекта по диапазона на свързване.

Примерът сравнява анонимна линия scroll(nearest block) с --track, дефинирана върху същия контейнер. При отместване 400 от диапазон 800px и двете показват opacity 0.5. Промяната към none и липсваща линия --missing дава основната opacity 0.2 при запълване none. Отделна паузирана анимация по часовника на документа, отчетена при 500ms от едносекундна продължителност, дава 0.5. Няма влизане в акаунт, мрежова заявка или външен часовник.

Последната проверка показва, че по-късен съкратен запис animation връща избраната линия на превъртане към auto. Поставяйте декларациите за линия и диапазон след него, за да ги запазите. Проверявайте реалното поведение в целевите браузъри и осигурете статично съдържание при недостъпна линия. Примерът проверява именувани и анонимни линии на превъртане и контролна анимация по документа; не твърди, че проверява геометрията на view().

Примери

const style=document.createElement('style');style.textContent='@keyframes fade{from{opacity:0}to{opacity:1}}';document.head.append(style);
const scroller=document.createElement('div');scroller.style.cssText='height:200px;width:200px;overflow:auto;scroll-behavior:auto';
const space=document.createElement('div');space.style.height='1000px';
const box=document.createElement('div');box.style.cssText='height:20px;width:20px;opacity:.2;animation:fade auto linear both;animation-timeline:scroll(nearest block)';
space.append(box);scroller.append(space);document.body.append(scroller);
const frame=()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
const sample=async positions=>{const values=[];for(const y of positions){scroller.scrollTop=y;await frame();values.push(Number(getComputedStyle(box).opacity).toFixed(2));}return values.join(',')};
scroller.style.scrollTimeline='--track block';box.style.animationFillMode='none';
const named=box.cloneNode();named.style.animationTimeline='--track';space.append(named);
scroller.scrollTop=400;await frame();const halfway=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animationTimeline='none';named.style.animationTimeline='--missing';await frame();const inactive=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animation='fade 1s linear both paused';getComputedStyle(box).opacity;const time=box.getAnimations()[0];time.currentTime=500;const clock=Number(getComputedStyle(box).opacity).toFixed(2);
box.style.animationTimeline='scroll(nearest block)';const before=box.style.animationTimeline;box.style.animation='fade 2s linear';const after=getComputedStyle(box).animationTimeline;
console.log('halfwayAnonymousNamed='+halfway+'; inactiveNoneMissing='+inactive+'; clockAt500ms='+clock+'; reset='+before+' / '+after);

Резултат

halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto

Изпълнено в Chromium 157.0.8103.51. Браузърът сериализира scroll(nearest block) като scroll(); пропуснатите аргументи са стойности по подразбиране, а не загубена настройка.

Източници