CSS свойство animation-duration
Определение и применение
Свойство animation-duration задаёт длительность одного цикла анимации элемента. Время всех повторов
определяется также количеством циклов; задержка старта задаётся отдельно.
Основы и примеры — в
уроке об анимациях CSS. Несколько
настроек можно объединить сокращённым свойством
animation.
В генераторе анимаций можно изменить длительность цикла и сразу сравнить скорость.
Попробуйте значения animation-duration
Меняется время одного прохода; сравните скорость движения.
animation-duration: 1s
HTML и CSS примера
<div class="stage">
<div class="demo-target">CSS</div>
</div>
* {
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);
}
}
* {
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: 2s;
}
@keyframes travel {
from {
transform: translateX(-55px);
}
to {
transform: translateX(55px);
}
}
@keyframes turn {
from {
transform: rotate(-30deg);
}
to {
transform: rotate(30deg);
}
}
* {
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: 4s;
}
@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) поддерживаются не везде — смотрите таблицу.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
animation-duration | 43 Версия 43 выпущена в 2015 г. Версия 3 выпущена в 2009 г. — Префикс -webkit- | 12 Версия 12 выпущена в 2015 г. Версия 12 выпущена в 2015 г. — Префикс -webkit- | 16 Версия 16 выпущена в 2012 г. Версия 49 выпущена в 2016 г. — Префикс -webkit- Версия 5 выпущена в 2011 г. — Префикс -moz- | 30 Версия 30 выпущена в 2015 г. Версия 15 выпущена в 2013 г. — Префикс -webkit- Версия 12.1 выпущена в 2012 г. — Удалено в 15 Версия 12 выпущена в 2012 г. — Удалено в 15; Префикс -o- | 9 Версия 9 выпущена в 2015 г. Версия 4 выпущена в 2009 г. — Префикс -webkit- | 43 Версия 43 выпущена в 2015 г. Версия 18 выпущена в 2012 г. — Префикс -webkit- | 16 Версия 16 выпущена в 2012 г. Версия 49 выпущена в 2016 г. — Префикс -webkit- Версия 5 выпущена в 2011 г. — Префикс -moz- | 30 Версия 30 выпущена в 2015 г. Версия 14 выпущена в 2013 г. — Префикс -webkit- Версия 12.1 выпущена в 2012 г. — Удалено в 14 Версия 12 выпущена в 2012 г. — Удалено в 14; Префикс -o- | 9 Версия 9 выпущена в 2015 г. Версия 4.2 выпущена в 2010 г. — Префикс -webkit- | 4.0 Версия 4.0 выпущена в 2016 г. Версия 1.0 выпущена в 2013 г. — Префикс -webkit- | 43 Версия 43 выпущена в 2015 г. Версия 2 выпущена в 2009 г. — Префикс -webkit- | 9 Версия 9 выпущена в 2015 г. Версия 4.2 выпущена в 2010 г. — Префикс -webkit- |
auto | 115 | 115 | preview preview Примечание MDN (англ.) Firefox does not currently support the | 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 синтаксис:
animation-duration: [ auto | <time [0s,∞]> ]#;
/* Глобальные значения */
animation-duration: initial | inherit | unset | revert | revert-layer;
Тип <time [0s,∞]> — неотрицательное время с обязательной единицей s или
ms. Знак # означает одно или несколько значений через запятую. Знак | разделяет
варианты. Квадратные скобки группируют варианты.
JavaScript синтаксис:
element.style.animationDuration = "500ms";Начальное значение свойства
0s.
Значения свойства
| Значение | Описание |
|---|---|
<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 2 — расширения свойства.
Наследуется
Нет.
Анимируемое
Нет.
Примеры, попробуйте сами
Длительность одного цикла
Сравните цикл длительностью 2s и 5s. Измените время второй дорожки; путь останется тем же, но скорость изменится.
base.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
<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
.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
* {
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
<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
.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);
}
}