介绍

Modern.js 插件系统

Modern.js 提供了一套拥有完整生命周期的插件系统。插件可用于扩展项目运行、请求、渲染等不同阶段功能,

使用方式

插件需要在配置文件中显式注册才能够生效,当需要为 Modern.js 添加插件时,可以将它配置到 plugins 字段中:

edenx.config.ts
// an example for bff
import { appTools, defineConfig } from '@modern-js/app-tools';
import { bffPlugin } from '@modern-js/plugin-bff';

export default defineConfig({
  plugins: [appTools(), bffPlugin()],
});
NOTE

注意,该配置仅支持添加 Modern.js 插件,无法添加 Webpack 插件。

官方插件

Modern.js 提供了一系列官方插件,并与 Modern.js 生成器结合。所有的官方插件功能,都可以通过执行 new 命令开启。例如当需要开启 BFF 功能时:

$ npx modern new
? 请选择你想要的操作 启用可选功能
? 请选择功能名称 (Use arrow keys)
  启用 「Tailwind CSS」 支持
❯ 启用「BFF」功能
  启用「微前端」模式
  启用「单元测试 / 集成测试」功能

完成选择后,Modern.js 生成器会自动安装对应的插件和三方依赖,安装完成后可以看到:

[INFO] 依赖自动安装成功

[INFO] 安装插件依赖成功!请添加如下代码至 modern.config.ts :

import { bffPlugin } from '@modern-js/plugin-bff';
import { expressPlugin } from '@modern-js/plugin-express';

export default defineConfig({
  ...,
  plugins: [..., bffPlugin(), expressPlugin()],
});

此时,可以按照控制台的输出,将插件添加到配置文件中。

插件系统组成

Modern.js 插件系统主要分为三个部分:Hook 模型、管理器,上下文共享机制。

  • Hook 模型用于确定当前 Hook 的执行逻辑。
  • 管理器用于控制 Hook 的执行与调度。
  • 上下文共享机制用于在不同 Hook 间传递信息。

目前 Modern.js 提供几种不同的 Hook 模型:Pipeline、Waterfall、Workflow

NOTE

后续章节详细介绍各个模型的执行方式。

Modern.js 基于 Hook 模型暴露了三套插件:CLI、Runtime、Server。

其中 CLI 插件是 Modern.js 中主要的运行流程控制模型,Modern.js 中绝大部分功能都是主要通过这一套模型运行的。Runtime 插件主要负责处理 React 组件渲染逻辑。Server 插件主要用于对服务端的生命周期以及用户请求的控制。

插件可以做什么

Modern.js 的所有功能都是通过这套插件实现的,这意味着 Modern.js 中的所有能力是都对开发者开放的。开发者可以通过编写插件来扩展更多功能,适配复杂场景,包括但不限于:

  • 注册命令
  • 修改 Modern.js 配置、配置校验 Schema
  • 修改编译时的 Webpack/Babel/Less/Sass/Tailwind CSS/... 配置
  • 修改运行时需要渲染的 React 组件、Element
  • 修改页面路由
  • 修改服务器路由
  • 自定义控制台输出
  • 自定义动态 HTML 模版
  • 自定义 Node.js 服务器框架
  • 自定义 React 组件客户端/服务器端渲染
  • ...

当 Modern.js 暂时没有覆盖到所需要的功能或场景时,可以开发一个自定义插件,来实现适配特殊场景的相关功能。