yidas/yii2-auto-asset-bundle

Base Asset Bundle for Yii2 to auto-allocate JS & CSS files for each View

   , _(*1)

Yii 2 Auto Asset Bundle

Base Asset Bundle for Yii2 to auto-allocate JS & CSS files for each View, _(*2)

, _(*3)

FEATURES

• Each View would has it own JS & CSS asset files, _(*4)

• Standard Asset files' structure same as View paths, _(*5)

• Single AssetBundle automatically handles all Views' assets by registering, _(*6)

Felt dirty of writting Javascript code in View file? Got tired of creating asset for every View files?, _(*7)

If each View need Javascript & CSS for it self, the AssetBundle library allocates pairs of asset files for each registered View, which each View's path is same as allocated assets path with base path setting., _(*8)

DEMONSTRATION

A View file which locates:, _(*9)

yii2-app-basic/views/site/about.js

After registering AutoAssetBundle, the View file would auto-load above assets files if exist:, _(*10)

yii2-app-basic/web/dist/app/site/about.js
yii2-app-basic/web/dist/app/site/about.css

dist/app/ is the prefix base path which could be customized., _(*11)

REQUIREMENTS

This library requires the following:, _(*12)

• PHP 5.4.0+
• Yii 2.0.0+

INSTALLATION

Install via Composer in your Yii2 project:, _(*13)

composer require yidas/yii2-auto-asset-bundle

CONFIGURATION

You could create an asset to extend \yidas\web\AutoAssetBundle with your application configuration:, _(*14)

namespace app\assets;

class AutoAssetBundle extends \yidas\web\AutoAssetBundle {}

Customized Setting

You could customize asset to fit your application:, _(*15)

namespace app\assets;

class AutoAssetBundle extends \yidas\web\AutoAssetBundle
{
    // Base path & url for each view's asset in your application
    public $basePath = '@webroot/dist/app';
    public $baseUrl = '@web/dist/app';

    public $depends = [
        'app\assets\AppAsset',
    ];
}

USAGE

Register configured asset in the content View, for example yii2-app-basic/views/controller/action.php:, _(*16)

<?php

\app\assets\AutoAssetBundle::register($this);

After that, this view would auto load following files:, _(*17)

yii2-app-basic/web/dist/app/controller/action.js
yii2-app-basic/web/dist/app/controller/action.css

The prefix path relates to the view path., _(*18)