GSAP 사례 연구
Edit a path in the browser
포인터 · MIT (local companion); GSAP Standard No Charge License (runtime)
갤러리 안에서는 화면을 벗어나거나 움직임을 멈추면 예제도 닫힙니다. 다시 재생할 때는 처음부터 시작해요.
저장한 HTML에서는 갤러리의 재생 설정이 적용되지 않아요.
SOURCE FILES
독립 예제 코드 읽기
사례의 구도나 문서의 원리를 바탕으로 새로 만든 예제입니다. 아래 코드를 복사해 직접 응용할 수 있습니다. 실행 HTML에는 미리보기를 위한 실행 환경이 들어 있습니다.
vendor/gsap-previews/sources/gsap-1cc56fdfac64/source-input.js
let tween = gsap.to("#id", {
motionPath: {
path: "#path",
align: "#path",
alignOrigin: [0.5, 0.5],
},
});
// pass the tween instance in here...
MotionPathHelper.create(tween);vendor/gsap-previews/sources/gsap-1cc56fdfac64/index.html실행 안내·자료
<main class="study"><p class="study-label">공식 문서 기반 · 독립 예제</p><header><h2>점으로 경로를 편집하기</h2><p>보이는 제어점은 공식 MotionPathHelper가 생성합니다. SVG와 재생 버튼은 이 예제에서 구성했습니다.</p></header><div class="stage"><svg id="path-stage" viewBox="0 0 640 320" role="img" aria-label="편집 가능한 곡선과 움직이는 도형"><path id="path" d="M60 245C115 15 300 25 340 165S465 315 580 65" fill="none" stroke="#95efd2" stroke-width="3"/><rect id="id" width="28" height="28" rx="7" fill="#b39fff"/></svg></div><div class="controls"><button id="replay" type="button">다시 재생</button></div><p class="note">경로를 드래그하는 원리의 예제입니다. 별도의 키보드 경로 편집기는 포함하지 않습니다.</p></main>함께 쓰는 파일 3개 보기
vendor/gsap-previews/sources/gsap-1cc56fdfac64/style.css실행 안내·자료
*{box-sizing:border-box}body{background:#111522;color:#f5f2eb;font-family:system-ui,sans-serif;margin:0}button{font:inherit}.study{margin:0 auto;max-width:1100px;min-height:100vh;padding:clamp(20px,4vw,42px)}.study-label{color:#95efd2;font-size:12px;letter-spacing:.08em;margin:0 0 24px}header h2{font-size:clamp(24px,4vw,40px);letter-spacing:-.04em;margin:0 0 12px}header p{color:#aeb7c9;line-height:1.6;margin:0 0 24px;max-width:62ch}.controls{display:flex;flex-wrap:wrap;gap:8px;margin:20px 0}button{background:#26314b;border:1px solid #617394;border-radius:9px;color:#f5f2eb;cursor:pointer;padding:9px 14px}button:hover{background:#334261}button:focus-visible{outline:3px solid #95efd2;outline-offset:3px}button:disabled{cursor:default;opacity:.45}.stage{align-items:center;background:radial-gradient(ellipse at top,#243253,#141c2d);border:1px solid #3d4c68;border-radius:20px;display:flex;justify-content:center;min-height:220px;overflow:hidden;position:relative}.note{color:#aeb7c9;font-size:13px;line-height:1.5}.readout{color:#95efd2;font-family:ui-monospace,monospace;font-size:13px;min-height:2em}.stage svg{display:block;max-width:100%}code{font-family:ui-monospace,monospace}button[aria-pressed="true"]{background:#95efd2;color:#111522}
#path-stage{overflow:visible;width:100%}.stage{overflow:visible}vendor/gsap-previews/sources/gsap-1cc56fdfac64/script.js실행 안내·자료
gsap.registerPlugin(MotionPathPlugin,MotionPathHelper);
let tween = gsap.to("#id", {
motionPath: {
path: "#path",
align: "#path",
alignOrigin: [0.5, 0.5],
},
});
// pass the tween instance in here...
MotionPathHelper.create(tween);
document.getElementById('replay').addEventListener('click',()=>tween.restart());LICENSE실행 안내·자료
Locally authored companion HTML/CSS/control wiring: MIT License.
Copyright (c) 2026 StyleGallery contributors
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
The separately retained official documentation excerpt is source input, not a recovered CodePen source set; this local MIT notice does not assign a new license to that excerpt.
GSAP 3.15.0: Copyright 2026, GreenSock. All rights reserved. Subject to https://gsap.com/standard-license. Original library notices are preserved.
BEHIND THE EXAMPLE
이 장면을 만드는 원리
정렬된 이동과 드래그 편집의 경계
드래그 편집을 제품 기능으로 제공할 때 클릭·탭과 키보드 대안을 별도로 설계합니다.
- 이 예제에서는
- 문서는 path·align을 같은 #path로 지정하고 alignOrigin:[0.5,0.5]인 트윈을 MotionPathHelper.create에 전달합니다. 동반 예제는 새 SVG와 다시 재생 버튼을 제공합니다. 경로 제어점은 라이브러리가 만들며 독립적인 키보드 좌표 편집기를 추가한 예제는 아닙니다.
코드와 함께 확인하기
코드에서 찾기
MotionPathHelper.create(tween)source-input.js만든 트윈을 실제 경로 편집 도구에 전달합니다.
alignOrigin: [0.5, 0.5]source-input.js대상의 중앙을 경로에 정렬하는 입력입니다.
직접 해보기
제어점을 드래그한 후 다시 재생합니다.
살펴볼 변화편집한 경로와 대상 정렬이 어떻게 갱신되는지 실제로 확인합니다.
키보드만으로 같은 곡선 좌표를 지정하려고 합니다.
살펴볼 변화별도 키보드 편집 경로를 구현했다고 가정하지 않고 남은 입력 한계를 기록합니다.
