组件

Nuxt Kit 提供了一组工具来帮助您处理组件。您可以全局或局部注册组件，还可以添加目录以扫描组件。

组件是您的 Nuxt 应用程序的构建块。它们是可重用的 Vue 实例，可以用来创建用户界面。在 Nuxt 中，默认情况下会自动导入组件目录中的组件。然而，如果您需要从其他目录导入组件或希望根据需要选择性地导入组件，@nuxt/kit 提供了 addComponentsDir 和 addComponent 方法。这些工具允许您自定义组件配置以更好地满足您的需求。

观看关于注入组件的 Vue School 视频。

`addComponentsDir`

注册一个目录以扫描组件，并仅在使用时导入。请注意，这不会全局注册组件，除非您指定 global: true 选项。

用法

export default defineNuxtModule({
  meta: {
    name: '@nuxt/ui',
    configKey: 'ui',
  },
  setup() {
    addComponentsDir({
      path: resolve('./runtime/components'),
      prefix: 'U',
      pathPrefix: false
    })
  }
})

类型

function addComponentsDir (dir: ComponentsDir, opts: { prepend?: boolean } = {}): void

参数

dir 是一个具有以下属性的对象：

属性	类型	必需	描述
`path`	`string`	`true`	包含组件的目录路径（绝对或相对）。您可以使用 Nuxt 别名（~ 或 @）来引用项目内的目录，或直接使用类似于 require 的 npm 包路径。
`pattern`	`string \| string[]`	`false`	接受将在指定路径上运行的模式。
`ignore`	`string[]`	`false`	忽略将在指定路径上运行的模式。
`prefix`	`string`	`false`	为所有匹配的组件添加此字符串作为前缀。
`pathPrefix`	`boolean`	`false`	通过其路径为组件名称添加前缀。
`enabled`	`boolean`	`false`	如果设置为 `true`，则忽略扫描此目录。
`prefetch`	`boolean`	`false`	这些属性（prefetch/preload）在生产中用于配置带有 Lazy 前缀的组件如何通过 webpack 的魔法注释处理。了解更多信息请参阅 webpack 文档
`preload`	`boolean`	`false`	这些属性（prefetch/preload）在生产中用于配置带有 Lazy 前缀的组件如何通过 webpack 的魔法注释处理。了解更多信息请参阅 webpack 文档
`isAsync`	`boolean`	`false`	此标志指示组件应异步加载（使用单独的块），无论是否使用 Lazy 前缀。
`extendComponent`	`(component: Component) => Promise<Component \| void> \| (Component \| void)`	`false`	一个将在目录中找到的每个组件上调用的函数。它接受一个组件对象，并应返回一个组件对象或解析为组件对象的 Promise。
`global`	`boolean`	`false`	如果启用，则注册组件以全局可用。
`island`	`boolean`	`false`	如果启用，则将组件注册为岛屿。您可以在 `<NuxtIsland/>` 组件描述中阅读更多关于岛屿的信息。
`watch`	`boolean`	`false`	监视指定路径的更改，包括文件添加和文件删除。
`extensions`	`string[]`	`false`	Nuxt 构建器支持的扩展名。
`transpile`	`'auto' \| boolean`	`false`	使用 build.transpile 转译指定路径。如果设置为 `'auto'`，则如果路径中包含 `node_modules/`，将设置为 `transpile: true`。

opts

属性	类型	必需	描述
`prepend`	`boolean`	`false`	如果设置为 `true`，则目录将使用 `unshift()` 而不是 `push()` 添加到数组的开头。

`addComponent`

注册一个组件以自动导入。

用法

import { defineNuxtModule, createResolver, addComponent } from '@nuxt/kit'

export default defineNuxtModule({
  meta: {
    name: '@nuxt/image',
    configKey: 'image',
  },
  async setup() {
    const resolver = createResolver(import.meta.url)

    addComponent({
      name: 'NuxtImg',
      filePath: resolver.resolve('./runtime/components/NuxtImg.vue'),
    })

    addComponent({
      name: 'NuxtPicture',
      filePath: resolver.resolve('./runtime/components/NuxtPicture.vue'),
    })
  },
})

类型

function addComponent (options: AddComponentOptions): void

参数

options: 一个具有以下属性的对象：

属性	类型	必需	描述
`name`	`string`	`true`	组件名称。
`filePath`	`string`	`true`	组件的路径。
`pascalName`	`string`	`false`	Pascal 大小写的组件名称。如果未提供，将从组件名称生成。
`kebabName`	`string`	`false`	Kebab 大小写的组件名称。如果未提供，将从组件名称生成。
`export`	`string`	`false`	指定命名或默认导出。如果未提供，将设置为 `'default'`。
`shortPath`	`string`	`false`	组件的短路径。如果未提供，将从组件路径生成。
`chunkName`	`string`	`false`	组件的块名称。如果未提供，将从组件名称生成。
`prefetch`	`boolean`	`false`	这些属性（prefetch/preload）在生产中用于配置带有 Lazy 前缀的组件如何通过 webpack 的魔法注释处理。了解更多信息请参阅 webpack 文档
`preload`	`boolean`	`false`	这些属性（prefetch/preload）在生产中用于配置带有 Lazy 前缀的组件如何通过 webpack 的魔法注释处理。了解更多信息请参阅 webpack 文档
`global`	`boolean`	`false`	如果启用，则注册组件以全局可用。
`island`	`boolean`	`false`	如果启用，则将组件注册为岛屿。您可以在 `<NuxtIsland/>` 组件描述中阅读更多关于岛屿的信息。
`mode`	`'client' \| 'server' \| 'all'`	`false`	此选项指示组件应在客户端、服务器或两者上渲染。默认情况下，它将在客户端和服务器上渲染。
`priority`	`number`	`false`	组件的优先级，如果多个组件具有相同的名称，将使用优先级最高的组件。

示例

如果您想从 npm 包自动导入一个组件，并且该组件是命名导出（而不是默认导出），您可以使用 export 选项来指定它。

import { addComponent, defineNuxtModule } from '@nuxt/kit'

export default defineNuxtModule({
  setup () {
    // import { MyComponent as MyAutoImportedComponent } from 'my-npm-package'
    addComponent({
      name: 'MyAutoImportedComponent',
      export: 'MyComponent',
      filePath: 'my-npm-package',
    })
  },
})

※此页面是 Nuxt.js 官方文档的非官方翻译页面。

官方文档中的相应页面在此处：
https://nuxt.com/docs/3.x/api/kit/components