Add rowOptions property + prepare to release

Author: Eugene Tupikov

CHANGELOG.md

@@ -1,9 +1,14 @@
 Yii2 multiple input change log
 ==============================
 
-1.2.9 in development
+1.2.10 in development
 --------------------
 
+1.2.9
+-----
+
+- Enh #56: add `rowOptions` property
+
 1.2.8
 -----
 

README.md

@@ -8,7 +8,7 @@ Yii2 widget for handle multiple inputs for an attribute of model
 [![License](https://poser.pugx.org/unclead/yii2-multiple-input/license)](https://packagist.org/packages/unclead/yii2-multiple-input)
 
 ##Latest release
-The latest version of the extension is v1.2.8. Follow the [instruction](./UPGRADE.md) for upgrading from previous versions
+The latest version of the extension is v1.2.9. Follow the [instruction](./UPGRADE.md) for upgrading from previous versions
 
 Contents:
 
@@ -63,6 +63,18 @@ Widget support the following options that are additionally recognized over and a
 
 **columns** *array*: the row columns configuration where you can set the properties which is described below
 
+**rowOptions** *array|\Closure*: the HTML attributes for the table body rows. This can be either an array
+specifying the common HTML attributes for all body rows, or an anonymous function that returns an array of the HTML attributes.
+It should have the following signature:
+
+```php
+function ($model, $index, $context)
+```
+
+- `$model`: the current data model being rendered
+- `$index`: the zero-based index of the data model in the model array
+- `$context`: the widget object
+
 ### Column options
 
 **name** *string*: input name. *Required options*

composer.json

@@ -9,7 +9,7 @@
         "yii2 tabular input"
     ],
     "type": "yii2-extension",
-    "version": "1.2.8",
+    "version": "1.2.9",
     "license": "BSD-3-Clause",
     "support": {
         "issues": "https://github.com/unclead/yii2-multiple-input/issues?state=open",

examples/views/multiple-input.php

@@ -37,6 +37,14 @@
 <?= $form->field($model, 'schedule')->widget(MultipleInput::className(), [
     'limit' => 4,
     'allowEmptyList' => true,
+    'rowOptions' => function($model) {
+        $options = [];
+
+        if ($model['priority'] > 1) {
+            $options['class'] = 'danger';
+        }
+        return $options;
+    },
     'columns' => [
         [
             'name'  => 'user_id',

src/MultipleInput.php

@@ -77,6 +77,21 @@ class MultipleInput extends InputWidget
      */
     public $addButtonPosition = self::POS_ROW;
 
+    /**
+     * @var array|\Closure the HTML attributes for the table body rows. This can be either an array
+     * specifying the common HTML attributes for all body rows, or an anonymous function that
+     * returns an array of the HTML attributes. It should have the following signature:
+     *
+     * ```php
+     * function ($model, $index, $context)
+     * ```
+     *
+     * - `$model`: the current data model being rendered
+     * - `$index`: the zero-based index of the data model in the model array
+     * - `$context`: the MultipleInput widget object
+     *
+     */
+    public $rowOptions = [];
 
     /**
      * Initialization.
@@ -144,6 +159,7 @@ private function createRenderer()
             'allowEmptyList'    => $this->allowEmptyList,
             'min'               => $this->min,
             'addButtonPosition' => $this->addButtonPosition,
+            'rowOptions'        => $this->rowOptions,
             'context'           => $this
         ];
 

src/TabularInput.php

@@ -71,6 +71,21 @@ class TabularInput extends Widget
      */
     public $addButtonPosition = self::POS_ROW;
 
+    /**
+     * @var array|\Closure the HTML attributes for the table body rows. This can be either an array
+     * specifying the common HTML attributes for all body rows, or an anonymous function that
+     * returns an array of the HTML attributes. It should have the following signature:
+     *
+     * ```php
+     * function ($model, $index, $context)
+     * ```
+     *
+     * - `$model`: the current data model being rendered
+     * - `$index`: the zero-based index of the data model in the model array
+     * - `$context`: the TabularInput widget object
+     *
+     */
+    public $rowOptions = [];
 
     /**
      * Initialization.
@@ -114,6 +129,7 @@ private function createRenderer()
             'columnClass'       => TabularColumn::className(),
             'allowEmptyList'    => $this->allowEmptyList,
             'min'               => $this->min,
+            'rowOptions'        => $this->rowOptions,
             'addButtonPosition' => $this->addButtonPosition,
             'context'           => $this
         ];

src/components/BaseRenderer.php

@@ -78,6 +78,22 @@ abstract class BaseRenderer extends Object
      */
     public $allowEmptyList = false;
 
+    /**
+     * @var array|\Closure the HTML attributes for the table body rows. This can be either an array
+     * specifying the common HTML attributes for all body rows, or an anonymous function that
+     * returns an array of the HTML attributes. It should have the following signature:
+     *
+     * ```php
+     * function ($model, $index, $context)
+     * ```
+     *
+     * - `$model`: the current data model being rendered
+     * - `$index`: the zero-based index of the data model in the model array
+     * - `$context`: the widget object
+     *
+     */
+    public $rowOptions = [];
+
     /**
      * @var string
      */

src/renderers/TableRenderer.php

@@ -151,13 +151,31 @@ private function renderRowContent($index = null, $item = null)
             $cells[0] = preg_replace('/^(<td[^>]+>)(.*)(<\/td>)$/s', '${1}' . $hiddenInputs . '$2$3', $cells[0]);
         }
 
-        $content = Html::tag('tr', implode("\n", $cells), [
-            'class' => 'multiple-input-list__item',
-        ]);
+
+        $content = Html::tag('tr', implode("\n", $cells), $this->prepareRowOptions($index, $item));
 
         return $content;
     }
 
+    /**
+     * Prepares the row options.
+     *
+     * @param int $index
+     * @param ActiveRecord|array $item
+     * @return array
+     */
+    protected function prepareRowOptions($index, $item)
+    {
+        if (is_callable($this->rowOptions)) {
+            $options =call_user_func($this->rowOptions, $item, $index, $this->context);
+        } else {
+            $options = $this->rowOptions;
+        }
+
+        Html::addCssClass($options, 'multiple-input-list__item');
+        return $options;
+    }
+
     /**
      * Renders the cell content.
      *