NNext.js 中文网 GitHub

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> 标签内的标签。

Next.js 中文网