CSS свойство animation-duration

Определение и применение

Свойство animation-duration задаёт длительность одного цикла анимации элемента. Время всех повторов определяется также количеством циклов; задержка старта задаётся отдельно.

Основы и примеры — в уроке об анимациях CSS. Несколько настроек можно объединить сокращённым свойством animation.

В генераторе анимаций можно изменить длительность цикла и сразу сравнить скорость.

Попробуйте значения animation-duration

Меняется время одного прохода; сравните скорость движения.

Значение свойства

animation-duration: 1s

HTML и CSS примера
HTML
<div class="stage">
  <div class="demo-target">CSS</div>
</div>
CSS
* {
  box-sizing: border-box;
}
.stage {
  width: 100%;
  max-width: 300px;
  height: 210px;
  display: grid;
  place-items: center;
  padding: 20px;
  border: 2px dashed #607589;
  background: #edf2f5;
  color: #172c3d;
  font: 16px/1.4 system-ui;
}
.demo-target {
  width: 100px;
  height: 80px;
  display: grid;
  place-items: center;
  border: 3px solid #245a85;
  background: #ffe4bd;
  animation-name: travel;
  animation-timing-function: linear;
  animation-iteration-count: infinite;
  animation-direction: alternate;
  animation-duration: 1s;
}
@keyframes travel {
  from {
    transform: translateX(-55px);
  }
  to {
    transform: translateX(55px);
  }
}
@keyframes turn {
  from {
    transform: rotate(-30deg);
  }
  to {
    transform: rotate(30deg);
  }
}

Поддержка браузерами

Спецификация: CSS animations-2

Поддерживается во всех основных браузерах с 2016 года.

Отдельные значения (1) поддерживаются не везде — смотрите таблицу.

Показать браузеры
Совместимостьcss.properties.animation-duration
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
animation-duration✓43✓12✓16✓30✓9✓43✓16✓30✓9✓4.0✓43✓9
auto✓115✓115✓preview✓101✓18.4✓115×✓77✓18.4✓23.0✓115✓18.4

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Значение auto поддерживается отдельно от основного свойства: Chrome и Edge — с 115, Safari — с 18.4; в используемых данных совместимости Firefox отмечен как preview. В Level 1 начальное значение — 0s; проект Level 2 задаёт auto, которое для обычной временной шкалы разрешается в 0s.

CSS синтаксис:

CSS
animation-duration: [ auto | <time [0s,∞]> ]#;

/* Глобальные значения */
animation-duration: initial | inherit | unset | revert | revert-layer;

Тип <time [0s,∞]> — неотрицательное время с обязательной единицей s или ms. Знак # означает одно или несколько значений через запятую. Знак | разделяет варианты. Квадратные скобки группируют варианты.

JavaScript синтаксис:

JavaScript
element.style.animationDuration = "500ms";

Начальное значение свойства

0s.

Значения свойства

Значения animation-duration
Значение Описание
<time [0s,∞]> Длительность одного цикла, например 2s или 500ms. Отрицательное время недопустимо.
0s Мгновенное выполнение без видимого движения во времени; это не отключение анимации. Начальное значение.
auto В CSS Animations Level 2 — автоматическая длительность: для обычной временной анимации соответствует 0s, для анимации от прокрутки определяется её временной шкалой.
initial Устанавливает начальное значение свойства.
inherit Наследует вычисленное значение свойства у родительского элемента.
unset Для ненаследуемого свойства animation-duration устанавливает его начальное значение.
revert Отменяет заданное в коде значение свойства для этого элемента: применяются пользовательские или стандартные стили браузера. Если они не задают значение, свойство наследуется или получает начальное значение по обычным правилам. Не возвращает значение из предыдущей строки CSS.
revert-layer Сбрасывает значение свойства для текущего слоя каскада @layer. Применяется значение из другого слоя по правилам каскада; если подходящего значения нет, возможен откат к стилям пользователя или браузера.

Значения через запятую соответствуют именам в animation-name по порядку. Если значений меньше, список повторяется; лишние значения не используются.

Что происходит при нулевой длительности

При 0s события начала и конца всё равно возникают. animation-fill-mode может применить начальное состояние во время задержки и конечное после неё. Для заметного движения задайте ненулевое время, существующее имя @keyframes и ненулевое количество повторов.

Спецификация

CSS Animations Level 1.

CSS Animations Level 2 — расширения свойства.

Наследуется

Нет.

Анимируемое

Нет.

Примеры, попробуйте сами

Длительность одного цикла

Сравните цикл длительностью 2s и 5s. Измените время второй дорожки; путь останется тем же, но скорость изменится.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    font:
        16px/1.4 system-ui,
        sans-serif;
    color: #172c3d;
}
.track {
    position: relative;
    height: 70px;
    margin-top: 16px;
    border: 1px dashed #607589;
    background: #edf2f5;
}
.box {
    position: absolute;
    top: 12px;
    left: 0;
    width: 42px;
    height: 42px;
    display: grid;
    place-items: center;
    border-radius: 6px;
    background: #245a85;
    color: white;
}
.run:not(:checked) ~ .track .box {
    animation-name: none;
}
index.html
HTML
<input class="run" type="checkbox" id="run" checked />
<label for="run">Запустить анимацию</label>
<div class="track"><span class="box">A</span></div>
<div class="track second"><span class="box">B</span></div>
style.css
CSS
.box {
    animation-name: travel;
    animation-duration: 2s;
    animation-timing-function: linear;
    animation-iteration-count: infinite;
}
.second .box {
    animation-duration: 5s;
}

/* Длина пути зависит от ширины дорожки: пример помещается на телефоне. */
@keyframes travel {
    from {
        left: 0;
        background: #a64400;
    }
    to {
        left: calc(100% - 42px);
        background: #16703c;
    }
}

Нулевая длительность и конечное состояние

Оба блока имеют длительность 0s и задержку 1s. A использует none и остаётся на исходном месте; B использует forwards и после задержки мгновенно оказывается справа. Замените 0s на 2s и сравните. Флажок запускает пример заново.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    font:
        16px/1.4 system-ui,
        sans-serif;
    color: #172c3d;
}
.track {
    position: relative;
    height: 70px;
    margin-top: 16px;
    border: 1px dashed #607589;
    background: #edf2f5;
}
.box {
    position: absolute;
    top: 12px;
    left: 0;
    width: 42px;
    height: 42px;
    display: grid;
    place-items: center;
    border-radius: 6px;
    background: #245a85;
    color: white;
}
.run:not(:checked) ~ .track .box {
    animation-name: none;
}
index.html
HTML
<input class="run" type="checkbox" id="run" checked />
<label for="run">Запустить анимацию</label>
<div class="track"><span class="box">A</span></div>
<div class="track second"><span class="box">B</span></div>
style.css
CSS
.box {
    animation-name: travel;
    animation-duration: 0s;
    animation-delay: 1s;
    animation-fill-mode: none;
}
.second .box {
    animation-fill-mode: forwards;
}
@keyframes travel {
    from {
        left: 0;
    }
    to {
        left: calc(100% - 42px);
    }
}