用途:在 Joomla 5/6 配合 Helix 框架的前端开发中,集中管理 CSS 与 JavaScript、组织资源依赖并实现响应式设计。
主要能力:以 WebAssetManager(\Joomla\CMS\WebAsset\WebAssetManager)替代已弃用的 HTMLHelper 与 Document API,通过 joomla.asset.json 声明资源名称、类型、uri、依赖和属性,支持自动版本号(version auto 取最后修改时间)、多重依赖与 preset 依赖组、依赖类型后缀(如 jquery#script)、内联脚本与样式、动态注册与 CDN 资源。可设置 defer/async:jQuery、Bootstrap 及依赖 jQuery 的自定义脚本宜 defer: true、async: false;分析与第三方组件宜 async。Helix 内置 Bootstrap 5.2.3+,提供 12 列网格与断点(sm 576、md 768、lg 992、xl 1200、xxl 1400),可按移动优先写媒体查询。
使用方式:用 Factory::getApplication()->getDocument()->getWebAssetManager() 取得实例,再调用 useScript/useStyle 加载,registerAndUseScript 动态注册,addInlineScript/addInlineStyle 插入内联代码。模块按 /mod_mymodule/ 结构放置 joomla.asset.json、helper.php 等;模板资源位于 templates/模板名/joomla.asset.json。SP Page Builder 可在行/列自定义 CSS,自定义 JS 需建 sppagebuilder 类型插件。Helix 自定义代码位于后台模板选项的 Custom Code 标签。
限制与注意:不要修改 template.css、bootstrap.css、template.js 等核心文件,应使用 custom.css/custom.scss/custom.js 或后台 Custom Code;不要覆盖 Bootstrap 类,应新建自定义类。资源不加载时检查 head 输出、路径、权限(755)与缓存;顺序异常检查依赖与 Network 面板。资料未提供具体收费、价格或平台支持信息。