Joomla 4中我最喜欢的改进之一是“Web资源”特性。它允许你通过一次调用按特定顺序加载一组JavaScript和CSS文件。
比方说,你希望加载依赖于其他文件的CSS或JavaScript文件。你可能加载一个依赖于jQuery的JavaScript文件。
在这个简短的教程中,我将向您展示Joomla 4的“Web资源”特性是如何工作的。
介绍joomla.asset.json文件
在模板的文件夹中,可以创建一个名为joomla.asset.json的文件。Cassiopeia是默认的Joomla 4模板,它已经包含了这个包含以下3个资源的文件:
- template.cassiopeia.base
- template.cassiopeia.ltr
- template.cassiopeia.rtl
以下是这3种资源在Cassiopeia的joomla.asset.json文件代码中的显示方式:
joomla.asset.json文件将自动运行在joomla 4站点的前端。但是,您需要定义要调用的资源。
如何调用资源
要调用资源,请在模板的index.php文件中放置以下两行代码:
$wa = $this->getWebAssetManager();
$wa->enableAsset('template.cassiopeia.ltr');
上述代码的第二行表示我们将按以下顺序调用资源:
- “template.cassiopeia.base”资源中的依赖项和文件。
- 来自template.cassiopeia.ltr资产的文件。
最酷的是依赖项可以嵌套。因此,依赖于另一个资源的资源可以有自己的依赖关系。这就是Joomla 4的“Web资源”特性如此强大的原因。