nuxt logo

문서 번역(비공식)

자동 임포트

Nuxt Kit은 자동 임포트를 도와주는 유틸리티 세트를 제공합니다. 이 함수들은 여러분이 직접 유틸, 컴포저블 및 Vue API를 등록할 수 있게 해줍니다.

Nuxt는 애플리케이션 전반에서 명시적으로 임포트하지 않고도 사용할 수 있도록 헬퍼 함수, 컴포저블 및 Vue API를 자동으로 임포트합니다. 디렉토리 구조에 기반하여, 모든 Nuxt 애플리케이션은 자체 컴포저블 및 플러그인에 대해 자동 임포트를 사용할 수 있습니다.

Nuxt Kit을 사용하면 여러분만의 자동 임포트를 추가할 수도 있습니다. addImportsaddImportsDir은 Nuxt 애플리케이션에 임포트를 추가할 수 있게 해줍니다. addImportsSources는 서드 파티 패키지에서 나열된 임포트를 Nuxt 애플리케이션에 추가할 수 있게 해줍니다.

이 유틸리티들은 Nuxt에서 사용되는 기본 자동 임포트 메커니즘을 제공하는 unimport에 의해 구동됩니다.

이 함수들은 여러분만의 유틸, 컴포저블 및 Vue API를 등록하기 위해 설계되었습니다. 페이지, 컴포넌트 및 플러그인에 대해서는 특정 섹션을 참조하세요: Pages, Components, Plugins.

Nuxt Kit 유틸리티의 자동 임포트에 대한 Vue School 비디오를 시청하세요.

addImports

Nuxt 애플리케이션에 임포트를 추가합니다. 수동으로 임포트할 필요 없이 Nuxt 애플리케이션에서 임포트를 사용할 수 있게 합니다.

사용법

import { defineNuxtModule, addImports } from "@nuxt/kit";

export default defineNuxtModule({
  setup(options, nuxt) {
    const names = [
      "useStoryblok",
      "useStoryblokApi",
      "useStoryblokBridge",
      "renderRichText",
      "RichTextSchema"
    ];

    names.forEach((name) =>
      addImports({ name, as: name, from: "@storyblok/vue" })
    );
  }
})

타입

function addImports (imports: Import | Import[]): void

매개변수

imports: 다음 속성을 가진 객체 또는 객체 배열:

속성타입필수설명
namestringtrue감지할 임포트 이름.
fromstringtrue임포트할 모듈 지정자.
prioritynumberfalse임포트의 우선순위; 동일한 이름의 여러 임포트가 있을 경우, 가장 높은 우선순위를 가진 것이 사용됩니다.
disabledbooleanfalse이 임포트가 비활성화되었는지 여부.
metaRecord<string, any>false임포트의 메타데이터.
typebooleanfalse이 임포트가 순수 타입 임포트인지 여부.
typeFromstringfalse타입 선언을 생성할 때 from 값으로 사용할 값.
asstringfalse이 이름으로 임포트.

addImportsDir

디렉토리에서 Nuxt 애플리케이션으로 임포트를 추가합니다. 디렉토리의 모든 파일을 자동으로 임포트하고 수동으로 임포트할 필요 없이 Nuxt 애플리케이션에서 사용할 수 있게 합니다.

사용법

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

export default defineNuxtModule({
  meta: {
    name: '@vueuse/motion',
    configKey: 'motion',
  },
  setup(options, nuxt) {
    const resolver = createResolver(import.meta.url)
    addImportsDir(resolver.resolve('./runtime/composables'))
  },
})

타입

function addImportsDir (dirs: string | string[], options?: { prepend?: boolean }): void

매개변수

속성타입필수설명
dirsstring | string[]true임포트할 디렉토리의 경로를 가진 문자열 또는 문자열 배열.
options{ prepend?: boolean }false임포트에 전달할 옵션. prependtrue로 설정되면, 임포트 목록의 앞에 추가됩니다.

addImportsSources

나열된 임포트를 Nuxt 애플리케이션에 추가합니다.

사용법

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

export default defineNuxtModule({
  setup() {
    addImportsSources({
      from: 'h3',
      imports: [
        'defineEventHandler',
        'getQuery',
        'getRouterParams',
        'readBody',
        'sendRedirect'
      ],
    })
  }
})

타입

function addImportsSources (importSources: ImportSource | ImportSource[]): void

매개변수

importSources: 다음 속성을 가진 객체 또는 객체 배열:

속성타입필수설명
fromstringtrue임포트할 모듈 지정자.
importsPresetImport | ImportSource[]true임포트 이름, 임포트 객체 또는 임포트 소스가 될 수 있는 객체 또는 객체 배열.