1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
---
title: window.requestAnimationFrame()
slug: Web/API/window/requestAnimationFrame
tags:
- Анимация
translation_of: Web/API/window/requestAnimationFrame
original_slug: DOM/window.requestAnimationFrame
---
<div>{{APIRef}}</div>
<p><code><strong>window.requestAnimationFrame</strong></code> указывает браузеру на то, что вы хотите произвести анимацию, и просит его запланировать перерисовку на следующем кадре анимации. В качестве параметра метод получает функцию, которая будет вызвана перед перерисовкой.</p>
<div class="note"><strong>Примечание:</strong> Ваш callback метод сам должен вызвать <code>requestAnimationFrame()</code> иначе анимация остановится.</div>
<p>Вы должны вызывать этот метод всякий раз, когда готовы обновить анимацию на экране, чтобы запросить планирование анимации. Обычно запросы происходят 60 раз в секунду, но чаще всего совпадают с частотой обновления экрана. В большинстве браузеров в фоновых вкладках или скрытых <code><iframe></code>, вызовы <code>requestAnimationFrame()</code> приостанавливаются, для того, чтобы повысить производительность и время работы батареи.</p>
<p>Callback методу передаётся один аргумент, {{domxref("DOMHighResTimeStamp")}}, который содержит текущее время (количество миллисекунд, прошедших с момента <a href="/en-US/docs/Web/API/DOMHighResTimeStamp#The_time_origin">time origin</a>). Когда колбэки, отправленные в очередь с помощью <code>requestAnimationFrame()</code> начинают вызывать несколько колбэков в одном кадре, каждый получает одинаковый timestamp, хотя для вычисления каждого callback было затрачено время. Этот timestamp - десятичное число в миллисекундах, но с минимальной точностью в 1ms (1000 µs).</p>
<h2 id="Syntax">Синтаксис</h2>
<pre class="brush: js">window.requestAnimationFrame(callback);</pre>
<h3 id="Parameters">Параметры</h3>
<dl>
<dt><code>callback</code></dt>
<dd>Функция, которая будет вызвана, когда придёт время обновить вашу анимацию на следующей перерисовке.</dd>
<dt><code>element</code> {{ optional_inline() }}</dt>
<dd>Необязательный параметр (не используется в Firefox или IE), определяющий элемент, который визуально содержит всю анимацию. Для canvas'а и WebGL'a им должен быть {{ HTMLElement("canvas") }}. Для других элементов вы можете опустить этот параметр для чуть лучшего пользовательского опыта.</dd>
</dl>
<h3 id="Возвращаемое_значение">Возвращаемое значение</h3>
<p><code>requestID</code> — длинное целое, являющееся уникальным идентификатором для записи, содержащей callback. Оно не равно нулю, но других предположений о его значении делать не следует. Вы можете передать его в {{ domxref("window.cancelAnimationFrame()") }} для отмены вызова.</p>
<h2 id="Notes">Пример</h2>
<pre class="brush: js">var start = null;
var element = document.getElementById('SomeElementYouWantToAnimate');
function step(timestamp) {
if (!start) start = timestamp;
var progress = timestamp - start;
element.style.transform = 'translateX(' + Math.min(progress / 10, 200) + 'px)';
if (progress < 2000) {
window.requestAnimationFrame(step);
}
}
window.requestAnimationFrame(step);</pre>
<h2 id="Примечание">Примечание</h2>
<p>В Edge версиях младше 17 и в Internet Explorer не надёжно запускать <code>requestAnimationFrame</code> перед циклом рисования.</p>
<h2 id="Specification">Спецификация</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Спецификация</th>
<th scope="col">Статус</th>
<th scope="col">Комментарий</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('HTML WHATWG', '#animation-frames', 'requestAnimationFrame')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td>Без изменений, заменяет предыдущую.</td>
</tr>
<tr>
<td>{{SpecName('RequestAnimationFrame', '#dom-windowanimationtiming-requestanimationframe', 'requestAnimationFrame')}}</td>
<td>{{Spec2('RequestAnimationFrame')}}</td>
<td>Первоначальное описание.</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Браузерная совместимость</h2>
<p id="Specification">{{Compat("api.Window.requestAnimationFrame")}}</p>
<h2 id="Смотрите_также">Смотрите также</h2>
<ul>
<li>{{ domxref("window.mozAnimationStartTime") }}</li>
<li>{{ domxref("window.cancelAnimationFrame()") }}</li>
<li><a class="external" href="http://weblogs.mozillazine.org/roc/archives/2010/08/mozrequestanima.html">mozRequestAnimationFrame</a> - Blog post</li>
<li><a class="external" href="http://paulirish.com/2011/requestanimationframe-for-smart-animating/">requestAnimationFrame for smart animating</a> - Blog post</li>
<li><a class="external" href="http://hacks.mozilla.org/2011/08/animating-with-javascript-from-setinterval-to-requestanimationframe/">Animating with javascript: from setInterval to requestAnimationFrame</a> - Blog post</li>
</ul>
|
