nuxt logo

Traducción de Documentación (No Oficial)

useHead

useHead personaliza las propiedades del head de las páginas individuales de tu aplicación Nuxt.

La función composable useHead te permite gestionar tus etiquetas head de manera programática y reactiva, impulsada por Unhead. Si los datos provienen de un usuario u otra fuente no confiable, te recomendamos que revises useHeadSafe.

Ver también getting-started > seo-meta

Tipo

useHead(meta: MaybeComputedRef<MetaObject>): void

A continuación se presentan los tipos no reactivos para 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
}

Consulta @unhead/vue para obtener tipos más detallados.

Las propiedades de useHead pueden ser dinámicas, aceptando propiedades ref, computed y reactive. El parámetro meta también puede aceptar una función que devuelva un objeto para hacer que todo el objeto sea reactivo.

Parámetros

meta

Tipo: MetaObject

Un objeto que acepta los siguientes metadatos del head:

  • meta: Cada elemento en el array se asigna a una nueva etiqueta <meta>, donde las propiedades del objeto se asignan a los atributos correspondientes.
    • Tipo: Array<Record<string, any>>
  • link: Cada elemento en el array se asigna a una nueva etiqueta <link>, donde las propiedades del objeto se asignan a los atributos correspondientes.
    • Tipo: Array<Record<string, any>>
  • style: Cada elemento en el array se asigna a una nueva etiqueta <style>, donde las propiedades del objeto se asignan a los atributos correspondientes.
    • Tipo: Array<Record<string, any>>
  • script: Cada elemento en el array se asigna a una nueva etiqueta <script>, donde las propiedades del objeto se asignan a los atributos correspondientes.
    • Tipo: Array<Record<string, any>>
  • noscript: Cada elemento en el array se asigna a una nueva etiqueta <noscript>, donde las propiedades del objeto se asignan a los atributos correspondientes.
    • Tipo: Array<Record<string, any>>
  • titleTemplate: Configura una plantilla dinámica para personalizar el título de la página en una página individual.
    • Tipo: string | ((title: string) => string)
  • title: Establece un título de página estático en una página individual.
    • Tipo: string
  • bodyAttrs: Establece los atributos de la etiqueta <body>. Cada propiedad del objeto se asigna al atributo correspondiente.
    • Tipo: Record<string, any>
  • htmlAttrs: Establece los atributos de la etiqueta <html>. Cada propiedad del objeto se asigna al atributo correspondiente.
    • Tipo: Record<string, any>