Docs
Number Ticker

Number Ticker

Animate numbers to count up or down to a target number

Installation

Copy and paste the following code into your project.

components/magicui/number-ticker.tsx
"use client";
 
import { useInView, useMotionValue, useSpring } from "framer-motion";
import { useEffect, useRef } from "react";
 
export default function NumberTicker({
  value,
  direction = "up",
  delay = 0,
  className,
}: {
  value: number;
  direction?: "up" | "down";
  className?: string;
  delay?: number; // delay in s
}) {
  const ref = useRef<HTMLSpanElement>(null);
  const motionValue = useMotionValue(direction === "down" ? value : 0);
  const springValue = useSpring(motionValue, {
    damping: 60,
    stiffness: 100,
  });
  const isInView = useInView(ref, { once: true, margin: "0px" });
 
  useEffect(() => {
    isInView &&
      setTimeout(() => {
        motionValue.set(direction === "down" ? 0 : value);
      }, delay * 1000);
  }, [motionValue, isInView, delay, value, direction]);
 
  useEffect(
    () =>
      springValue.on("change", (latest) => {
        if (ref.current) {
          ref.current.textContent = Intl.NumberFormat("en-US").format(
            latest.toFixed(0),
          );
        }
      }),
    [springValue],
  );
 
  return (
    <span
      className={`inline-block tabular-nums text-black dark:text-white ${className}`}
      ref={ref}
    />
  );
}

Props

PropTypeDescriptionDefault
valueintThe value to count to0
directionup | downThe direction to count inup