README

Bootstrap 扩展 for Yii 2

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

这是为 Bootstrap 提供的扩展，用于 Yii 框架 2.0。它封装了 Bootstrap 分布式资产，从而使得在 Yii 应用中使用 Bootstrap 变得极其简单。

功能特性

无 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

yidas / yii2-bootstrap

维护者

详细信息