Particle Logo

在 Next.js(App Router)中添加 Logo 粒子动画

Next.js 默认使用服务端组件,而粒子动画依赖浏览器 Canvas 和 requestAnimationFrame。只需在导出的 TSX 组件顶部声明客户端标记或禁用 SSR 即可。

更新于

1. 从工坊导出 React 组件

打开工坊,上传你的 SVG 或 PNG Logo(或从 3,400+ 品牌图标库直接搜索),在9 种效果里挑好动效后,打开导出面板的 React 标签保存 PixelLogoLoader.tsx(React 导出需要 Pro)。

2. 加上 'use client' 声明

导出的文件里直接调用了 useRef、useEffect 与 ResizeObserver。把文件放进 src/components/PixelLogoLoader.tsx,并在第一行加上 'use client';,然后在任意页面里通过客户端包装组件引入:

'use client';

import { PixelLogoLoader } from '@/components/PixelLogoLoader';

export function HeroLogo() {
  return (
    <div style={{ width: '100%', maxWidth: 420, margin: '0 auto' }}>
      <PixelLogoLoader
        variant="mobius-flow"
        height={320}
        duration={3.2}
        interactive
      />
    </div>
  );
}

3. 避免首屏闪烁(可选)

如果不想在 SSR 阶段渲染空画布,可以用 next/dynamic 配合 ssr: false 并固定占位高度,避免产生布局偏移(CLS):

import dynamic from 'next/dynamic';

const PixelLogoLoader = dynamic(
  () => import('@/components/PixelLogoLoader').then((m) => m.PixelLogoLoader),
  { ssr: false, loading: () => <div style={{ height: 320 }} /> }
);

4. 免费方案备选

如果你还没有 Pro 套餐,可以先在工坊免费导出单文件 HTML5(index.html),放到 Next.js 的 public/logo-loader.html,再用 <iframe src="/logo-loader.html"> 嵌入,同样零第三方库。更多参数说明见 React 组件完整教程。

进入工坊

其他教程