透過 100+ 個秘訣來學習 Nuxt!

useHead

useHead 可自訂 Nuxt 應用程式中個別頁面的 head 屬性。

useHead composable 函式可讓您以程式化和響應式的方式管理 head 標籤,由 Unhead 提供技術支援。如果資料來自使用者或其他不受信任的來源,我們建議您查看 useHeadSafe

文件 > 開始使用 > 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/vue 以取得更詳細的類型。

useHead 的屬性可以是動態的,接受 refcomputedreactive 屬性。meta 參數也可以接受傳回物件的函式,使整個物件具有響應性。

參數

meta

類型MetaObject

接受以下 head 元資料的物件

  • 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>