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

CKTIS / CSS

animation-range: vyberte úsek časové osy posouvání

Přiřaďte stejné klíčové snímky vybranému úseku posouvání místo přidávání zpoždění v sekundách.

Verze: CSS Modules

Syntaxe

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

animation-range je zkrácený zápis vlastností animation-range-start a animation-range-end. Určuje místo připojení animace na její časové ose, nikoli hranice posouvání prvku. U animace řízené posouváním se procenta bez pojmenovaného rozsahu vztahují k celé ose. Hodnoty entry nebo exit naopak označují pojmenované části osy viditelnosti prvku; nejsou to selektory posouvacího kontejneru. Více rozsahů oddělených čárkami odpovídá seznamu animation-name.

V příkladu má oblast zobrazení výšku 200px a obsah 1000px, takže posuvná vzdálenost činí 800px. Rozsah 25% 75% přiřadí jediný lineární přechod krytí pozicím od 200px do 600px. Odčty při 0,200,400,600,800 dávají opacity 0,0,0.5,1,1. Návrat na 400 obnoví 0.5: posouvání řídí průběh oběma směry. animation-fill-mode: both zachovává krajní hodnoty mimo tento interval; samotný rozsah toto chování nezajišťuje.

Vynechání konce má dva různé významy. Samotné 25% nastaví začátek na 25% a obnoví konec normal. Samotné entry použije začátek a konec rozsahu entry; obě dílčí vlastnosti se mohou serializovat jako entry, přestože jejich výchozí posuny jsou odlišné. Příklad kontroluje tyto načtené hodnoty, ale neměří geometrii vstupu na ose viditelnosti. Dvojice sekund, například 2s 4s, je odmítnuta.

Pište animation-timeline a animation-range za zkrácenou vlastnost animation, která je resetuje. Nabídněte použitelný statický vzhled a ověřte cílové prohlížeče: jde o animace řízené posouváním, nikoli o univerzální náhradu animation-delay na hodinách dokumentu. Příklad měří skutečné krytí po vykreslených snímcích, bez síťových zdrojů a uživatelských dat.

Příklady

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

Výsledek

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

Spuštěno v Chromium 157.0.8103.51. Přechod používá dobu auto, jednu iteraci a lineární průběh; jiné nastavení iterací, průběhu či vyplnění mění viditelný výsledek.

Zdroje