首页
/ Eleventy 3.0 新特性:无需导入的核心插件解析功能

Eleventy 3.0 新特性:无需导入的核心插件解析功能

2025-05-12 15:54:06作者:戚魁泉Nursing

Eleventy 3.0 引入了一项创新功能,允许开发者直接解析和使用核心内置插件,而无需通过传统的 require 或 import 语句。这项改进显著提升了插件的兼容性,特别是在处理 CommonJS 模块和 Node.js 22 以下版本的环境中。

核心功能解析

新版本提供了 eleventyConfig.resolvePlugin 方法,开发者可以通过以下方式使用核心插件:

export default async function(eleventyConfig) {
  let htmlBasePlugin = await eleventyConfig.resolvePlugin("@11ty/eleventy/html-base-plugin");
  eleventyConfig.addPlugin(htmlBasePlugin);
};

支持的核心插件

目前支持以下核心插件的解析:

  1. HTML 基础插件 (@11ty/eleventy/html-base-plugin)
  2. 国际化插件 (@11ty/eleventy/i18n-plugin)
  3. 渲染插件 (@11ty/eleventy/render-plugin)
  4. 输入路径转URL插件 (@11ty/eleventy/inputpath-to-url-plugin)

同步与异步支持

在 3.0.0-alpha.14 及更高版本中,大部分核心插件已实现同步解析功能,进一步简化了配置流程:

export default function(eleventyConfig) {
  let htmlBasePlugin = eleventyConfig.resolvePlugin("@11ty/eleventy/html-base-plugin");
  eleventyConfig.addPlugin(htmlBasePlugin);
};

需要注意的是,国际化插件 (@11ty/eleventy/i18n-plugin) 目前仍需要异步处理,而其他三个插件均已支持同步解析。

技术优势

这项改进带来了多项技术优势:

  1. 更好的兼容性:解决了 CommonJS 和 ESM 模块系统之间的兼容问题
  2. 更简洁的代码:减少了冗余的导入语句
  3. 更灵活的配置:支持同步和异步两种使用方式
  4. 更平滑的升级路径:为从旧版本迁移提供了更友好的过渡方案

实际应用场景

这项功能特别适用于以下场景:

  • 将现有项目升级到 Eleventy 3.0
  • 开发需要同时支持多种模块系统的插件
  • 在较旧版本的 Node.js 环境中使用 Eleventy
  • 创建需要最大兼容性的共享配置

通过这项改进,Eleventy 继续巩固其作为静态站点生成器的领先地位,为开发者提供了更强大、更灵活的工具集。

登录后查看全文
热门项目推荐
相关项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
24
9
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
64
19
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
392
3.89 K
flutter_flutterflutter_flutter
暂无简介
Dart
671
156
giteagitea
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
23
0
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
JavaScript
261
322
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
661
311
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.2 K
654
rainbondrainbond
无需学习 Kubernetes 的容器平台,在 Kubernetes 上构建、部署、组装和管理应用,无需 K8s 专业知识,全流程图形化管理
Go
15
1