yii2 AssetBundle使用

杰哥技术分享

于 2024-07-14 09:52:16 发布

阅读量422

点赞数 3

文章标签： yii

本文链接：https://blog.csdn.net/sunyujie678/article/details/140412738

版权

在 Yii 框架中，AssetBundle 类是用来管理和注册资源包（如 CSS、JS 文件）的一个非常方便的方式。AppAsset 类继承自 AssetBundle，用于定义应用的主要前端资源。

在 AppAsset 类中，basePath 和 baseUrl 属性用于定义资源文件的物理路径和 URL 路径。

basePath：定义资源文件存放的物理路径。@webroot 是一个别名，它指向你的 web 目录的根目录。这意味着如果你有一个 CSS 文件放在 web 目录的 css 文件夹下，你可以使用 @webroot/css 来访问它。
baseUrl：定义资源文件的 URL 路径。@web 同样是一个别名，它指向你的 web 目录的 URL。如果你的 web 目录配置为应用的根目录，那么 @web 实际上就是网站的根 URL。

如何使用 `basePath`

定义资源路径：首先，确保你的资源文件（如 CSS、JS）已经放在了正确的目录下。比如，你有一个 CSS 文件放在了 web/css 目录下。
配置 AppAsset：在 AppAsset 类中，你可以通过修改 $css 和 $js 属性来注册你的资源文件。例如，如果你想注册上面提到的 CSS 文件，你可以这样做：
```
public $css = [
    'css/my-style.css', // 相对于 basePath 的路径
];
```
使用资源：一旦你在 AppAsset 类中注册了资源文件，Yii 会自动处理这些文件的加载。在你的视图或布局文件中，你只需要调用 AppAsset::register($this) 方法来确保资源被正确加载。通常，这会在你的基础布局文件中完成。

示例

假设你有一个基础布局文件 views/layouts/main.php，你可以这样注册资源：

<?php
use app\assets\AppAsset;

AppAsset::register($this);
?>
<?php $this->beginPage() ?>
<!DOCTYPE html>
<html lang="<?= Yii::$app->language ?>">
<head>
    <meta charset="<?= Yii::$app->charset ?>">
    <!-- 其他 head 标签 -->
    <?php $this->head() ?>
</head>
<body>
    <?php $this->beginBody() ?>
    
    <!-- 页面内容 -->

    <?php $this->endBody() ?>
</body>
</html>
<?php $this->endPage() ?>