Motiva
Мои коллекции
← каталог

Cursor Follow

Кастомный курсор: кольцо плавно следует за мышью, точка — точно за ней; кольцо растёт над интерактивными элементами.

gsapmouse-movehovermagneticbasic~22 КБreduced-motion ✓

Установка

npx shadcn@latest add https://motiva.pages.dev/r/cursor-follow.json

зависимости: gsap@^3.15.0

Что нужно в проекте до установки
  1. components.json в корне — с алиасами в форме"components": "@/components". Нет файла — CLI не поймёт, куда класть.
  2. Алиас @ объявлен дважды: "paths": {"@/*": ["./src/*"]} в корневом tsconfig.json (в Vite он часто содержит только references — тогда CLI создаёт папку@) и resolve.alias в конфиге сборщика.
  3. Токены подключены один раз на приложение:import "@/styles/motiva-tokens.css" — они приезжают вместе с записью. Без них секция потеряет цвета, ритм и тему.
  4. Своя типографика не должна спорить: если у вас на обёрткеtext-align: center, он протечёт внутрь блоков.
  5. Проект без TypeScript? Всё равно нужен минимальныйtsconfig.json с pathsи "tsx": true в components.json: CLI грузит tsconfig безусловно, а с "tsx": false идёт за jsconfig.json и падает так же. Приехавший рядом.tsx можно не трогать — вам нужен.vanilla.js.

Экспорт

↓ Скачать .zip

Код

"use client";

import { useEffect, useRef, type CSSProperties } from "react";
import gsap from "gsap";

/**
 * Кастомный курсор: кольцо следует за мышью с плавным запаздыванием, точка — точно за ней.
 * Кольцо растёт над элементами с `data-cursor`. Скрывается при reduced-motion / data-shot / тач.
 * Смонтируй один раз на страницу (position: fixed, слушает document).
 */
export function CursorFollow() {
  const ring = useRef<HTMLDivElement>(null);
  const dot = useRef<HTMLDivElement>(null);

  useEffect(() => {
    const r = ring.current;
    const d = dot.current;
    if (!r || !d) return;

    const frozen =
      document.documentElement.hasAttribute("data-shot") ||
      window.matchMedia("(prefers-reduced-motion: reduce)").matches ||
      window.matchMedia("(hover: none)").matches;
    if (frozen) {
      r.style.display = "none";
      d.style.display = "none";
      return;
    }

    const prevCursor = document.body.style.cursor;
    document.body.style.cursor = "none";

    const xr = gsap.quickTo(r, "x", { duration: 0.5, ease: "power3" });
    const yr = gsap.quickTo(r, "y", { duration: 0.5, ease: "power3" });
    const xd = gsap.quickTo(d, "x", { duration: 0.12 });
    const yd = gsap.quickTo(d, "y", { duration: 0.12 });

    const move = (e: MouseEvent) => {
      xr(e.clientX);
      yr(e.clientY);
      xd(e.clientX);
      yd(e.clientY);
    };
    const over = (e: MouseEvent) => {
      if ((e.target as HTMLElement).closest?.("[data-cursor]")) gsap.to(r, { scale: 2.2, duration: 0.3 });
    };
    const out = (e: MouseEvent) => {
      if ((e.target as HTMLElement).closest?.("[data-cursor]")) gsap.to(r, { scale: 1, duration: 0.3 });
    };

    document.addEventListener("mousemove", move);
    document.addEventListener("mouseover", over);
    document.addEventListener("mouseout", out);
    return () => {
      document.body.style.cursor = prevCursor;
      document.removeEventListener("mousemove", move);
      document.removeEventListener("mouseover", over);
      document.removeEventListener("mouseout", out);
    };
  }, []);

  const base: CSSProperties = {
    position: "fixed",
    top: 0,
    left: 0,
    pointerEvents: "none",
    zIndex: 9999,
    borderRadius: "50%",
  };

  return (
    <>
      <div ref={ring} style={{ ...base, width: 34, height: 34, margin: "-17px 0 0 -17px", border: "1.5px solid oklch(0.72 0.15 220)" }} />
      <div ref={dot} style={{ ...base, width: 6, height: 6, margin: "-3px 0 0 -3px", background: "oklch(0.72 0.15 220)" }} />
    </>
  );
}
лицензия: MITавтор: Motivaисточник: оригинал (Motiva)v1.0.0