administrcms/asset-manager

1.1.4 2021-04-12 19:35 UTC

This package is auto-updated.

Last update: 2024-09-13 03:48:28 UTC


README

Build Status Code Climate Test Coverage

安装

使用 Composer

composer require administrcms/asset-manager

添加服务提供者

\Administr\Assets\AssetsServiceProvider::class,

外观

'Asset'    => \Administr\Assets\AssetsFacade::class,

使用方法

基本使用

资产管理器与 Laravel 框架协同工作。它提供了一个外观(Facade)以简化使用。

您可以通过 add 方法或使用魔法方法指定您的资产组。

Asset::add('test.css', 'css');
// is the same as
Asset::addCss('test.css');

您可以通过 get 方法或其等价的魔法方法检索一个组。

Asset::get('css');
// is the same as
Asset::getCss();

您还可以为您的资产指定优先级。例如,当使用 jQuery 库时,您需要在其依赖的其他库之前包含它。

// The sort is from highest to lowest priority. The default priority is 0.
Asset::addJs('jquery.js', 100);
Asset::add('jquery.js', 'js', 100);

快捷方式

您可以定义一个快捷方式,这是一个一次定义多个资产的类。如果您正在使用需要包含 js 和 css 代码的 js 库,这将简化操作。

// Create a class that implements the Shortcut contract
class WysiwygShortcut implements Administr\Assets\Contracts\Shortcut {
    public function execute()
    {
        Asset::addJs('tinymce.js');
        Asset::addCss('tinymce.css');
        Asset::addCss('tinymce.theme.css');
    }
}

// Register it with the Asset Manager
Asset::shortcut('wysiwyg', WysiwygShortcut::class);

// And then call it like a method of the Manager
Asset::wysiwyg();

您决定在哪里注册快捷方式。一个不错的选择是在您的 Laravel 应用程序中的 ServiceProvider 中。