
Il pulsante da far scorrere
Pulsanti, Fisica, Transizioni
La barra laterale della documentazione API di un'azienda di pagamenti inventata, Ledgerline, su bianco: la versione, la ricerca e quattro gruppi di endpoint coi metodi GET, POST e DEL. Un segno indaco sottile sulla rotaia e una pillola di vetro chiaro stanno sotto la pagina in cui si è e viaggiano su due molle: il bordo davanti parte subito e quello dietro lo segue, così il segno si allunga sulle voci che attraversa e si raccoglie all'arrivo. Aprendo un gruppo l'altro si richiude e il segno cavalca la piega.
Una cartella che funziona da sola: index.html, style.css, script.js e le librerie da CDN. Nelle schede React e Vue la stessa demo è già un componente, che spegne le sue animazioni quando esce dalla pagina.
<!doctype html>
<!--
"API docs sidebar" from Animorio · https://animorio.com
License: free on your own sites and your clients’ sites, paid work included.
Not for resale, redistribution, templates or code collections · https://animorio.com/en/license/
-->
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>The API docs sidebar with the marker that slides between endpoints</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fontsource-variable/mona-sans@5.3.0/wdth.css">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fontsource-variable/jetbrains-mono@5.3.0/index.css">
<link rel="stylesheet" href="style.css">
</head>
<body>
<main class="stage" data-stage>
<!-- the sidebar of the API reference of a payments company (Ledgerline): four groups of endpoints, one open at a
time. A thin indigo marker on the rail and the soft pill behind the page you are on travel on two springs:
the edge in front leaves first, the one behind follows, so the marker stretches over the rows it crosses and
gathers again on arrival. Opening a group folds the other one away and the marker rides the fold -->
<nav class="docs" data-docs aria-label="API reference">
<header class="docs__head">
<span class="docs__brand">
<svg class="docs__mark" viewBox="0 0 24 24" aria-hidden="true">
<rect x="3" y="4" width="18" height="16" rx="5" />
<path d="M7.5 9.5h9M7.5 14.5h5.5" />
</svg>
<span class="docs__name">Ledgerline</span>
<span class="docs__kind">API</span>
</span>
<button class="docs__ver" type="button" aria-label="API version 2026-10">
<span>2026-10</span>
<svg viewBox="0 0 12 12" aria-hidden="true"><path d="M3.2 4.8 6 7.6l2.8-2.8" /></svg>
</button>
</header>
<button class="docs__search" type="button" aria-label="Search the API reference">
<svg viewBox="0 0 16 16" aria-hidden="true"><circle cx="7" cy="7" r="4.4" /><path d="m10.4 10.4 3 3" /></svg>
<span class="docs__search-words">Search the API</span>
<kbd class="docs__key">/</kbd>
</button>
<div class="tree" data-tree>
<span class="tree__ghost" data-ghost aria-hidden="true"></span>
<span class="tree__pill" data-pill aria-hidden="true"><span class="tree__sheen" data-sheen></span></span>
<span class="tree__mark" data-mark aria-hidden="true"></span>
<section class="grp" data-group>
<button class="grp__head" type="button" aria-expanded="false" data-head>
<svg class="grp__chev" viewBox="0 0 12 12" aria-hidden="true" data-chev><path d="M4.6 3 7.6 6l-3 3" /></svg>
<span class="grp__name">Getting started</span>
<span class="grp__count">4</span>
</button>
<div class="grp__wrap" data-wrap>
<ul class="grp__list">
<li><a class="row" href="#overview" data-row><span class="row__face"><span class="row__words">Overview</span></span></a></li>
<li><a class="row" href="#authentication" data-row><span class="row__face"><span class="row__words">Authentication</span></span></a></li>
<li><a class="row" href="#errors" data-row><span class="row__face"><span class="row__words">Errors</span></span></a></li>
<li><a class="row" href="#idempotency" data-row><span class="row__face"><span class="row__words">Idempotent requests</span></span></a></li>
</ul>
</div>
</section>
<section class="grp" data-group data-open>
<button class="grp__head" type="button" aria-expanded="true" data-head>
<svg class="grp__chev" viewBox="0 0 12 12" aria-hidden="true" data-chev><path d="M4.6 3 7.6 6l-3 3" /></svg>
<span class="grp__name">Payments</span>
<span class="grp__count">5</span>
</button>
<div class="grp__wrap" data-wrap>
<ul class="grp__list">
<li><a class="row" href="#create-payment" data-row><span class="row__face"><span class="tag tag--post">POST</span><span class="row__words">Create a payment</span></span></a></li>
<li><a class="row" href="#retrieve-payment" data-row data-start><span class="row__face"><span class="tag tag--get">GET</span><span class="row__words">Retrieve a payment</span></span></a></li>
<li><a class="row" href="#list-payments" data-row><span class="row__face"><span class="tag tag--get">GET</span><span class="row__words">List all payments</span></span></a></li>
<li><a class="row" href="#capture-payment" data-row><span class="row__face"><span class="tag tag--post">POST</span><span class="row__words">Capture a payment</span></span></a></li>
<li><a class="row" href="#refund-payment" data-row><span class="row__face"><span class="tag tag--post">POST</span><span class="row__words">Refund a payment</span></span></a></li>
</ul>
</div>
</section>
<section class="grp" data-group>
<button class="grp__head" type="button" aria-expanded="false" data-head>
<svg class="grp__chev" viewBox="0 0 12 12" aria-hidden="true" data-chev><path d="M4.6 3 7.6 6l-3 3" /></svg>
<span class="grp__name">Customers</span>
<span class="grp__count">3</span>
</button>
<div class="grp__wrap" data-wrap>
<ul class="grp__list">
<li><a class="row" href="#create-customer" data-row><span class="row__face"><span class="tag tag--post">POST</span><span class="row__words">Create a customer</span></span></a></li>
<li><a class="row" href="#retrieve-customer" data-row><span class="row__face"><span class="tag tag--get">GET</span><span class="row__words">Retrieve a customer</span></span></a></li>
<li><a class="row" href="#delete-customer" data-row><span class="row__face"><span class="tag tag--del">DEL</span><span class="row__words">Delete a customer</span></span></a></li>
</ul>
</div>
</section>
<section class="grp" data-group>
<button class="grp__head" type="button" aria-expanded="false" data-head>
<svg class="grp__chev" viewBox="0 0 12 12" aria-hidden="true" data-chev><path d="M4.6 3 7.6 6l-3 3" /></svg>
<span class="grp__name">Webhooks</span>
<span class="grp__count">3</span>
</button>
<div class="grp__wrap" data-wrap>
<ul class="grp__list">
<li><a class="row" href="#create-endpoint" data-row><span class="row__face"><span class="tag tag--post">POST</span><span class="row__words">Create an endpoint</span></span></a></li>
<li><a class="row" href="#list-events" data-row><span class="row__face"><span class="tag tag--get">GET</span><span class="row__words">List events</span></span></a></li>
<li><a class="row" href="#delete-endpoint" data-row><span class="row__face"><span class="tag tag--del">DEL</span><span class="row__words">Delete an endpoint</span></span></a></li>
</ul>
</div>
</section>
</div>
</nav>
<!-- the pilot's pointer: shows the sidebar by itself and steps aside for a real hand -->
<svg class="hand" data-hand viewBox="0 0 24 24" aria-hidden="true">
<path d="M5 3.2 18.6 13l-6.1.9 3.6 6.6-2.6 1.4-3.6-6.7L5 19.4Z" />
</svg>
<p class="sr" aria-live="polite" data-live></p>
</main>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.0/dist/gsap.min.js"></script>
<script src="script.js"></script>
</body>
</html>Cambia valori, colori e testi con le manopole e guarda l’animazione rispondere dal vivo. Oppure scrivi tu nel codice. Poi scarica la cartella con le tue modifiche.
59 valori da cambiare
Col connettore di Animorio, Claude Code, ChatGPT, Cursor o VS Code la prendono da qui con tutta la sua guida e la adattano al tuo progetto. Incolla questa richiesta:
Prendi «Barra laterale delle API» da Animorio e adattala al mio sitoIl segno e la pillola non hanno una posizione sola ma due numeri, il bordo di sopra e quello di sotto, ognuno con la sua molla scritta a mano (posizione, velocità, rigidità, smorzamento) e integrata a passi di 1/120 di secondo in un ticker di GSAP. A ogni scelta il bordo che sta davanti nel viaggio prende la rigidità STIFF e quello dietro STIFF per TRAIL: il primo arriva prima, il secondo lo insegue, e il segno si allunga e si raccoglie da solo.
Le molle non inseguono un numero fisso ma la voce: a ogni fotogramma lo script legge la sua distanza dalla cima dell'indice sommando gli offsetTop fino all'indice (le trasformazioni dell'entrata non contano) e la taglia con quello che il suo gruppo mostra ancora. Così, se il gruppo si richiude, il segno si schiaccia e sparisce dentro la piega invece di restare sospeso nel vuoto.
Ogni gruppo è un contenitore con overflow hidden la cui altezza va da quella che ha a scrollHeight o a zero con GSAP. Chi si chiude e chi si apre usano la stessa durata e la stessa curva, così la somma delle due altezze non supera mai quella del gruppo più lungo e l'indice, alto quanto lui, non cambia misura. Aperto, l'altezza torna auto e segue i cambi di misura.
Il ticker si accende solo quando qualcosa si muove (una scelta, una piega, un cambio di misura) e si toglie da solo quando le due molle sono ferme e nessun gruppo si sta piegando: a riposo la pagina non ridisegna niente.
La voce scelta prende la classe is-current: la scritta passa al peso 590 e si sposta di due pixel su una curva che va un filo oltre, la targhetta del metodo si riempie del suo colore e si gonfia con back.out, e un riflesso bianco in diagonale attraversa la pillola. Il fantasma grigio sotto il puntatore va con due quickTo, e se la lista si sposta lo segue.
| Nome | File | Di partenza | Cosa cambia |
|---|---|---|---|
STIFF | script.js | 420 | La rigidità del bordo davanti: più alta arriva prima alla voce. |
TRAIL | script.js | 0.42 | Il bordo dietro rispetto a quello davanti: più basso, il segno si allunga di più. |
DAMP | script.js | 0.8 | Lo smorzamento delle molle: più basso passa la voce di più, 1 non la passa mai. |
FOLD | script.js | 0.5 | I secondi che un gruppo impiega ad aprirsi o chiudersi. |
ONE_OPEN | script.js | true | Aprendo un gruppo si richiude quello aperto. |
FIRST_PAGE | script.js | true | Aprendo un gruppo si va alla sua prima pagina. |
PACE | script.js | 1 | Le pause del pilota: più alto aspetta di più fra un gesto e l'altro. |
LOOP | script.js | true | Il pilota rifà il giro a ripetizione. |
Per il sito della documentazione di un'API, di un SDK o di un prodotto per sviluppatori, per il centro assistenza di un'app o per ogni barra laterale a gruppi (le impostazioni di una dashboard, i capitoli di una guida): fa capire dove si è e da dove si arriva senza cambiare pagina.
La stessa animazione con le misure adattate: la card è larga l'88% dello schermo e l'altezza delle righe si misura anche sull'altezza della finestra (fra 22 e 33 pixel), così tutta la barra sta nella casella. Col dito si toccano gruppi e voci; il fantasma grigio, che è solo per il mouse, non compare.
Niente scivola: il segno e la pillola compaiono subito sulla voce scelta, i gruppi si aprono e si chiudono senza piega con le voci in dissolvenza, e la freccia del pilota non si vede; il pilota cambia comunque pagina e gruppo.
GSAP 3.15.0, Mona Sans (font variabile) 5.3.0, JetBrains Mono (font variabile) 5.3.0.
Compressi con gzip, i tre file della demo pesano 8,4 KB; le librerie: GSAP 28 KB.
Provata il 7 novembre 2026
Puoi usarla nei tuoi progetti e in quelli dei tuoi clienti. Non puoi rivenderla né ridistribuirla così com’è. GSAP resta sotto la sua licenza Standard. Licenza completa.
Sostieni Animorio
Animorio resta gratis grazie a chi lo sostiene. Se ti va, offrici un caffè: ci aiuta a fare le prossime animazioni.
Avevi chiesto
L’abbiamo fatta per te: è nella libreria, con l’anteprima, il Playground e il codice da copiare.
Un’animazione che non trovi o un sito da smontare nel giornale: dicci quale. Le prossime le scegliamo da qui.
Con l’email e la password del tuo account.
oppure con l’email
Hai fatto l’accesso come .
Con l’account scarichi lo zip di ogni animazione e di ogni pacchetto, gratis.