Skip to main content

Next.js

LI.FI Widget 与 Next.js 应用完全兼容,只需极少的配置即可无缝集成。 由于 Next.js 中服务端渲染(SSR)的特性,以及不同钱包库管理其与钱包扩展连接的方式,LI.FI Widget 需要专门在客户端进行渲染。为此,请使用 'use client' 指令,确保 widget 组件仅在客户端环境中渲染。 请查看我们在 widget 仓库中的完整示例这里 如果你正在使用带 App Router 的 Next.js,以下示例展示了如何将 widget 添加到某个页面:
如果你正在使用带 Pages Router 的 Next.js,则需要动态导入 LI.FI Widget:

Widget 骨架屏

为方便用户,我们提供了 WidgetSkeleton 组件,可在主 widget 组件加载期间用作占位内容。
WidgetSkeleton 组件目前仅在 Next.js 环境中经过测试,可能无法与其他 SSR 框架配合使用。

Widget 骨架屏

内部路由

Widget v4 在内部使用 TanStack Router,而不再使用 React Router。这意味着:
  • 无需通配符路由:如果你之前在使用 React Router 时必须为 widget 配置通配符路由(例如 /swap/*),现在不再需要这样做。
  • 无冲突:widget 的内部路由完全隔离,不会干扰你应用的路由,无论你使用哪个路由库。

其他框架

我们为各种框架提供了完整示例:

钱包提供者集成

我们还提供了将 widget 与流行钱包连接库集成的示例:

其他示例

我们正在持续改进对更多框架的支持。请在示例目录中查看所有可用示例。