nuxt logo

Tradução da Documentação (Não Oficial)

Nuxt.js
Version:v3.17

Módulos

O Nuxt fornece um sistema de módulos para estender o núcleo do framework e simplificar integrações.

Explorando Módulos do Nuxt

Ao desenvolver aplicações de nível de produção com o Nuxt, você pode achar que a funcionalidade central do framework não é suficiente. O Nuxt pode ser estendido com opções de configuração e plugins, mas manter essas personalizações em vários projetos pode ser tedioso, repetitivo e demorado. Por outro lado, suportar as necessidades de todos os projetos de forma nativa tornaria o Nuxt muito complexo e difícil de usar.

Esta é uma das razões pelas quais o Nuxt fornece um sistema de módulos que torna possível estender o núcleo. Os módulos do Nuxt são funções assíncronas que são executadas sequencialmente ao iniciar o Nuxt no modo de desenvolvimento usando nuxt dev ou ao construir um projeto para produção com nuxt build. Eles podem substituir templates, configurar carregadores do webpack, adicionar bibliotecas CSS e realizar muitas outras tarefas úteis.

O melhor de tudo é que os módulos do Nuxt podem ser distribuídos em pacotes npm. Isso possibilita que eles sejam reutilizados em vários projetos e compartilhados com a comunidade, ajudando a criar um ecossistema de complementos de alta qualidade.

Veja também modules

Adicionar Módulos do Nuxt

Depois de instalar os módulos, você pode adicioná-los ao seu arquivo nuxt.config.ts na propriedade modules. Os desenvolvedores de módulos geralmente fornecem etapas adicionais e detalhes para uso.

nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    // Usando o nome do pacote (uso recomendado)
    '@nuxtjs/example',

    // Carregar um módulo local
    './modules/example',

    // Adicionar módulo com opções inline
    ['./modules/example', { token: '123' }],

    // Definição de módulo inline
    async (inlineOptions, nuxt) => { }
  ]
})

Os módulos do Nuxt agora são apenas em tempo de build, e a propriedade buildModules usada no Nuxt 2 está obsoleta em favor de modules.

Criar um Módulo do Nuxt

Todos têm a oportunidade de desenvolver módulos e mal podemos esperar para ver o que você irá construir.

Veja também Guia do Autor de Módulos