布局
Nuxt Kit 提供了一系列实用工具来帮助您处理布局。
布局通常用来包裹你的页面。它可以用来用通用的组件包裹你的页面,例如一个头部和一个尾部。布局可以使用 addLayout
工具注册。
addLayout
将模板注册为布局,并将其添加到布局中。
类型
function addLayout (layout: NuxtTemplate | string, name: string): void
interface NuxtTemplate {
src?: string
filename?: string
dst?: string
options?: Record<string, any>
getContents?: (data: Record<string, any>) => string | Promise<string>
write?: boolean
}
参数
layout
类型: NuxtTemplate | string
必需: true
一个模板对象或指向模板的路径字符串。如果提供字符串,它将被转换为具有 src
设置为字符串值的模板对象。如果提供了模板对象,它必须具有以下属性:
src
(可选)
类型:string
模板的路径。如果未提供src
,则必须提供getContents
。filename
(可选)
类型:string
模板的文件名。如果未提供filename
,它将从src
路径生成。在这种情况下,src
选项是必需的。dst
(可选)
类型:string
目标文件的路径。如果未提供dst
,它将从filename
路径和 Nuxt 的buildDir
选项生成。options
(可选)
类型:Options
传递给模板的选项。getContents
(可选)
类型:(data: Options) => string | Promise<string>
一个将使用options
对象调用的函数。它应该返回一个字符串或一个解析为字符串的承诺。如果提供了src
,这个函数将被忽略。write
(可选)
类型:boolean
如果设置为true
,模板将写入目标文件。否则,模板将仅在虚拟文件系统中使用。