Nuxt3 中文课程《实战全栈开发简书》限时优惠

useHead

useHead函数用于自定义Nuxt应用中单个页面的头部属性。

useHead函数可以以编程和响应式的方式自定义Nuxt应用程序中每个页面的头部属性,它是由Unhead提供支持的。如果数据来自用户或其他不可信的来源,我们建议你查看useHeadSafe

Read more in Docs > Getting Started > Seo Meta.

类型

useHead(meta: MaybeComputedRef<MetaObject>): void

下面是useHead的非响应式类型。

interface MetaObject {
  title?: string
  titleTemplate?: string | ((title?: string) => string)
  base?: Base
  link?: Link[]
  meta?: Meta[]
  style?: Style[]
  script?: Script[]
  noscript?: Noscript[]
  htmlAttrs?: HtmlAttributes
  bodyAttrs?: BodyAttributes
}

更详细的类型信息请参考@unhead/schema

useHead的属性可以是动态的,接受refcomputedreactive属性。meta参数还可以接受一个返回对象的函数,使整个对象具有响应性。

参数

meta

类型MetaObject

接受以下头部元数据的对象:

  • meta:数组中的每个元素都映射到一个新创建的<meta>标签,其中对象属性映射到相应的属性。
    • 类型Array<Record<string, any>>
  • link:数组中的每个元素都映射到一个新创建的<link>标签,其中对象属性映射到相应的属性。
    • 类型Array<Record<string, any>>
  • style:数组中的每个元素都映射到一个新创建的<style>标签,其中对象属性映射到相应的属性。
    • 类型Array<Record<string, any>>
  • script:数组中的每个元素都映射到一个新创建的<script>标签,其中对象属性映射到相应的属性。
    • 类型Array<Record<string, any>>
  • noscript:数组中的每个元素都映射到一个新创建的<noscript>标签,其中对象属性映射到相应的属性。
    • 类型Array<Record<string, any>>
  • titleTemplate:配置动态模板以自定义每个页面的标题。
    • 类型string | ((title: string) => string)
  • title:在每个页面上设置静态页面标题。
    • 类型string
  • bodyAttrs:设置<body>标签的属性。每个对象属性都映射到相应的属性。
    • 类型Record<string, any>
  • htmlAttrs:设置<html>标签的属性。每个对象属性都映射到相应的属性。
    • 类型Record<string, any>