Meta 标签

管理您的 meta 标签,从 Nuxt 2 到 Nuxt 3。

Nuxt 3 提供了几种不同的方式来管理您的 meta 标签

  1. 通过您的 nuxt.config
  2. 通过 useHead 组合式函数
  3. 通过 全局 meta 组件

您可以自定义 titletitleTemplatebasescriptnoscriptstylemetalinkhtmlAttrsbodyAttrs

Nuxt 当前使用Unhead来管理您的 meta 标签,但实现细节可能会有所变化。
文档 > 4 X > 入门 > Seo Meta中阅读更多内容。

迁移

  1. 在您的 nuxt.config 中,将 head 重命名为 meta。考虑将此共享 meta 配置移至您的 app.vue 中。(请注意,对象不再具有用于去重 的 hid 键。)
  2. 如果您需要通过 head 访问组件状态,您应该迁移到使用 useHead。您也可以考虑使用内置的 meta 组件。
  3. 如果您需要使用 Options API,当您使用 defineNuxtComponent 时,可以使用 head() 方法。

useHead

<script>
export default {
  data: () => ({
    title: 'My App',
    description: 'My App Description',
  }),
  head () {
    return {
      title: this.title,
      meta: [{
        hid: 'description',
        name: 'description',
        content: this.description,
      }],
    }
  },
}
</script>

Meta 组件

Nuxt 3 还提供了 meta 组件,您可以使用它们完成相同的任务。虽然这些组件看起来类似于 HTML 标签,但它们是由 Nuxt 提供的,并且具有类似的功能。

<script>
export default {
  head () {
    return {
      title: 'My App',
      meta: [{
        hid: 'description',
        name: 'description',
        content: 'My App Description',
      }],
    }
  },
}
</script>
  1. 请确保这些组件名称使用大写字母,以区别于原生 HTML 元素(例如 <Title> 而不是 <title>)。
  2. 您可以将这些组件放置在页面模板中的任何位置。

Options API

Nuxt 3 (Options API)
<script>
// if using options API `head` method you must use `defineNuxtComponent`
export default defineNuxtComponent({
  head (nuxtApp) {
    // `head` receives the nuxt app but cannot access the component instance
    return {
      meta: [{
        name: 'description',
        content: 'This is my page description.',
      }],
    }
  },
})
</script>