Timeline, определённая одним или несколькими KeyFrame, обрабатывает отдельные KeyFrame последовательно в порядке, указанном KeyFrame.time. Анимированные свойства, определённые как ключевые значения в KeyFrame.values, интерполируются от/до целевых ключевых значений в указанное время KeyFrame, к начальному положению Timeline, зависит от направления Timeline.

Timeline обрабатывает отдельные KeyFrame по истечении указанного интервала времени, не гарантируя точное время обработки KeyFrame.

Animation.cycleDurationProperty() будет установлено в максимальное значение времени ключевых кадров Timeline.

Если для KeyFrame не указано значение для time==0s момента, оно будет синтезировано с использованием текущих целевых значений на момент вызова Animation.play() или Animation.playFromStart().

Невозможно изменить keyFrames выполняющейся Timeline. Если значение keyFrames изменено для работающей Timeline, её необходимо остановить и запустить заново, чтобы использовать новое значение.

Простой Timeline может быть создан так:

 final Timeline timeline = new Timeline();
 timeline.setCycleCount(2);
 timeline.setAutoReverse(true);
 timeline.getKeyFrames().add(new KeyFrame(Duration.millis(5000),
   new KeyValue (node.translateXProperty(), 25)));
 timeline.play();
 

Этот Timeline будет выполняться 10 секунд, анимируя узел по оси x до значения 25, а затем обратно к 0 на втором цикле.

Предупреждение: Выполняемый Timeline ссылается на среду выполнения FX. Бесконечный Timeline может привести к утечке памяти, если не остановлен должным образом. Все объекты с анимированными свойствами не будут удалены сборщиком мусора.