进阶 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 已作为全局变量可用。

评论 (0)