Vai al contenuto
animorio
EN
Tutti i componenti

Barra laterale delle API

Navigazione, Transizioni, FisicaGSAP, Solo CSSMediaPeso compresso: Demo 8,4 KBGSAP 28 KBGratisScarica lo zip

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.

Il codice

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>

Playground

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

Oppure chiedila al tuo assistente AI

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 sito
Licenza per piattaformeGratis sui tuoi siti e su quelli dei clienti. Lo vuoi dentro un website builder, una piattaforma di template o un gestionale? C’è la licenza per agenzie e piattaforme.

Cosa fa

Su una pagina bianca, da sola, la card della barra laterale della documentazione di Ledgerline, un'azienda di pagamenti inventata: bianca appena calda, con un bordo da un pixel, il filo di luce in alto e un'ombra morbida a più strati. In cima il marchio con API e la versione 2026-10 in carattere mono; sotto il campo Search the API col tasto disegnato. Poi quattro gruppi: Getting started, Payments, Customers e Webhooks, ognuno con la freccetta e il numero delle sue pagine. Payments è aperto: cinque endpoint, ognuno col suo metodo in una targhetta mono (POST indaco, GET verde, DEL rosso), lungo una rotaia grigia sottile. La pagina in cui si è, Retrieve a payment, ha una pillola di vetro indaco chiarissimo con il bordo alto illuminato, la scritta più nera e più piena spostata di due pixel, la targhetta piena del suo colore e accanto, sulla rotaia, un segno indaco largo due pixel con un alone tenue. Scegliendo un'altra pagina il segno e la pillola ci vanno su due molle: il bordo davanti parte subito, quello dietro lo segue più morbido, così per un attimo il segno copre tutte le voci in mezzo, poi si raccoglie sulla voce passando il segno di un pixel; la targhetta si gonfia e torna, e un riflesso attraversa la pillola. Toccando un gruppo chiuso la sua freccetta gira con un piccolo rimbalzo, il gruppo aperto si richiude mentre il nuovo si apre con le voci che scendono una dopo l'altra, e il segno segue la piega e scende alla prima pagina. Col mouse una pillola grigia segue la voce puntata. La card non cambia mai altezza. Una freccia del puntatore disegnata fa da sola il giro: Refund, Create, Webhooks, List events e il ritorno a Payments.

Come funziona

Due molle per due bordi

Il 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.

La voce letta a ogni fotogramma

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.

La piega dei gruppi

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 che si spegne

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.

I dettagli dell'arrivo

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.

Valori da cambiare

NomeFileDi partenzaCosa cambia
STIFFscript.js420La rigidità del bordo davanti: più alta arriva prima alla voce.
TRAILscript.js0.42Il bordo dietro rispetto a quello davanti: più basso, il segno si allunga di più.
DAMPscript.js0.8Lo smorzamento delle molle: più basso passa la voce di più, 1 non la passa mai.
FOLDscript.js0.5I secondi che un gruppo impiega ad aprirsi o chiudersi.
ONE_OPENscript.jstrueAprendo un gruppo si richiude quello aperto.
FIRST_PAGEscript.jstrueAprendo un gruppo si va alla sua prima pagina.
PACEscript.js1Le pause del pilota: più alto aspetta di più fra un gesto e l'altro.
LOOPscript.jstrueIl pilota rifà il giro a ripetizione.

Provali nel Playground

Quando usarla

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.

Sul telefono

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.

Con il movimento ridotto

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.

Trappole

  • Le voci stanno in un elenco con position relative (per la rotaia): offsetTop di una voce si misurava da lì e non dall'indice. Si sommano gli offsetTop risalendo gli offsetParent fino all'indice.
  • Togliendo l'attributo data-open prima di leggere l'altezza del gruppo, il CSS la portava subito a zero e la piega non si vedeva: l'altezza di partenza si legge prima di cambiare lo stato.
  • Con un'apertura in expo.out e una chiusura in power3.inOut, a metà dello scambio i due gruppi insieme superavano l'altezza dell'indice e la card si allungava e accorciava: la stessa curva e la stessa durata per tutti e due tengono costante la somma.
  • Il fantasma grigio restava dov'era la voce prima della piega: a ogni fotogramma delle molle rilegge la posizione della voce puntata.

Librerie

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.

Collaudo

Provata il 7 novembre 2026

  • Computer: Fatto
  • Telefono: Fatto
  • Movimento ridotto: Fatto
  • Safari su iPhone: Da fare

Licenza d’uso

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.

Tutti i componenti