用途:为前端项目提供可复用的图片轮播交互范式,适合图片画廊、产品展示等场景,基于 React/Next.js 与 next/image 实现。
主要能力:悬停时自动切换(不在页面加载时触发);移动端触摸滑动导航;玻璃拟态胶囊型进度指示器,带填充动画;手动导航后短暂暂停自动播放。
核心逻辑:使用 currentIndex、isHovered、progressKey、isPaused、touchStart 等状态管理;悬停且未暂停时每 3000ms 自动切换并递增 progressKey 以重启动画;触摸滑动阈值 50px,左滑下一张、右滑上一张,滑动后暂停 3 秒。
用法要点:容器需添加 touch-pan-y;图片使用 fill 与 object-cover;指示器激活时由 w-2 扩展为 w-6,仅在悬停且未暂停时显示带动画填充的覆盖层;需在 globals.css 中添加 carousel-progress 关键帧并应用 animate-carousel-progress 类。时间配置包括:自动切换 3000ms、手动交互后暂停 3000ms、图片淡入淡出 700ms、指示器扩展 300ms。
限制:资料未提供安装命令、依赖版本、浏览器兼容性、无障碍支持及收费信息。