Пишем свой класс Tweenвремя вместо кадров, плавность и очередь анимаций
Собственный твин на ActionScript занимает сотню строк и объясняет устройство любой программной анимации. Пишем его и переносим ту же модель в браузер 2026 года.
- Раздел
- ActionScript
- Стек
- ActionScript 3JavaScriptWAAPIGSAP
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- Анимацию считают по времени, а не по кадрам.
- Сигнатура (t, b, c, d) подключает любую плавность Пеннера.
- Очередь строится на onComplete, в JS на await.
- В браузере: element.animate, requestAnimationFrame или GSAP.
- Запомните getTimer() в момент старта
- На ENTER_FRAME вычисляйте долю прошедшего времени
- Пропускайте долю через функцию плавности
- На последнем кадре ставьте точное конечное значение
- Вызывайте onComplete и запускайте следующий твин
Зачем писать свой Tween#
Во Flash анимацию кодом обычно делали готовыми классами: встроенным fl.transitions.Tween или библиотеками вроде TweenLite. Но собственный твин на сотню строк полезно написать хотя бы раз: становится понятно, из чего состоит любая программная анимация, и почему одни реализации плавные, а другие дёргаются. Эта модель без изменений живёт в JavaScript, поэтому заметка полезна и тем, кто Flash уже не застал. Сразу оговоримся: Flash Player снят с поддержки 31 декабря 2020 года, и запускать такой код в браузере сегодня негде. Ценность здесь в устройстве, а не в платформе.
Любой твин отвечает на один вопрос: какое значение должно быть у свойства прямо сейчас. Для ответа нужны пять величин:
- объект и имя свойства (например,
xуMovieClip); - начальное значение и конечное значение;
- длительность;
- функция плавности, которая превращает долю прошедшего времени в долю пройденного пути;
- колбэк завершения, чтобы запустить следующий шаг.
Наивная версия: шаг за кадр#
Первое, что приходит в голову: на каждом Event.ENTER_FRAME прибавлять к свойству фиксированное число.
// так делать не стоит: скорость зависит от FPS
addEventListener(Event.ENTER_FRAME, function(e:Event):void {
box.x += 5;
if (box.x >= 400) {
box.x = 400;
e.currentTarget.removeEventListener(Event.ENTER_FRAME, arguments.callee);
}
});Проблема в том, что кадр не равен единице времени. Ролик с частотой 30 кадров в секунду на загруженной машине может выдавать заметно меньше, и анимация, рассчитанная на секунду, растянется. А при смене stage.frameRate поменяется и скорость движения. Правильный подход: считать время, а кадр использовать только как момент, когда пора обновить картинку.
Твин на getTimer()#
Функция flash.utils.getTimer() возвращает число миллисекунд с момента запуска среды выполнения. Запоминаем его при старте, а на каждом кадре вычисляем, какая доля длительности прошла. Если кадр пропал, следующий просто покажет более позднее положение: анимация закончится вовремя.
package {
import flash.display.Shape;
import flash.events.Event;
import flash.utils.getTimer;
public class SimpleTween {
// один общий источник ENTER_FRAME на все твины
private static const ticker:Shape = new Shape();
private var target:Object;
private var prop:String;
private var from:Number;
private var to:Number;
private var duration:int; // миллисекунды
private var ease:Function; // function(t, b, c, d):Number
private var startTime:int;
public var onComplete:Function;
public function SimpleTween(target:Object, prop:String, to:Number,
duration:int, ease:Function = null) {
this.target = target;
this.prop = prop;
this.to = to;
this.duration = duration;
this.ease = (ease != null) ? ease : linear;
}
public function start():SimpleTween {
from = target[prop];
startTime = getTimer();
ticker.addEventListener(Event.ENTER_FRAME, update);
return this;
}
public function stop():void {
ticker.removeEventListener(Event.ENTER_FRAME, update);
}
private function update(e:Event):void {
var t:int = getTimer() - startTime;
if (t >= duration) {
target[prop] = to;
stop();
if (onComplete != null) onComplete();
return;
}
target[prop] = ease(t, from, to - from, duration);
}
public static function linear(t:Number, b:Number, c:Number, d:Number):Number {
return c * t / d + b;
}
public static function easeOutQuad(t:Number, b:Number, c:Number, d:Number):Number {
t /= d;
return -c * t * (t - 2) + b;
}
}
}Несколько решений здесь стоит пояснить. Начальное значение читается в start(), а не в конструкторе: так твин можно создать заранее и запустить позже. Последний кадр принудительно ставит точное конечное значение, иначе из-за округления объект остановится на 399,7 вместо 400. Подписка идёт на общий статический Shape: у себя мы держим один источник кадров на всё приложение, об этом подробнее в заметке про один цикл ENTER_FRAME.
Плавность и очередь#
Сигнатура (t, b, c, d) взята из уравнений Роберта Пеннера: время, начало, изменение, длительность. Её же используют fl.transitions.easing и большинство библиотек той эпохи, так что любую готовую функцию можно подставить без адаптера. Как устроены сами формулы, от quad до elastic и bounce, мы подробно разбирали в статье о функциях плавности.
Очередь анимаций строится на onComplete: каждый шаг запускает следующий.
var queue:Array = [
new SimpleTween(box, "x", 400, 600, SimpleTween.easeOutQuad),
new SimpleTween(box, "y", 300, 400, SimpleTween.easeOutQuad),
new SimpleTween(box, "alpha", 0, 300)
];
function runNext():void {
if (queue.length == 0) return;
var tw:SimpleTween = queue.shift();
tw.onComplete = runNext;
tw.start();
}
runNext();Чего в нашем классе нет и что пришлось бы добавить для боевого использования: защиты от двух твинов на одно свойство одновременно (они будут перетягивать значение), паузы с учётом прошедшего времени, анимации нескольких свойств одним объектом. Именно это и решали готовые библиотеки. Для учебной задачи и небольших баннеров хватало и такого класса: он предсказуем, его легко отладить трассировкой значений, а размер скомпилированного кода почти не растёт.
Готовые аналоги во Flash#
| Вариант | Как вызывался | Особенности |
|---|---|---|
fl.transitions.Tween | new Tween(box, "x", Regular.easeOut, 0, 400, 1, true) | одно свойство на твин, событие TweenEvent.MOTION_FINISH; без ссылки на объект твин мог собрать сборщик мусора посреди анимации |
| TweenLite | TweenLite.to(box, 1, {x: 400, onComplete: done}) | несколько свойств сразу, перезапись конфликтующих твинов, длительность в секундах |
| Свой класс | как выше | полный контроль и ни одной зависимости, но всё остальное пишете сами |
Проблема со сборщиком мусора у встроенного Tween была известной ловушкой: экземпляр, созданный в локальной переменной, иногда останавливался на середине. Лечили, сохраняя ссылку в поле класса. Эту и другие тонкости производительности мы собрали в подборке советов по оптимизации ActionScript.
Что изменилось к 2026 году#
Модель осталась прежней, сменились инструменты. В браузере роль ENTER_FRAME играет requestAnimationFrame, а роль getTimer() играет временная метка, которую он передаёт в колбэк. Наш класс почти дословно переносится на JavaScript:
function tween({ from, to, duration, ease = (p) => p, onUpdate }) {
return new Promise((resolve) => {
let start;
function frame(now) {
start ??= now;
const p = Math.min((now - start) / duration, 1);
onUpdate(from + (to - from) * ease(p));
if (p < 1) requestAnimationFrame(frame);
else resolve();
}
requestAnimationFrame(frame);
});
}
const easeOutQuad = (p) => 1 - (1 - p) * (1 - p);
await tween({ from: 0, to: 400, duration: 600, ease: easeOutQuad,
onUpdate: (v) => { box.style.transform = `translateX(${v}px)`; } });Колбэк завершения превратился в промис, а очередь анимаций стала обычной последовательностью await. Но для анимации CSS-свойств DOM-элементов чаще всего не нужно писать даже это. Web Animations API делает то же самое встроенными средствами и умеет выполнять часть анимаций вне основного потока:
const anim = box.animate(
[{ transform: 'translateX(0)' }, { transform: 'translateX(400px)' }],
{ duration: 600, easing: 'ease-out', fill: 'forwards' }
);
await anim.finished;Ручной цикл на requestAnimationFrame остаётся нужен там, где анимируется не CSS: canvas, WebGL, значения в состоянии приложения. Для сложных сценариев с таймлайнами, скроллом и SVG стандартом осталась GSAP, прямой наследник TweenLite; с 2025 года библиотека вместе с плагинами бесплатна, в том числе для коммерческих проектов. И одно правило, которого во Flash не было: уважайте prefers-reduced-motion и сокращайте или отключайте движение для тех, кто об этом попросил. Остальные заметки про наследие Flash собраны в разделе ActionScript.
«Кадр отвечает на вопрос «когда перерисовать», а время отвечает на вопрос «где сейчас объект».»
Главный вывод заметки


