进阶 docs.nodebb.org 2026-10-13 15:07:09 · 31 阅读
第48章 在 NodeBB 中使用第三方库
使用第三方库
插件可以通过在 plugin.json 中配置 scripts 属性来定义客户端库,但有时你可能想引入自己并未编写的依赖脚本。这类脚本通常采用 AMD 风格编写,可供 require.js 等模块加载器使用,但由于它们往往未定义名称,NodeBB 无法直接加载。
你可能会遇到如下错误:
Uncaught Error: Mismatched anonymous define() module ...
这是匿名模块的常见错误,相关说明可参考这篇帮助文档。
简而言之,由于我们会对在 scripts 或 acpScripts 中定义的所有 JavaScript 文件进行压缩,导致没有足够的上下文信息供 require.js 判断文件相对于其调用位置的关系。
在 NodeBB 中,你应在 plugin.json 中使用 modules 属性为这些模块正确命名,以便它们能被正确引用和链接:
plugin.json { ... "modules": { "jquery.js": "/path/to/jquery.js" }, ... }
随后,你可以在客户端脚本中通过 require.js 加载 jQuery 模块:
require(['jquery'], function ($) { $('.someClass').addClass('someotherclass'); });
需要注意的是,这是一个假设性示例,因为在 NodeBB 中 jQuery 已作为全局变量可用。