Head
使用内置的 Head 组件向页面的 head 添加自定义元素。
我们提供了一个内置组件,用于向页面的 head 追加元素:
jsx
import Head from 'next/head'
function IndexPage() {
return (
<div>
<Head>
<title>My page title</title>
</Head>
<p>Hello world!</p>
</div>
)
}
export default IndexPage避免重复的标签#
要避免 head 中出现重复的标签,可以使用 key 属性,它能确保标签只渲染一次,如下例所示:
jsx
import Head from 'next/head'
function IndexPage() {
return (
<div>
<Head>
<title>My page title</title>
<meta property="og:title" content="My page title" key="title" />
</Head>
<Head>
<meta property="og:title" content="My new title" key="title" />
</Head>
<p>Hello world!</p>
</div>
)
}
export default IndexPage在这种情况下,只有第二个 <meta property="og:title" /> 会被渲染。具有重复 key 属性的 meta 标签会被自动处理。
小知识:Next.js 会自动检查
<title>和<base>标签是否重复,因此无需为这些标签使用 key。组件卸载时,
head的内容会被清空,因此请确保每个页面都在head中完整定义自己需要的内容,不要假设其他页面添加了什么。
使用最少的嵌套#
title、meta 或任何其他元素(例如 script)需要作为 Head 元素的直接子元素包含,或者最多包裹一层 <React.Fragment> 或数组——否则在客户端导航时这些标签将无法被正确识别。
使用 next/script 处理脚本#
我们建议在组件中使用 next/script,而不是在 next/head 中手动创建 <script>。
不要使用 html 或 body 标签#
你不能使用 <Head> 在 <html> 或 <body> 标签上设置属性。这会导致 next-head-count is missing 错误。next/head 只能处理 HTML <head> 标签内的标签。