Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

scroll-progress-timeline

/scroll-progress-timeline

Zamienia uporządkowany proces w oparty na danych pionowy lub poziomy scroll story z linią bazową, wypełnieniem postępu, stanami aktywnych kroków i zachowaniem przy reduced-motion.

Repozytorium
Skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zamienia uporządkowany proces w oparty na danych pionowy lub poziomy scroll story z linią bazową, wypełnieniem postępu, stanami aktywnych kroków i zachowaniem przy reduced-motion.

Oryginalny opis (EN)

Turn any ordered process into a data-driven vertical or horizontal scroll story with a base line, progress fill, active step states, responsive collapse, semantic fallback, and reduced-motion behavior. Use for onboarding, checkout, roadmaps, recipes, case studies, service processes, histories, or narratives where progress through the sequence should become visible while scrolling.

Jak działa

  1. Model the steps
  2. Build the line
  3. Choose the layout
  4. Animate step state
  5. Handle navigation
  6. Reduce motion
  7. Verify
Sekcje z nagłówków SKILL.md, w oryginale · 69 linii, 535 słów
Podgląd SKILL.md
---
name: scroll-progress-timeline
description: Turn any ordered process into a data-driven vertical or horizontal scroll story with a base line, progress fill, active step states, responsive collapse, semantic fallback, and reduced-motion behavior. Use for onboarding, checkout, roadmaps, recipes, case studies, service processes, histories, or narratives where progress through the sequence should become visible while scrolling.
---

# Scroll Progress Timeline

Use one progress line to connect ordered information. The sequence must remain complete, readable, and navigable before animation is added.

## Model the steps

Keep the content data-driven:

```js
const steps = [
  { id: "brief", number: "01", title: "Set the direction", body: "..." },
  { id: "build", number: "02", title: "Make the system", body: "..." },
  { id: "ship", number: "03", title: "Release and learn", body: "..." }
];
```

Render it as an ordered list with real headings. The line, dots, media, and active state enhance that structure; they do not replace it.

## Build the line

1. Render a quiet base line behind every point.
2. Place one progress line on top with `transform-origin: top` for vertical or `left` for horizontal.
3. Measure the first and last point centers, not arbitrary section edges.
4. Normalize scroll position between those centers.
5. Apply `scaleY(progress)` or `scaleX(progress)` so updates stay on the compositor.
6. Mark a step active when the progress head crosses its center.

```js
const progress = Math.min(1, Math.max(0,
  (viewportAnchor - lineStart) / (lineEnd - lineStart)
));
line.style.transform = `scaleY(${progress})`;
```

Schedule DOM writes in one animation frame. Recalculate geometry after font and image loading, resize, orientation changes, and content mutation.

## Choose the layout

- Use a centered alternating timeline only when both sides have enough width and similar content weight.
- Use a left rail for long copy, compact steps, or mixed card heights.
- Use a horizontal line for short sequences with concise labels and explicit keyboard-safe overflow.
- Use pinned full-screen chapters only when each step carries a distinct visual state. Keep the pin finite and release before the next section.
- Collapse to a simple left rail on small screens. Do not preserve alternation at the expense of reading order.

## Animate step state

Use small opacity, translate, scale, blur, color, or media transitions. Keep every step readable while inactive. Expose active index with `aria-current="step"` only when that state is meaningful and current; do not announce every scroll update with a live region.

Use IntersectionObserver for simple active-state entry. Use a normalized scroll measurement or GSAP ScrollTrigger when the line must fill continuously or coordinate pinned media.

## Handle navigation

- Make step links real anchors when users can jump within the process.
- Add `scroll-margin` for sticky headers.
- Preserve focus and do not move it during passive scrolling.
- Keep URLs and browser history stable unless the user explicitly selects a step.
- If steps are interactive, use buttons or links with visible focus; never make a decorative dot the only control.

## Reduce motion

Under `prefers-reduced-motion: reduce`, show the complete line or discrete reached states without scrubbed interpolation, blur, pinning, or large transforms. Keep ordinary document flow and all step content.

## Verify

Test variable step counts, uneven card heights, missing media, long translations, 390/768/1024/1440 widths, 200% zoom, fast forward and reverse scrolling, direct anchor navigation, keyboard order, reduced motion, late font/image layout, route cleanup, and console errors. The active step and line head must agree at every boundary.

Use [demo/index.html](demo/index.html) as the working reference and [demo/PROMPT.md](demo/PROMPT.md) to recreate or remix it. Keep [REFERENCES.md](REFERENCES.md) as the links-only implementation source list.
Pliki w paczce (6)
  • REFERENCES.md 1 KB
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • demo/PROMPT.md 2 KB
  • demo/index.html 12 KB
  • demo/preview.jpg 97 KB

Wersje

W bazie nie ma innych skilli o nazwie scroll-progress-timeline.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki e9733091fde7 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90narrative-scrollytelling
    Zamienia uporządkowaną sekwencję idei w historię przewijaną na stronie, z natywnym przewijaniem i wariantami statycznymi, dla reduced motion, klawiatury, dotyku i bez JavaScript.
  • 100scroll-scrubbed-word-reveal
    Odsłania tekst słowo po słowie wraz z postępem przewijania, zachowując semantyczne linki, wyróżnienia, zawijanie linii i czytelność przy reduced-motion, w nagłówkach, cytatach i manifestach.
  • 90scroll-animation
    Buduje animacje przewijania strony, czyli pojawianie się elementów, paralaksę i przypięte sceny, najpierw natywnym CSS, a następnie biblioteką.
  • 100scroll-animation
    Buduje animacje sterowane przewijaniem w GSAP ScrollTrigger lub CSS scroll-timeline, z paralaksą, przypinaniem i sekwencjami klatek.
  • 100timeline-builder
    Generuje interaktywne osie czasu w HTML z danych JSON: układ pionowy, poziomy lub dwustronny, z rozwijanymi szczegółami.
  • 1003d-scroll-story
    Buduje przewijaną historię produktu 3D na stronie WWW, z przypiętą sceną Three.js i krokami tekstu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.