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

CKTIS / CSS

animation-range: изберете участък от времевата линия на превъртане

Свържете същите ключови кадри с избран участък от превъртането, вместо да добавяте закъснение в секунди.

Версия: CSS Modules

Синтаксис

animation-range: normal | <start> <end>?; /* comma-separated per animation */

animation-range е съкратен запис за animation-range-start и animation-range-end. Определя къде анимацията се свързва със своята времева линия, а не границите на превъртане на елемента. При анимация, управлявана от превъртането, процентите без именуван диапазон се отнасят до цялата линия. Стойности като entry и exit обозначават именувани части от линия на видимостта; те не избират контейнера за превъртане. Няколко диапазона, разделени със запетаи, съответстват на списъка animation-name.

В примера видимата област е висока 200px, а съдържанието е 1000px, така че разстоянието за превъртане е 800px. Диапазонът 25% 75% свързва една линейна промяна на непрозрачността с позиции от 200px до 600px. Отчитанията при 0,200,400,600,800 дават opacity 0,0,0.5,1,1. Връщането до 400 възстановява 0.5: превъртането управлява напредъка и в двете посоки. animation-fill-mode: both запазва крайните стойности извън интервала; самият диапазон не осигурява това поведение.

Пропускането на края има две значения. Самостоятелно 25% задава начало 25% и връща края на normal. Самостоятелно entry използва началото и края на диапазона entry; двете отделни свойства може да се сериализират като entry, въпреки различните им отмествания по подразбиране. Примерът проверява тези прочетени стойности, но не измерва геометрията на влизане по линията на видимостта. Двойка секунди като 2s 4s се отхвърля.

Пишете animation-timeline и animation-range след съкратения запис animation, който ги нулира. Осигурете използваем статичен изглед и проверете целевите браузъри: това е анимация, управлявана от превъртането, а не универсален заместител на animation-delay по часовника на документа. Примерът измерва реалната непрозрачност след кадри на изобразяване, без мрежови ресурси или потребителски данни.

Примери

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(',')};
box.style.animationRange='25% 75%';
const values=await sample([0,200,400,600,800,400]);
const shorthand=document.createElement('div').style;shorthand.animationRange='entry';const named=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
shorthand.animationRange='25%';const lone=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
console.log('scroll-range='+(scroller.scrollHeight-scroller.clientHeight)+'; opacity='+values+'; entry='+named+'; lone='+lone+'; seconds='+CSS.supports('animation-range','2s 4s'));

Резултат

scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false

Изпълнено в Chromium 157.0.8103.51. Преходът използва продължителност auto, една итерация и линейна функция; други настройки за итерации, темпо или запълване променят видимия резултат.

Източници