ischenko/yii2-jsloader

An Yii2 extension designed to handle JS files, code and asset bundles via various js loaders

yii2-jsloader

, _(*1)

An extension provides behavior which allows to process js files, code and asset bundles by various js loaders such as RequireJS., _(*2)

Along with behavior it provides a set of interfaces and base classes for implementing a js loader., _(*3)

Currently available implementations of js loaders are: - yii2-jsloader-requirejs - yii2-jsloader-systemjs, _(*4)

Installation

*Requires PHP >= 7.1, _(*5)

The preferred way to install this extension is through composer., _(*6)

Either run, _(*7)

composer require ischenko/yii2-jsloader

or add, _(*8)

"ischenko/yii2-jsloader": "*"

to the require section of your composer.json., _(*9)

Usage

Add the behavior and concrete loader implementation to a view configuration, _(*10)

    ...
    'components' => [
        ...
        'view' => [
            'as jsLoader' => [
                'class' => 'ischenko\yii2\jsloader\Behavior',
                'loader' => [
                    'class' => 'loader\namespace\LoaderClass'
                ]
            ]
        ]
        ...
    ]
    ...

By default the loader skips scripts and bundles/files located in the head section, but if you need to include those scripts or exclude another section(s) you can do this via ignorePositions property:, _(*11)

    ...
    'components' => [
        ...
        'view' => [
            'as jsLoader' => [
                'class' => 'ischenko\yii2\jsloader\Behavior',
                'loader' => [
                    'class' => 'loader\namespace\LoaderClass',
                    'ignorePositions' => [
                        View::POS_HEAD,
                        View::POS_BEGIN
                    ]
                ]
            ]
        ]
        ...
    ]
    ...

Additionally you can set a list of an asset bundles that should be ignored by the loader via ignoreBundles property:, _(*12)

    ...
    'components' => [
        ...
        'view' => [
            'as jsLoader' => [
                'class' => 'ischenko\yii2\jsloader\Behavior',
                'loader' => [
                    'class' => 'loader\namespace\LoaderClass',
                    'ignoreBundles' => [
                        'app\assets\AppCssAsset'
                    ]
                ]
            ]
        ]
        ...
    ]
    ...