Vai al contenuto
animorio
EN
Torna alla libreria

Ritaglio foto profilo

Fisica, HoverGSAP, CanvasMediaPeso compresso: Demo 8,1 KBGSAP 28 KBGratisScarica lo zip

L’editor della foto del profilo di un’app, piccolo e preciso nello stile delle micro-interazioni a un gesto solo: un ritratto vero si trascina sotto il cerchio del ritaglio, oltre il bordo la tiene un elastico che si fa più duro e lasciata torna dentro con una molla, lanciata scivola e si ferma con l’attrito. Lo zoom ha la sua barra, la griglia dei terzi compare solo mentre si tiene la foto, e Save stringe il cerchio nell’avatar in alto.

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>
<!--
  "Profile photo crop" 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 profile photo crop you drag into place</title>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fontsource-variable/mona-sans@5.3.0/wdth.css">
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <main class="stage" data-stage>
    <!-- the photo editor of a profile: drag the picture under the round frame, zoom with the slider,
         the edges hold it on a rubber band and it settles back with a spring; Save shrinks it into the avatar -->
    <section class="card" data-card aria-label="Edit profile photo">
      <header class="card__head">
        <button class="txt" type="button" data-reset>Reset</button>
        <div class="head__mid">
          <div class="mini" data-mini aria-hidden="true"><canvas data-mini-canvas></canvas></div>
          <p class="head__title">
            <span class="head__state" data-title-edit>Profile photo</span>
            <span class="head__state head__state--done" data-title-done>Photo updated</span>
          </p>
        </div>
        <button class="save" type="button" data-save>
          <span class="save__label" data-save-label>Save</span>
          <svg class="save__check" data-save-check viewBox="0 0 24 24" aria-hidden="true"><path d="M6 12.5 10.2 16.5 18 8" pathLength="1"></path></svg>
        </button>
      </header>

      <div class="crop" data-crop>
        <canvas class="crop__photo" data-photo aria-label="Photo, drag to move"></canvas>
        <svg class="crop__mask" data-mask aria-hidden="true">
          <defs>
            <mask id="buco">
              <rect width="100%" height="100%" fill="#fff"></rect>
              <circle data-hole fill="#000"></circle>
            </mask>
          </defs>
          <rect width="100%" height="100%" fill="rgba(12,12,14,0.58)" mask="url(#buco)"></rect>
          <g class="crop__grid" data-grid>
            <line data-g="v1"></line><line data-g="v2"></line><line data-g="h1"></line><line data-g="h2"></line>
          </g>
          <circle class="crop__ring" data-ring></circle>
        </svg>
        <p class="crop__hint" data-hint>Drag to reposition</p>
      </div>

      <div class="zoom">
        <svg class="zoom__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="10.5" cy="10.5" r="6"></circle><path d="M15 15l4.5 4.5M8 10.5h5"></path></svg>
        <div class="zoom__track" data-track role="slider" tabindex="0" aria-label="Zoom" aria-valuemin="100" aria-valuemax="300" aria-valuenow="100">
          <div class="zoom__fill" data-zfill></div>
          <div class="zoom__knob" data-knob></div>
        </div>
        <svg class="zoom__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="10.5" cy="10.5" r="6"></circle><path d="M15 15l4.5 4.5M8 10.5h5M10.5 8v5"></path></svg>
        <span class="zoom__val" data-zval>1.0x</span>
      </div>
    </section>

    <svg class="ghost" data-ghost viewBox="0 0 24 24" aria-hidden="true"><path d="M5 3.2 19.2 11l-6.3 1.6-3.3 5.9Z"></path></svg>
  </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.

20 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 «Ritaglio foto profilo» da Animorio e adattala al mio sito
Licenza per piattaformeGratis sui tuoi siti e su quelli dei clienti. La vuoi dentro un website builder, una piattaforma di template o un gestionale? C’è la licenza per agenzie e piattaforme.

Cosa fa

Su un grigio chiarissimo c’è una card bianca: in alto Reset a sinistra, il titolo Profile photo al centro e il pulsante nero Save a destra; in mezzo la foto, il ritratto vero di una ragazza bionda col rossetto scuro davanti a una rete metallica al tramonto, coperta da un velo scuro fuori da un cerchio bianco sottile; sotto, la barra dello zoom fra due lenti e il valore, 1.0x. Si prende la foto e si trascina: segue la mano, il cerchio si fa un poco più spesso e compare la griglia dei terzi. Se si tira oltre il punto in cui il cerchio resterebbe scoperto, la foto continua a venire ma sempre meno, come tenuta da un elastico; lasciata, torna dentro con una molla corta. Lanciata, scivola e rallenta con l’attrito, e se arriva al bordo la molla la ferma. La barra dello zoom ingrandisce attorno al centro (anche la rotella e le frecce della tastiera), e dopo il primo gesto Reset si accende. Save si schiaccia, diventa verde con la spunta che si disegna, il cerchio lampeggia e la sua foto, rimpicciolita, compare come avatar accanto al titolo, che rotola in Photo updated. Il puntatore finto fa tutto da solo: tira oltre il bordo, lancia, ingrandisce, mette il viso al centro del cerchio e salva; poi si ricomincia.

Come funziona

Il limite del ritaglio

La foto è un ritratto vero ritagliato quadrato e disegnato nel canvas, grande quanto il lato lungo del riquadro per lo zoom. Il cerchio resta coperto finché lo spostamento sta entro (lato della foto meno diametro del cerchio) diviso due, su ciascun asse: è il limite, e cresce con lo zoom.

L’elastico oltre il bordo

Mentre si trascina, la parte oltre il limite passa per una tangente iperbolica: L per tanh(oltre diviso L). Vicino al bordo la foto segue quasi uguale, poi sempre meno, e non supera mai L, una frazione del cerchio regolata da RUBBER.

Inerzia, attrito e molla

Al rilascio la velocità si prende dagli ultimi 90 millisecondi del gesto. Sul ticker di GSAP, dentro il limite la velocità cala per l’attrito, fuori una molla smorzata (rigidità 260 per SPRING, smorzamento poco sotto il critico) la riporta al bordo senza rimbalzi lunghi.

Il cerchio che diventa l’avatar

Il velo è un rettangolo con una maschera SVG che ha un buco tondo; il cerchio e la griglia sono nello stesso SVG. Save copia dal canvas il quadrato del cerchio in un canvas da 22 pixel, che entra accanto al titolo con un rimbalzo mentre il titolo rotola.

Valori da cambiare

NomeFileDi partenzaCosa cambia
MAX_ZOOMscript.js3Quanto si può ingrandire la foto (1 = come entra).
RUBBERscript.js0.55Quanto si lascia tirare oltre il bordo prima che l’elastico la fermi.
SPRINGscript.js1Quanto è rigida la molla che la riporta dentro il cerchio.
FRICTIONscript.js0.9Quanto scivola dopo il lancio: più alto, più lontano.
RINGscript.js1.5Lo spessore del cerchio del ritaglio, in pixel.
SHADEscript.js0.58Quanto è scuro il fuori del cerchio.
ACCENTscript.js#12a150Il colore della conferma.
HOLDscript.js1.8I secondi in cui resta la conferma prima di ricominciare.

Provali nel Playground

Quando usarla

Per la foto del profilo di un’app, di un account o di una community, e in ogni posto dove si sceglie l’inquadratura di un’immagine prima di caricarla: la copertina di un podcast, il logo di un team, la foto di un prodotto.

Sul telefono

La card prende quasi tutta la larghezza della casella e il riquadro della foto si misura anche sull’altezza; col dito la foto si trascina e si lancia come col mouse, senza far scorrere la pagina.

Con il movimento ridotto

Niente elastico, molla né scivolate: la foto segue il dito restando sempre dentro il limite; il pilota mostra solo gli stati e la conferma arriva in dissolvenza.

Trappole

  • Il velo scuro con un buco tondo si fa con una maschera SVG (rettangolo bianco, cerchio nero): un box-shadow enorme su un cerchio sembra più semplice ma non si allinea al pixel col canvas quando la casella cambia altezza.
  • Zoomando, lo spostamento va moltiplicato per il rapporto fra il nuovo zoom e il vecchio, sennò la foto scivola via dal punto inquadrato.
  • La fisica gira sul ticker di GSAP, non su un requestAnimationFrame suo: così la governa l’orologio dell’anteprima e il video esce uguale a ogni giro.
  • touch-action: none sul riquadro e sulla barra, sennò sul telefono il trascinamento fa scorrere la pagina.
  • La foto si disegna nel canvas solo quando è caricata: il giro parte dopo image.decode(), sennò il primo trascinamento muove un riquadro vuoto e l’avatar salvato esce nero.

Librerie

GSAP 3.15.0, Mona Sans (font variabile) 5.3.0.

Compressi con gzip, i tre file della demo pesano 8,1 KB; le librerie: GSAP 28 KB.

Collaudo

Provata il 5 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.

Tutte le animazioni