README

Bootstrap 扩展为 Yii 2

使用官方 Composer 的 Yii2 框架 Bootstrap 资产包扩展

这是为 Bootstrap 扩展的 Yii 框架 2.0。它封装了 Bootstrap 发布的资产，因此使 Bootstrap 在 Yii 应用程序中非常容易使用。

功能特性

• 不使用 Bower，仅通过 Composer 安装

• CDN & 官方 资源来源提供

• 版本控制 指的是 jQuery

要求

此库需要以下内容

• PHP 5.4.0+
• yiisoft/yii2 2.0.6+
• twbs/bootstrap 4.0+
• yidas/yii2-jquery 2.0+

安装

首选安装方式是通过 Composer

composer require yidas/yii2-bootstrap

版本选项参照 Bootstrap 发布

composer require yidas/yii2-bootstrap ~3.0
composer require yidas/yii2-bootstrap ~4.0

或者，您可以通过编辑 composer.json 在 require 部分添加包，然后运行 composer update。

"yidas/yii2-bootstrap": "*"

配置

注册或依赖资产到您的应用程序

yidas\yii\bootstrap\BootstrapAsset

例如，要在视图中注册 Bootstrap 资产

\yidas\yii\bootstrap\BootstrapAsset::register($this);

或作为应用程序资产包的依赖项

namespace app\assets;
use yii\web\AssetBundle;
class AppAsset extends AssetBundle
{
    public $basePath = '@webroot';
    public $baseUrl = '@web';
    public $css = [
        'css/site.css',
    ];
    public $js = [
    ];
    public $depends = [
        'yii\web\YiiAsset',
        'yidas\yii\bootstrap\BootstrapAsset'
    ];
}

CDN 资产模式

您可以通过配置 config 文件将资产切换为使用 CDN 发布

'components' => [
    'assetManager' => [
        'bundles' => [
            'yidas\yii\bootstrap\BootstrapAsset' => [
                'cdn' => true,
                // 'cdnVersion' => '4.1.3',
            ],
        ],
    ],
],

指定 CDN 源

您也可以指定您喜欢的 CDN 源

'assetManager' => [
    'bundles' => [
        'yidas\yii\fontawesome\FontawesomeAsset' => [
            'cdn' => true,
            'cdnCSS' => ['https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css'],
            'cdnJS' => ['https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js'],
        ],
    ],
],

jQuery 依赖

此 Bootstrap 扩展需要 jQuery JavaScript 库，您可以在 $depends 中设置 yii\web\JqueryAsset，或者简单地在您的 jQuery JS 文件中依赖一个资产，无论它是 CDN 还是其他。

    public $depends = [
        //'yii\web\JqueryAsset',
        'yidas\yii\jquery\JqueryAsset',
        'yidas\yii\bootstrap\BootstrapAsset'
    ];

另一种方式，您可以通过设置 BootstrapAsset 的 jquery 属性轻松启用 jQuery 依赖。

'components' => [
    'assetManager' => [
        'bundles' => [
            'yidas\yii\bootstrap\BootstrapAsset' => [
                'jquery' => true,
                // 'cdn' => true,
            ],
            'yidas\yii\jquery\JqueryAsset' => [
                // 'cdn' => true,
            ],
        ],
    ],   
],

用法

版本控制

更新依赖的包

composer update yidas/yii2-bootstrap

更新最新的 Bootstrap 版本

composer update twbs/bootstrap

指定 Bootstrap 版本

composer require twbs/bootstrap 4.1.3