元标签 - 迁移到 Nuxt 3 - Nuxt 中文文档 v3

Maschinelle Übersetzung ·0 % geprüft

Nuxt 3 提供了几种管理元标签的方式：

通过你的 nuxt.config。
通过 useHead 组合式函数
通过全局元组件

你可以自定义 title、titleTemplate、base、script、noscript、style、meta、link、htmlAttrs 和 bodyAttrs。

Nuxt 目前使用 Unhead 来管理你的元标签，但实现细节可能会改变。

Weitere Informationen findest du unter Docs > Getting Started > Seo Meta.

迁移

在你的 nuxt.config 中，将 head 重命名为 meta。可以考虑将这个共享的元数据配置移到 app.vue 中。（请注意，对象不再有用于去重的 hid 键。）
如果你需要通过 head 访问组件状态，则应迁移到使用 useHead。你也可以考虑使用内置的元组件。
如果你需要使用 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>

<script setup lang="ts">
const title = ref('My App')
const description = ref('My App Description')

// 当你更改上述 title/description 时，这将是响应式的
useHead({
  title,
  meta: [{
    name: 'description',
    content: description,
  }],
})
</script>

元组件

Nuxt 3 还提供了可以用来完成同样任务的元组件。虽然这些组件看起来类似 HTML 标签，但它们由 Nuxt 提供，拥有类似的功能。

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

<template>
  <div>
    <Head>
      <Title>My App</Title>
      <Meta
        name="description"
        content="My app description"
      />
    </Head>
    <!-- -->
  </div>
</template>

请确保你为这些组件名称使用大写字母，以区分它们与原生 HTML 元素（应使用 <Title> 而非 <title>）。
你可以将这些组件放置在页面模板中的任意位置。

Options API

Nuxt 3 (Options API)

<script>
// 如果使用 Options API 的 `head` 方法，必须使用 `defineNuxtComponent`
export default defineNuxtComponent({
  head (nuxtApp) {
    // `head` 接收 nuxt 应用实例，但无法访问组件实例
    return {
      meta: [{
        name: 'description',
        content: '这是我的页面描述。'
      }],
    }
  },
})
</script>