Lazy Loading
Next.js中的懒加载通过减少渲染路由所需的JavaScript数量,来帮助提高应用程序的初始加载性能。
它允许你延迟加载客户端组件和导入的库,只在需要时将它们包含在客户端包中。例如,你可能想延迟加载一个模态框,直到用户点击打开它。
在Next.js中有两种实现懒加载的方式:
- 使用
next/dynamic
的动态导入 - 使用
React.lazy()
和Suspense
默认情况下,服务器组件会自动进行代码分割,你可以使用流式传输从服务器到客户端逐步发送UI片段。懒加载适用于客户端组件。
next/dynamic
next/dynamic
是React.lazy()
和Suspense的组合。它在app
和pages
目录中的行为相同,以允许增量迁移。
示例
通过使用next/dynamic
,header组件将不会被包含在页面的初始JavaScript包中。页面将首先渲染Suspense的fallback
,然后在Suspense边界解析后渲染Header
组件。
import dynamic from 'next/dynamic';
const DynamicHeader = dynamic(() => import('../components/header'), {
loading: () => <p>Loading...</p>,
});
export default function Home() {
return <DynamicHeader />;
}
值得注意的是:在
import('path/to/component')
中,路径必须显式写出。它不能是模板字符串或变量。此外,import()
必须在dynamic()
调用内部,以便Next.js能够将webpack包/模块id匹配到特定的dynamic()
调用,并在渲染之前预加载它们。dynamic()
不能在React渲染内部使用,因为它需要被标记在模块的顶层以便预加载工作,类似于React.lazy
。
使用命名导出
要动态导入命名导出,你可以从import()
返回的Promise中返回它:
components/hello.js
export function Hello() {
return <p>Hello!</p>;
}
// pages/index.js
import dynamic from 'next/dynamic';
const DynamicComponent = dynamic(() =>
import('../components/hello').then((mod) => mod.Hello)
);
不使用SSR
要在客户端动态加载组件,你可以使用ssr
选项禁用服务器渲染。如果外部依赖或组件依赖于浏览器API(如window
),这将非常有用。
'use client'
import dynamic from 'next/dynamic';
const DynamicHeader = dynamic(() => import('../components/header'), {
ssr: false,
});
使用外部库
这个例子使用外部库fuse.js
进行模糊搜索。该模块只在用户在搜索输入框中输入后才在浏览器中加载。
import { useState } from 'react';
const names = ['Tim', 'Joe', 'Bel', 'Lee'];
export default function Page() {
const [results, setResults] = useState();
return (
<div>
<input
type="text"
placeholder="Search"
onChange={async (e) => {
const { value } = e.currentTarget;
// 动态加载fuse.js
const Fuse = (await import('fuse.js')).default;
const fuse = new Fuse(names);
setResults(fuse.search(value));
}}
/>
<pre>Results: {JSON.stringify(results, null, 2)}</pre>
</div>
);
}