使用头部标签 useHead

useHead 自定义 Nuxt 应用程序各个页面的头部属性。

useHead

useHead 可组合函数允许您以编程和反应的方式管理您的头部标签,由 Unhead 提供支持。 如果数据来自用户或其他不受信任的来源,我们建议您查看 useHeadSafe

Type

ts
useHead(meta: MaybeComputedRef<MetaObject>): void

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

ts
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

Type: MetaObject

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

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