Пишем свой класс Tween

Пишем свой класс Tweenвремя вместо кадров, плавность и очередь анимаций

Собственный твин на ActionScript занимает сотню строк и объясняет устройство любой программной анимации. Пишем его и переносим ту же модель в браузер 2026 года.

Раздел
ActionScript
Стек
ActionScript 3JavaScriptWAAPIGSAP
Уровень
Средний
Опубликовано
Обновлено
Чтение
8 мин
Коротко
  • Анимацию считают по времени, а не по кадрам.
  • Сигнатура (t, b, c, d) подключает любую плавность Пеннера.
  • Очередь строится на onComplete, в JS на await.
  • В браузере: element.animate, requestAnimationFrame или GSAP.
Как решаем
  1. Запомните getTimer() в момент старта
  2. На ENTER_FRAME вычисляйте долю прошедшего времени
  3. Пропускайте долю через функцию плавности
  4. На последнем кадре ставьте точное конечное значение
  5. Вызывайте onComplete и запускайте следующий твин

Зачем писать свой Tween#

Во Flash анимацию кодом обычно делали готовыми классами: встроенным fl.transitions.Tween или библиотеками вроде TweenLite. Но собственный твин на сотню строк полезно написать хотя бы раз: становится понятно, из чего состоит любая программная анимация, и почему одни реализации плавные, а другие дёргаются. Эта модель без изменений живёт в JavaScript, поэтому заметка полезна и тем, кто Flash уже не застал. Сразу оговоримся: Flash Player снят с поддержки 31 декабря 2020 года, и запускать такой код в браузере сегодня негде. Ценность здесь в устройстве, а не в платформе.

Любой твин отвечает на один вопрос: какое значение должно быть у свойства прямо сейчас. Для ответа нужны пять величин:

  • объект и имя свойства (например, x у MovieClip);
  • начальное значение и конечное значение;
  • длительность;
  • функция плавности, которая превращает долю прошедшего времени в долю пройденного пути;
  • колбэк завершения, чтобы запустить следующий шаг.

Наивная версия: шаг за кадр#

Первое, что приходит в голову: на каждом Event.ENTER_FRAME прибавлять к свойству фиксированное число.

ActionScript 3
// так делать не стоит: скорость зависит от 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() возвращает число миллисекунд с момента запуска среды выполнения. Запоминаем его при старте, а на каждом кадре вычисляем, какая доля длительности прошла. Если кадр пропал, следующий просто покажет более позднее положение: анимация закончится вовремя.

ActionScript 3
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: каждый шаг запускает следующий.

ActionScript 3
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.Tweennew Tween(box, "x", Regular.easeOut, 0, 400, 1, true)одно свойство на твин, событие TweenEvent.MOTION_FINISH; без ссылки на объект твин мог собрать сборщик мусора посреди анимации
TweenLiteTweenLite.to(box, 1, {x: 400, onComplete: done})несколько свойств сразу, перезапись конфликтующих твинов, длительность в секундах
Свой класскак вышеполный контроль и ни одной зависимости, но всё остальное пишете сами

Проблема со сборщиком мусора у встроенного Tween была известной ловушкой: экземпляр, созданный в локальной переменной, иногда останавливался на середине. Лечили, сохраняя ссылку в поле класса. Эту и другие тонкости производительности мы собрали в подборке советов по оптимизации ActionScript.

Что изменилось к 2026 году#

Модель осталась прежней, сменились инструменты. В браузере роль ENTER_FRAME играет requestAnimationFrame, а роль getTimer() играет временная метка, которую он передаёт в колбэк. Наш класс почти дословно переносится на JavaScript:

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 делает то же самое встроенными средствами и умеет выполнять часть анимаций вне основного потока:

JavaScript
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.

31.12.2020конец поддержки Flash Player
4аргумента в функции Пеннера
element.animateвстроенный твин браузера

«Кадр отвечает на вопрос «когда перерисовать», а время отвечает на вопрос «где сейчас объект».»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Почему твин на getTimer() лучше шага за кадр?
Шаг за кадр привязывает скорость к частоте кадров: на медленной машине или при смене frameRate анимация растягивается. Твин на времени вычисляет положение по прошедшим миллисекундам, поэтому заканчивается вовремя, а пропущенный кадр просто покажет более позднее состояние.
Что означают параметры t, b, c, d в функциях плавности?
Это нотация уравнений Роберта Пеннера: t это прошедшее время, b начальное значение, c полное изменение (конец минус начало), d длительность. Функция возвращает текущее значение свойства. Такую сигнатуру понимают fl.transitions.easing и большинство твин-библиотек той эпохи.
Можно ли сегодня запустить такой код?
Flash Player снят с поддержки 31 декабря 2020 года, браузеры его не запускают. ActionScript можно собрать под AIR для настольных и мобильных приложений, но для веба идеи нужно переносить на JavaScript: requestAnimationFrame, Web Animations API или GSAP.
Когда в браузере писать свой твин, а когда брать element.animate?
Для CSS-свойств DOM-элементов берите element.animate или CSS-переходы: это короче и может работать вне основного потока. Свой цикл на requestAnimationFrame нужен для canvas, WebGL и чисел в состоянии приложения, а GSAP для сложных таймлайнов и анимаций по скроллу.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также