Updates to release v3.2.4 fixes #828 fixes #829

CHANGE.md

@@ -1,6 +1,13 @@
 Change Log: `yii2-grid`
 =======================
 
+## Version 3.2.4
+
+**Date:** 22-Sep-2018
+
+- (enh #829): Enhancements in parsing Bootstrap CSS classes (ref: kartik-v/yii2-krajee-base#100).
+- (enh #828): Enhance `ActionColumn::dropdownButton` to be setup as a callback.
+
 ## Version 3.2.3
 
 **Date:** 22-Sep-2018

src/ActionColumn.php

@@ -3,11 +3,12 @@
 /**
  * @copyright Copyright © Kartik Visweswaran, Krajee.com, 2014 - 2018
  * @package yii2-grid
- * @version 3.2.3
+ * @version 3.2.4
  */
 
 namespace kartik\grid;
 
+use Closure;
 use Yii;
 use yii\grid\ActionColumn as YiiActionColumn;
 use yii\helpers\ArrayHelper;
@@ -56,12 +57,20 @@ class ActionColumn extends YiiActionColumn
     public $dropdownMenu = ['class' => 'text-left'];
 
     /**
-     * @var array the dropdown button options. This configuration will be applicable only if [[dropdown]] is `true`.
-     * The following special options are recognized:
+     * @var array|Closure the dropdown button options. This configuration will be applicable only if [[dropdown]] is
+     * `true`. When set as an array, the following special options are recognized:
      *
      * - `label`: _string_', the button label to be displayed. Defaults to `Actions`.
-     * - `caret`: _string_', the caret symbol to be appended to the dropdown button.
-     *   Defaults to ` <span class="caret"></span>`.
+     * - `caret`: _string_', the caret symbol to be appended to the dropdown button. Applicable only for Bootstrap 3.x
+     *   versions when `GridView::bsVersion = 3.x`. Defaults to ` <span class="caret"></span>`.
+     *
+     * This can also be setup as a `Closure` callback function of the following signature that returns the above array:
+     *
+     * `function ($model, $key, $index) {}`, where:
+     *
+     * - `$model`: _\yii\db\ActiveRecordInterface_ is the data model of current row
+     * - `$key`: _mixed_, is the key associated with the data model
+     * - `$index`: _int_, is the current row index
      */
     public $dropdownButton = [];
 
@@ -140,9 +149,6 @@ public function init()
         }
         $this->parseFormat();
         $this->parseVisibility();
-        if (!isset($this->dropdownButton['class'])) {
-            $this->dropdownButton['class'] = 'btn ' . $this->grid->getDefaultBtnCss();
-        }
         parent::init();
         $this->initDefaultButtons();
         $this->setPageRows();
@@ -263,6 +269,12 @@ protected function renderDataCellContent($model, $key, $index)
         }
         $content = parent::renderDataCellContent($model, $key, $index);
         $options = $this->dropdownButton;
+        if (is_callable($options)) {
+            $options = $options($model, $key, $index);
+        }
+        if (!isset($options['class'])) {
+            $options['class'] = 'btn ' . $this->grid->getDefaultBtnCss();
+        }
         $trimmed = trim($content);
         if ($this->_isDropdown && !empty($trimmed)) {
             $label = ArrayHelper::remove($options, 'label', Yii::t('kvgrid', 'Actions'));

src/ActionColumnAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/BooleanColumn.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/CheckboxColumn.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;
@@ -69,7 +69,7 @@ public function init()
             'width' => '50px'
         ]);
         if (!isset($this->rowSelectedClass)) {
-            $this->rowSelectedClass = ($this->grid->isBs4() ? 'table-' : '') . GridView::TYPE_DANGER;
+            $this->rowSelectedClass = $this->grid->getCssClass(GridView::BS_TABLE_DANGER);
         }
         $id = $this->grid->options['id'];
         $view = $this->grid->getView();

src/CheckboxColumnAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/ColumnTrait.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/DataColumn.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/Demo.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/EditableColumn.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/EditableColumnAction.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/EditableColumnAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/ExpandRowColumn.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;
@@ -232,7 +232,7 @@ protected static function parseData($data, $model, $key, $index, $column)
     public function init()
     {
         if (!isset($this->detailRowCssClass)) {
-            $this->detailRowCssClass = $this->grid->isBs4() ? 'table-' . GridView::TYPE_INFO : GridView::TYPE_INFO;
+            $this->detailRowCssClass = $this->grid->getCssClass(GridView::BS_TABLE_INFO);
         }
         $this->initColumnSettings([
             'hiddenFromExport' => true,

src/ExpandRowColumnAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/FormulaColumn.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridExportAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridFloatHeadAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridGroupAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridPerfectScrollbarAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridResizeColumnsAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridResizeStoreAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridToggleDataAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/GridView.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;
@@ -834,13 +834,13 @@ class GridView extends YiiGridView implements BootstrapInterface
      *          'all' => [
      *              'icon' => 'resize-full',
      *              'label' => 'All',
-     *              'class' => 'btn btn-default',
+     *              'class' => 'btn btn-default', // 'btn btn-secondary' for BS4.x
      *              'title' => 'Show all data'
      *          ],
      *          'page' => [
      *              'icon' => 'resize-small',
      *              'label' => 'Page',
-     *              'class' => 'btn btn-default',
+     *              'class' => 'btn btn-default', // 'btn btn-secondary' for BS4.x
      *              'title' => 'Show first page data'
      *          ],
      *      ]
@@ -894,7 +894,8 @@ class GridView extends YiiGridView implements BootstrapInterface
      *   This should be similar to the `items` property as supported by `\yii\bootstrap\ButtonDropdown` widget. Note
      *   the page export items will be automatically generated based on settings in the `exportConfig` property.
      * - `options`: _array_, HTML attributes for the export menu button. Defaults to
-     *   `['class' => 'btn btn-default', 'title'=>'Export']`.
+     *    - `['class' => 'btn btn-default']` for [[bsVersion]] = '3.x' or .
+     *    - `['class' => 'btn btn-secondary']` for [[bsVersion]] = '4.x'
      * - `encoding`: _string_, the export output file encoding. If not set, defaults to `utf-8`.
      * - `bom`: `boolean`, whether a BOM is to be embedded for text or CSV files with utf-8 encoding. Defaults to
      *   `true`.
@@ -1073,9 +1074,6 @@ public function init()
         if (!isset($this->itemLabelMany)) {
             $this->itemLabelMany = Yii::t('kvgrid', 'items-many');
         }
-        if (!isset($this->panelPrefix)) {
-            $this->panelPrefix = $this->isBs4() ? 'card' : 'panel panel-';
-        }
         $isBs4 = $this->isBs4();
         if ($isBs4) {
             Html::addCssClass($this->options, 'kv-grid-bs4');
@@ -1755,7 +1753,7 @@ protected function initBootstrapStyle()
             Html::addCssClass($this->tableOptions, 'table-striped');
         }
         if ($this->condensed) {
-            Html::addCssClass($this->tableOptions, ($this->isBs4() ? 'table-sm' : 'table-condensed'));
+            $this->addCssClass($this->tableOptions, self::BS_TABLE_CONDENSED);
         }
         if ($this->floatHeader) {
             if ($this->perfectScrollbar) {
@@ -1909,19 +1907,22 @@ protected function renderPanel()
         $panelAfter = '';
         $panelFooter = '';
         $isBs4 = $this->isBs4();
-        static::initCss($options, $isBs4 ? 'card border-' . $type : $this->panelPrefix . $type);
-        static::initCss($summaryOptions, $isBs4 ? 'float-right' : 'pull-right');
-        $titleTag = ArrayHelper::remove($titleOptions, 'tag', ($isBs4 ? 'span' : 'h3'));
-        if (!$isBs4) {
-            static::initCss($titleOptions, 'panel-title');
+        if (isset($this->panelPrefix)) {
+            static::initCss($options, $this->panelPrefix . $type);
+        } else {
+            $this->addCssClass($options, self::BS_PANEL);
+            Html::addCssClass($options, $isBs4 ? "border-{$type}" : "panel-{$type}");
         }
+        static::initCss($summaryOptions, $this->getCssClass(self::BS_PULL_RIGHT));
+        $titleTag = ArrayHelper::remove($titleOptions, 'tag', ($isBs4 ? 'h5' : 'h3'));
+        static::initCss($titleOptions, $isBs4 ? 'm-0' : $this->getCssClass(self::BS_PANEL_TITLE));
         if ($heading !== false) {
-            $color = $type === 'default' ? 'bg-light' : 'text-white bg-' . $type;
-            static::initCss($headingOptions, $isBs4 ? 'card-header ' . $color : 'panel-heading');
+            $color = $isBs4 ? ($type === 'default' ? ' bg-light' : " text-white bg-{$type}") : '';
+            static::initCss($headingOptions, $this->getCssClass(self::BS_PANEL_HEADING) . $color);
             $panelHeading = Html::tag('div', $this->panelHeadingTemplate, $headingOptions);
         }
         if ($footer !== false) {
-            static::initCss($footerOptions, $isBs4 ? 'card-footer' : 'panel-footer');
+            static::initCss($footerOptions, $this->getCssClass(self::BS_PANEL_FOOTER));
             $content = strtr($this->panelFooterTemplate, ['{footer}' => $footer]);
             $panelFooter = Html::tag('div', $content, $footerOptions);
         }
@@ -1983,8 +1984,7 @@ protected function renderToolbar()
     protected function renderToolbarContainer()
     {
         $tag = ArrayHelper::remove($this->toolbarContainerOptions, 'tag', 'div');
-        $css = $this->isBs4() ? 'float-right' : 'pull-right';
-        Html::addCssClass($this->toolbarContainerOptions, $css);
+        $this->addCssClass($this->toolbarContainerOptions, self::BS_PULL_RIGHT);
         return Html::tag($tag, $this->renderToolbar(), $this->toolbarContainerOptions);
     }
 

src/GridViewAsset.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;

src/Module.php

@@ -4,7 +4,7 @@
  * @package   yii2-grid
  * @author    Kartik Visweswaran <[email protected]>
  * @copyright Copyright &copy; Kartik Visweswaran, Krajee.com, 2014 - 2018
- * @version   3.2.3
+ * @version   3.2.4
  */
 
 namespace kartik\grid;