heroicons-animated
uiarrow-down-circlesource: ok · hit
arrow-down-circle
Animated arrow-down-circle icon for React
npx shadcn add "https://www.heroicons-animated.com/r/arrow-down-circle.json"free
No selection tags yet — empty means no evidence, not lack of support.
Dependencies
Bundle weight · mediumanimationmotion
Files1 · source cached 10/9/2026, 2:40:57 PM
arrow-down-circle.tsx
"use client";
import type { Variants } from "motion/react";
import { motion, useAnimation } from "motion/react";
import type { HTMLAttributes } from "react";
import { forwardRef, useCallback, useImperativeHandle, useRef } from "react";
import { cn } from "@/lib/utils";
export interface ArrowDownCircleIconHandle {
startAnimation: () => void;
stopAnimation: () => void;
}
interface ArrowDownCircleIconProps extends HTMLAttributes<HTMLDivElement> {
size?: number;
}
const ARROW_VARIANTS: Variants = {
normal: { translateY: 0 },
animate: {
translateY: [0, 2, 0],
transition: {
duration: 0.5,
times: [0, 0.4, 1],
},
},
};
const ArrowDownCircleIcon = forwardRef<
ArrowDownCircleIconHandle,
ArrowDownCircleIconProps
>(({ onMouseEnter, onMouseLeave, className, size = 28, ...props }, ref) => {
const controls = useAnimation();
const isControlledRef = useRef(false);
useImperativeHandle(ref, () => {
isControlledRef.current = true;
return {
startAnimation: () => controls.start("animate"),
stopAnimation: () => controls.start("normal"),
};
});
const handleMouseEnter = useCallback(
(e: React.MouseEvent<HTMLDivElement>) => {
if (isControlledRef.current) {
onMouseEnter?.(e);
} else {
controls.start("animate");
}
},
[controls, onMouseEnter]
);
const handleMouseLeave = useCallback(
(e: React.MouseEvent<HTMLDivElement>) => {
if (isControlledRef.current) {
onMouseLeave?.(e);
} else {
controls.start("normal");
}
},
[controls, onMouseLeave]
);
return (
<div
className={cn(className)}
onMouseEnter={handleMouseEnter}
onMouseLeave={handleMouseLeave}
{...props}
>
<svg
fill="none"
height={size}
stroke="currentColor"
strokeLinecap="round"
strokeLinejoin="round"
strokeWidth="1.5"
viewBox="0 0 24 24"
width={size}
xmlns="http://www.w3.org/2000/svg"
>
<path d="M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Z" />
<motion.g animate={controls} variants={ARROW_VARIANTS}>
<path d="m9 12.75 3 3m0 0 3-3m-3 3v-7.5" />
</motion.g>
</svg>
</div>
);
});
ArrowDownCircleIcon.displayName = "ArrowDownCircleIcon";
export { ArrowDownCircleIcon };