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

CKTIS / CSS

animation-duration: продължителност на един цикъл

Задайте времето за една итерация на времево управлявана анимация независимо от закъснението и броя повторения.

Версия: CSS Modules

Синтаксис

animation-duration: 1s, 250ms;

animation-duration задава продължителността на една итерация, а не общото време с всички повторения или началното закъснение. Използвайте неотрицателно време с s или ms; отрицателно време и ненулево число без единица са невалидни. Стойностите, разделени със запетаи, съответстват на елементите на animation-name; по-краткият списък с времена се повтаря, докато покрие имената. При обикновена времева анимация продължителността на цикъла, умножена по animation-iteration-count, дава активната продължителност, а animation-delay е отделно.

CSS Animations Level 2 определя auto като начална стойност. По времевата линия на документа auto се държи като 0s; отчитането на разрешения стил по старите правила може да показва 0s. Нулата не означава липса на анимация: активният интервал е мигновен, събитията за начало и край все още могат да настъпят, а animation-fill-mode определя евентуалния видим ефект преди и след него. По линия, управлявана с превъртане, auto запълва съответния диапазон с отчитане на останалите времеви настройки; текущият проект третира изрично време там като auto. Това не прави анимацията при превъртане с фиксиран брой секунди реално време.

Примерът създава паузирани линейни анимации на непрозрачност и отчита всяка при 500ms. Цикъл 1s дава 0.5, а цикъл 2s — 0.25. Със запълване both и подразбиращата се посока напред 0s и auto вече показват крайната точка 1; изчислените продължителности на итерациите са нула. Браузърът отхвърля и -1s, и самостоятелната стойност 1. Това са действителни прочити на стил и времеви параметри, а не обратно броене или твърдение за кадрова честота.

Примери

const style=document.createElement('style');
style.textContent='@keyframes duration-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const make=duration=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:duration-demo;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';el.style.animationDuration=duration;document.body.append(el);const animation=el.getAnimations()[0];animation.currentTime=500;return {el,animation}};
const rows=['1s','2s','0s','auto'].map(make);
console.log('opacity='+rows.map(({el})=>getComputedStyle(el).opacity).join(','));
console.log('duration='+rows.map(({animation})=>animation.effect.getComputedTiming().duration).join(','));
console.log('negative='+CSS.supports('animation-duration','-1s')+'; unitless='+CSS.supports('animation-duration','1')+'; auto='+CSS.supports('animation-duration','auto'));

Резултат

opacity=0.5,0.25,1,1
duration=1000,2000,0,0
negative=false; unitless=false; auto=true

Изпълнено в Chromium 157.0.8103.51 по времевата линия на документа. Примерът проверява времевата продължителност и auto, не управление с превъртане или доставяне на събития. Обяснението за превъртането следва текущия проект CSS Animations Level 2; проверете тази функция отделно в целевите браузъри.

Източници