omniark문의 ↗
개발 노트›홈페이지 스크롤 애니메이션, 클로드에 이렇게 시키세요 (프롬프트 5줄)

DEV NOTE

홈페이지 스크롤 애니메이션, 클로드에 이렇게 시키세요 (프롬프트 5줄)

AI로 만든 홈페이지가 밋밋할 때: 스크롤 리빌·스태거·패럴랙스, 문제마다 고치는 이름 세 개와 클로드에 붙여 넣는 5줄. 켜고 끄며 비교하는 플레이어 포함.

지금은 효과 세 개를 다 켠 상태입니다. 스크롤해 보세요. '전부 끄기'를 누르면 원래 모습(전부 처음부터 깔림)이 되고, 하나씩 다시 켤 수 있습니다. 가상의 가게입니다.

1문제 3개, 이름 3개

스크롤하는 홈페이지에서 생기는 문제는 세 가지이고, 문제마다 고치는 이름이 하나씩 있습니다. 왼쪽이 문제 상태, 오른쪽이 그 이름으로 고친 상태입니다(혼자 아래로 내려갔다 올라오는 중이고, 직접 스크롤해도 됩니다).

문제 ①내용이 처음부터 다 깔려 있다

스크롤해도 화면에 들어오는 순간 아무 일도 일어나지 않아서, 페이지가 한 장의 종이처럼 밋밋합니다.

문제 상태
해결: 스크롤 리빌

해결: 스크롤 리빌 scroll reveal

화면에 들어올 때 아래에서 떠오르며 나타나는 것. 시간은 0.6초 안팎, 끝이 부드러운 이징(ease-out)으로 하세요. 너무 느리면 사람이 기다립니다.

"요소가 화면에 들어올 때 아래에서 올라오며 서서히 나타나게 해(0.6초, ease-out)."
문제 ②카드가 한꺼번에 뚝 나온다

스크롤 리빌은 있는데, 카드 셋이 동시에 나타나서 기계가 찍어 낸 것 같습니다.

문제 상태
해결: 스태거

해결: 스태거 stagger

같은 줄의 요소를 조금씩 어긋나게 차례로 나타내는 것. 간격은 0.1초 안팎이 좋고, 길어지면 마지막 카드가 너무 늦게 나옵니다.

"같은 줄의 카드는 0.1초씩 간격을 두고 차례로 나타나게 해."
문제 ③배경과 글자가 같은 속도다

글자와 배경이 똑같이 올라가서 화면이 평평합니다. 겹겹의 깊이가 없습니다.

문제 상태
해결: 패럴랙스

해결: 패럴랙스 parallax

배경이 앞의 글자보다 느리게 따라와 깊이가 생기는 것. 배경 속도는 글자의 절반이면 충분하고, 너무 다르면 멀미가 납니다.

"첫 화면 배경은 글자보다 절반 속도로 천천히 움직이게 해."

2복사해서 쓰는 5줄

홈페이지를 시킬 때 지시문 맨 끝에 붙이세요. 세 개의 이름에 '움직임 줄이기'와 금지선 하나가 더 있습니다. 움직임에 민감한 사람을 위한 배려(prefers-reduced-motion)는 꼭 넣으세요.

- 스크롤 리빌: 요소가 화면에 들어올 때 아래에서 올라오며 서서히 나타나게 해(0.6초, 끝이 부드러운 ease-out). - 스태거: 같은 줄의 카드·문단은 0.1초씩 간격을 두고 차례로 나타나게 해. - 패럴랙스: 첫 화면 배경은 글자보다 절반 속도로 천천히 움직이게 해. - 움직임 줄이기 설정을 켠 사람에게는 효과 없이 바로 다 보이게 해(prefers-reduced-motion). - 효과를 위해 라이브러리를 새로 깔지 말고, 모바일 폭(375px)에서도 가로 스크롤이 생기면 안 돼.

짧게 한 줄로

스크롤하면 카드가 차례로 떠오르게 하고(스태거), 배경은 글자보다 느리게 움직이게 해줘(패럴랙스). 움직임 줄이기 설정이면 효과 없이.

전체 예시 (위 베이커리 홈페이지)

HTML 파일 하나로 동네 베이커리 홈페이지를 만들어 줘(가상의 가게, 밝은 크림색 바탕, 글꼴 Pretendard). - 첫 화면: 어두운 배경에 큰 제목 "우리 동네 로컬 베이커리", 아래에 한 줄 "매일 아침 6시, 갓 구운 빵이 나옵니다." - "오늘의 빵" 섹션: 흰 카드 3장(소금빵·크루아상·식빵), 카드마다 한 줄 설명 - "천천히, 정직하게" 섹션: 왼쪽 그림 자리(그라디언트 상자), 오른쪽 문단 2개 - "찾아오시는 길" 섹션: 카드 2장(영업시간 06:00–18:00, 위치는 가상의 주소) [스크롤 연출] - 스크롤 리빌: 요소가 화면에 들어올 때 아래에서 올라오며 서서히 나타나게 해(0.6초, 끝이 부드러운 ease-out). - 스태거: 같은 줄의 카드·문단은 0.1초씩 간격을 두고 차례로 나타나게 해. - 패럴랙스: 첫 화면 배경은 글자보다 절반 속도로 천천히 움직이게 해. - 움직임 줄이기 설정을 켠 사람에게는 효과 없이 바로 다 보이게 해(prefers-reduced-motion). - 효과를 위해 라이브러리를 새로 깔지 말고, 모바일 폭(375px)에서도 가로 스크롤이 생기면 안 돼.

3실제로 Claude에 넣어 봤습니다

위 전체 예시를 제 작업 기억이 없는 새 Claude 대화(Claude Code)에 그대로 넣었습니다. 아래가 받은 결과 그대로이고, 직접 스크롤해 볼 수 있습니다.

  • 한 번에 통과: 효과 세 개 모두 들어왔고, 수정 요청 없이 첫 결과가 맞았습니다.
  • 처음엔 아래 요소가 숨겨져 있다가 스크롤하면 나타남(숨은 요소 5곳), 같은 줄 카드는 0.1초씩 어긋남
  • 움직임 줄이기를 켜고 열면 내용이 전부 바로 보임(남은 투명한 것은 장식용 입자 덮개 하나)
  • 375px 폭에서 가로 스크롤 없음

시험 조건: 2026년 11월 4일, 제 PC의 Claude Code, 새 대화 1번. 이 PC의 Claude는 제 작업용 품질 규칙을 함께 읽기 때문에 여러분의 결과는 조금 다를 수 있습니다. 그 Claude는 브라우저를 열 수 없는 환경이라 결과를 눈으로 확인하지 못했다고 스스로 밝혔고, 위 확인은 제가 했습니다.

4따라 하기

  1. 만들고 싶은 홈페이지를 평소처럼 지시문으로 씁니다.
  2. 그 끝에 '5줄'을 붙여 Claude(claude.ai)에 보냅니다.
  3. 받은 코드를 메모장에 붙여 .html로 저장합니다(파일 형식 "모든 파일", 인코딩 "UTF-8").
  4. 파일을 두 번 클릭해 열고, 아래를 확인합니다.
  • 스크롤하면 아래 요소가 떠오르며 나타난다
  • 같은 줄의 카드가 차례로 나타난다
  • 첫 화면 배경이 글자보다 느리게 움직인다
  • 운영체제의 '움직임 줄이기'를 켜면 효과 없이 바로 다 보인다
  • 휴대폰 폭에서 가로로 밀리지 않는다

5팁

효과는 한 화면에 한두 개만 쓰세요.

다 움직이면 아무것도 안 보입니다. 위 플레이어에서 세 개를 다 켜면 화려하지만, 실제 페이지에서는 가장 보여 주고 싶은 곳에만 쓰세요.

시간은 0.6초를 넘기지 마세요.

효과가 길수록 사람은 기다립니다. 지시문에 "0.6초, ease-out"처럼 숫자를 적으면 AI가 알아서 늘리지 않습니다.

움직임 줄이기를 꼭 시험하세요.

윈도우는 설정 → 접근성 → 시각 효과의 '애니메이션 효과', 맥은 시스템 설정 → 손쉬운 사용 → 디스플레이의 '동작 줄이기'에서 끌 수 있습니다. 켠 채로 페이지를 열어 내용이 모두 보이는지 보세요.

6코드 전문

위 플레이어의 핵심 부품입니다. render()가 스크롤 위치 y를 받아 세 효과를 계산하고, 켜고 끄는 것은 set()입니다. 효과가 전부 '스크롤 위치의 함수'라 되감아도 똑같이 보입니다.

scrolldemo.js 펼쳐 보기
// 003 스크롤 데모: 효과 세 가지(reveal 스크롤 리빌 · stagger 스태거 · parallax 패럴랙스)를 켜고 끄는 가짜 베이커리 홈페이지.
// 효과는 전부 '스크롤 위치 y 의 함수'다(CSS 스크롤 연동 애니메이션 view() 와 같은 생각) - 되감기·건너뛰기·영상 렌더가 그대로 되고, 켜기/끄기로 레이아웃이 흔들리지 않는다.
//   const sd = ScrollDemo(호스트 div, { virtual }); sd.set(["reveal", ...]); sd.render(y)
//   virtual=true: 브라우저 스크롤 대신 내용을 위로 밀어 보인다(영상용, 호스트 크기 고정). false: 실제 스크롤 + scroll 이벤트(블로그 플레이어)
// 움직임 줄이기 설정(prefers-reduced-motion)이면 실제 스크롤 모드에서는 효과를 켜지 않는다.
window.ScrollDemo = (host, { virtual = false } = {}) => {
  const clamp = (x, a = 0, b = 1) => Math.min(b, Math.max(a, x));
  host.classList.add("sd");
  host.innerHTML = `<div class="sd-page"><div class="sd-in">
    <section class="sec hero"><div class="bg" data-speed=".5">06<i>:</i>00</div>
      <nav><b>하루제빵소</b><span>빵</span><span>이야기</span><span>오시는 길</span></nav>
      <div class="hd"><small>EST. 2019 · 가상의 가게</small><h1>하루 한 번,<br>정직한 반죽.</h1><p>매일 아침 6시, 갓 구운 빵이 나옵니다.</p></div></section>
    <section class="sec" id="s-cards"><h2 class="rv" data-i="0">오늘의 빵</h2>
      <div class="cards"><div class="card c1 rv" data-i="1"><em>3,800</em><b>소금빵</b><span>겉은 바삭, 속은 쫄깃.</span></div><div class="card c2 rv" data-i="2"><em>4,500</em><b>크루아상</b><span>버터 향이 층층이.</span></div><div class="card c3 rv" data-i="3"><em>6,200</em><b>식빵</b><span>아침 토스트에 딱.</span></div></div></section>
    <section class="sec" id="s-row"><div class="row"><div class="pic rv" data-i="0"><span>밀가루</span><span>물</span><span>소금</span><span>시간</span></div><div class="txt"><h2 class="rv" data-i="0">천천히, 정직하게</h2><p class="rv" data-i="1">첨가물 없이 하루 한 번 반죽합니다.</p><p class="rv" data-i="2">매장에서 구워 바로 드립니다.</p></div></div></section>
    <section class="sec" id="s-info"><h2 class="rv" data-i="0">찾아오시는 길</h2><div class="cards two"><div class="card c1 rv" data-i="1"><b>영업시간</b><em>06:00–18:00</em></div><div class="card c2 rv" data-i="2"><b>위치</b><span>가상의 주소 · 예시용 페이지</span></div></div></section>
    <div class="foot">하루제빵소 · 예시용 가상의 가게입니다.</div>
  </div></div>`;
  const page = host.firstElementChild, inn = page.firstElementChild;
  if (virtual) host.classList.add("fix");   // 영상·썸네일: 창 크기(vw·vh)와 상관없이 호스트 크기로 고정(1920 창에서 글자가 커지던 것 - 실측)
  const hero = inn.querySelector(".hero"), fit = () => { hero.style.minHeight = host.clientHeight + "px" }; fit(); if (!virtual) addEventListener("resize", () => { fit(); api.render() });
  const rv = [...inn.querySelectorAll(".rv")], sp = [...inn.querySelectorAll("[data-speed]")];
  const pos = e => { let y = 0; for (; e && e !== inn; e = e.offsetParent) y += e.offsetTop; return y };
  let on = new Set(), cache = null;
  const tops = () => cache || (cache = new Map(rv.map(e => [e, pos(e)])));
  const reduce = !virtual && matchMedia("(prefers-reduced-motion: reduce)").matches;
  const api = {
    set(list) { on = new Set(reduce ? [] : list); api.render(api.y) },
    on: () => [...on],
    pos: sel => pos(inn.querySelector(sel)),                        // 그 요소가 페이지 맨 위에서 몇 px 아래인지(영상이 스크롤 목표를 잡을 때)
    maxY: () => inn.scrollHeight - host.clientHeight,
    y: 0,
    render(y) {
      cache = null; const H = host.clientHeight;
      if (virtual) { y = y == null ? 0 : y; inn.style.transform = `translateY(${-y}px)` } else y = page.scrollTop;
      api.y = y;
      const T = tops();
      rv.forEach(e => {
        if (!on.has("reveal")) { e.style.opacity = ""; e.style.transform = ""; return }
        const i = on.has("stagger") ? +e.dataset.i || 0 : 0;      // 스태거: 같은 줄의 형제를 i 번째마다 60px 늦게 시작
        const t = clamp((y + H - T.get(e) - 40 - i * 60) / 220), k = 1 - Math.pow(1 - t, 3);
        e.style.opacity = k; e.style.transform = `translateY(${(1 - k) * 44}px)`;
      });
      sp.forEach(e => e.style.transform = on.has("parallax") ? `translateY(${y * +e.dataset.speed * .5}px)` : "");   // 배경은 스크롤의 1/4·1/8 만큼 따라 내려와 느리게 뒤처진다
    },
  };
  if (!virtual) page.addEventListener("scroll", () => api.render(), { passive: true });
  return api;
};

7다음 편

움직임 다음은 정돈입니다. AI가 만든 보고서·슬라이드가 촌스러울 때 — 위계·정렬·그리드.