용어 · 도구·코드

웹 움직임 라이브러리

JS Motion Libraries

웹 요소를 움직이는 코드를 대신 써 주는 도구들. GSAP 와 anime.js 는 ‘무엇을 얼마나 오래 어떤 곡선으로’를 한 줄에 적고, Theatre.js 는 키프레임을 시각 편집기(Studio)에서 찍는다.

중급설명타이밍과 리듬

01직접 돌려 보기

‘연출 전’은 대충 시켰을 때를 가정해 만든 화면이고 실제 AI 결과와 다를 수 있다.

연출 전흔한 첫 결과
연출 후완성본
0.00초 / 4.0초

02이름으로 시키는 지시문

대충 시킴웹에서 공이 부드럽게 움직이게 해줘→ 어떤 도구로 몇 초 동안 어떤 곡선을 쓸지 빠져 있어서, 도구도 속도도 매번 다르게 돌아온다
이름으로 시킴GSAP 로 gsap.to 를 써서 공이 오른쪽으로 480px, 0.4초 기다렸다가 1.2초 동안 ease 는 power2.out 으로→ gsap.to 한 줄에 480px, 0.4초 대기, 1.2초, power2.out 이 그대로 들어간 코드
Claude Code · Codex에 그대로 붙여 넣기

장면: 공 하나가 오른쪽으로 움직이는 한 장면을 세 가지 JavaScript 도구가 각각 어떻게 적는지 보여 주는 애니메이션. 세 줄(레인)로 나누고, 각 줄 왼쪽에는 그 도구의 코드 4~6줄, 오른쪽에는 공이 움직이는 트랙과 0~3.2초 시간 눈금을 둔다.

움직임: 공이 오른쪽으로 480px 이동, 0.4초 기다렸다가 1.2초 동안 움직이고 끝에서 감속(outCubic).

GSAP 줄: gsap.to(".ball", { x: 480, duration: 1.2, delay: 0.4, ease: "power2.out" }).

anime.js 줄: animate('.ball', { x: 480, duration: 1200, delay: 400, ease: 'outCubic' }).

Theatre.js 줄: sheet.object('Ball', { x: 0 }) 의 값이 바뀔 때마다 onValuesChange 로 el.style.left 를 바꾸고 sheet.sequence.play() 로 재생. 키프레임은 Studio 화면에서 찍는다는 주석을 달고, 눈금 위에 키프레임 마름모 두 개를 그린다.

눈금: 세 공은 같은 시각에 출발해 같은 시각에 도착한다. 눈금 위에는 움직이는 구간을 막대로, 현재 시각을 붉은 선으로 나타낸다.

숫자: 코드 숫자(480, 1.2, 0.4)와 화면에 쓰는 ‘0.4초 대기 → 1.2초 이동’은 서로 같아야 한다.

연출 전: GSAP 한 줄만 있고 ease: "none"(같은 속도로 움직임).

금지: 도구마다 공의 속도나 도착 시각이 다른 것, 코드에 적은 숫자와 화면 숫자가 다른 것.

구현에 쓰이는 기술: GSAP: gsap.to(대상, { x, duration, delay, ease })anime.js: animate(대상, { x, duration, delay, ease })Theatre.js: getProject → project.sheet → sheet.object → onValuesChange, sheet.sequence.play()CSS transition · animation 과 Web Animations API(라이브러리 없이 쓰는 방법)

03응용 팁

팁은 데모에서 값만 바꿔 같은 장면과 비교한 것이다. AI가 같은 결과를 내는지는 직접 해 봐야 안다.

1

공이 너무 멀리 간다

화면 폭에 비해 이동 거리가 클 때

지시문에서
공이 오른쪽으로 480px 이동
이렇게 바꾸세요
공이 오른쪽으로 300px 이동
그러면
세 줄의 공이 도착하는 자리가 왼쪽으로 가까워지고 코드의 x 값도 480 에서 300 으로 바뀐다. 같은 1.2초에 가는 거리가 줄어서 속도는 느려 보인다.
확인
2

움직임이 너무 빠르다

공이 휙 지나가서 감속이 보이지 않을 때

지시문에서
1.2초 동안 움직이고
이렇게 바꾸세요
2.4초 동안 움직이고
그러면
1.0초 시점에 공은 가는 길의 약 88% 에서 58% 지점으로 물러나 있다. 코드의 duration 은 1.2 에서 2.4 로 바뀐다(anime.js 는 2400). 끝에서 서서히 멈추는 모습은 길어지지만 도착 시각이 2.8초로 늦어진다.
확인

04만드는 순서

각 단계의 버튼을 누르면 위의 데모가 그 단계까지의 모습으로 바뀝니다.

  1. 같은 속도로 가는 공

    GSAP 한 줄로 공이 480px 를 0.4초 기다렸다가 1.2초 동안 움직인다. ease: "none" 은 직선(같은 속도)이라 도착하는 순간 툭 멈추는 느낌이 난다.

    gsap.to(".ball", {
      x: 480, duration: 1.2,
      delay: 0.4, ease: "none",
    });
  2. 끝에서 감속하는 ease

    ease 를 "power2.out" 으로 바꾸면 출발은 빠르고 끝에서 천천히 멈춘다. 이름은 ‘기본이름.방향’ 꼴이고 in, out, inOut 세 방향이 있다. 숫자는 그대로 두고 ease 한 줄만 달라졌다.

    gsap.to(".ball", {
      x: 480, duration: 1.2,
      delay: 0.4, ease: "power2.out",
    });
  3. 다른 도구는 어떻게 적나

    anime.js 는 비슷한 모양에 시간을 밀리초(1200, 400)로 적고, ease 이름도 ‘outCubic’ 처럼 종류와 방향을 붙인다. Theatre.js 는 움직임 자체를 코드 대신 Studio 화면의 키프레임으로 찍고, 코드는 그 값을 화면에 반영하는 일만 맡는다.

    animate('.ball', {
      x: 480, duration: 1200,
      delay: 400, ease: 'outCubic',
    });

05전문용어 풀이

트윈Tween

시작 값과 끝 값 사이를 자동으로 채워 움직이는 것. gsap.to() 한 번이 트윈 하나다.

AI에게“gsap.to 로 x 를 480 까지 트윈해줘”
이징Ease

시간에 따라 속도가 변하는 모양이며, none 은 같은 속도, power2.out 은 끝에서 감속.

AI에게ease 는 power2.out
지연Delay

움직임이 시작하기 전에 기다리는 시간. GSAP 는 초 단위, anime.js 는 밀리초 단위로 적는다.

AI에게“0.4초 delay 를 줘”
키프레임Keyframe

‘이 시각에 이 값’이라고 찍어 둔 점이고, 점과 점 사이는 자동으로 채워진다.

AI에게0.4초와 1.6초에 키프레임

06결과를 받으면 이것부터 확인

  • 연출 전에는 공이 같은 속도로 가고 GSAP 코드에 ease: "none" 이 적혀 있다
  • 2단계에서 공이 끝으로 갈수록 눈에 띄게 느려지고 코드가 ease: "power2.out" 으로 바뀐다
  • 3단계에는 줄이 세 개(GSAP, anime.js, Theatre.js)이다
  • 세 공이 0.4초에 함께 출발해 1.6초에 함께 도착하는가?
  • 코드의 480, 1.2, 0.4 가 화면의 ‘0.4초 대기 → 1.2초 이동’과 같다. anime.js 코드에서는 시간이 1200, 400 으로 적힌다
  • 시간 눈금 위의 키프레임 마름모 두 개는 Theatre.js 줄에만 있다

07이럴 때 쓰세요

  • AI에게 웹 움직임을 시킬 때 부를 도구 이름 정하기
  • 코드로 쓸지 편집기에서 키프레임을 찍을지 고르는 갈림길

08같이 쓰는 용어

09근거와 확인 범위

‘확인’은 출처 문서에서 사실로 확인한 내용, ‘추정’은 결과물을 보고 추론한 내용, ‘원본 없음’은 흔히 쓰이지만 대표 원본 사례를 확인하지 못해 성공 사례로 제시하지 않은 기법이다.

  • 확인gsap.to(targets, vars) 는 대상을 현재 값에서 vars 값까지 움직인다. 예: gsap.to(".box", { x: 100, duration: 1, ease: "power2.out" }). x 는 translateX 의 단축이고 duration 은 초 단위(기본 0.5), ease 기본값은 power1.out 이며 delay 같은 특별 속성이 있다고 설명한다. GSAP — gsap.to()
  • 확인GSAP 의 ease 이름: power1~power4, back, bounce, elastic, expo, circ, sine, steps, none(직선). power2.out 처럼 ‘기본이름.in / out / inOut’ 꼴로 쓴다. GSAP — Eases
  • 확인GSAP 가격 페이지는 2026-11-12 에 연 시점에 ‘웹플로의 후원으로 모든 사용자에게 100% 무료’라고 안내한다. 라이선스 조건 자체는 이 페이지에 적혀 있지 않아, 상업적 사용 조건은 직접 확인해야 한다. GSAP — Pricing
  • 확인anime.js 는 import { animate } from 'animejs' 로 가져와 animate(targets, parameters) 꼴로 쓴다. 지속 시간은 밀리초 숫자(예: duration: 600)이고 값에 단위를 문자열로 붙일 수 있으며(예: '10rem'), 문서 사이트는 4.0.0, 3.2.2, 2.1.0 버전을 나눠 안내한다. anime.js — Animation
  • 확인anime.js 의 내장 ease 는 ‘종류 + 방향’ 이름(outQuad, inOutCubic 등)이고 linear 에만 방향이 없다. 예시 코드는 animate(target, { x: 100, ease: 'outQuad' }). anime.js — Built-in eases
  • 확인Theatre.js 는 모션 그래픽용 애니메이션 라이브러리로, 코드와 시각 편집을 함께 쓰며 HTML/SVG, 3D, 변수 등을 움직인다. README 에 따르면 @theatre/core(런타임)는 Apache 라이선스, @theatre/studio(시각 편집기)는 AGPL 3.0 이다. GitHub — theatre-js/theatre (README)
  • 확인Sheet Objects 예시: sheet.object('obj', { foo: 0 }) 으로 객체를 만들고 onValuesChange((values) => { … }) 안에서 el.style.left = values.x + 'px' 처럼 값을 화면에 반영한다. 시퀀스(Sequences)는 별도 문서에서 다룬다. Theatre.js — Sheet Objects
  • 확인core API 목록: getProject(id, config), project.sheet(name), sheet.object(key, config), sheet.sequence.play(opts?)(Promise 반환), project.ready. Theatre.js — API: core