added ability to allow an empty list (or set min property to 0) for TabularInput

Author: Eugene Tupikov

CHANGELOG.md

@@ -3,6 +3,7 @@ Yii2 multiple input change log
 
 2.13.0
 ======
+- #152 added ability to allow an empty list (or set `min` property to 0) for TabularInput
 
 2.12.0
 ======

examples/views/tabular-input.php

@@ -20,6 +20,8 @@
 
 <?= TabularInput::widget([
     'models' => $models,
+    'modelClass' => Item::class,
+    'min' => 0,
     'attributeOptions' => [
         'enableAjaxValidation' => true,
         'enableClientValidation' => false,

src/TabularColumn.php

@@ -17,6 +17,11 @@
  */
 class TabularColumn extends BaseColumn
 {
+    /**
+     * @var TabularInput
+     */
+    public $context;
+
     /**
      * Returns element's name.
      *
@@ -63,16 +68,10 @@ protected function ensureModel($model)
      */
     public function setModel($model)
     {
-        $currentModel = $this->getModel();
-
-        // If model is null and current model is not empty it means that widget renders a template
-        // In this case we have to unset all model attributes
-        if ($model === null && $currentModel !== null) {
-            foreach ($currentModel->attributes() as $attribute) {
-                $currentModel->$attribute = null;
-            }
-        } else {
-            parent::setModel($model);
+        if ($model === null) {
+            $model = \Yii::createObject(['class' => $this->context->modelClass]);
         }
+
+        parent::setModel($model);
     }
 }

src/TabularInput.php

@@ -68,7 +68,7 @@ class TabularInput extends Widget
     /**
      * @var Model[]|ActiveRecordInterface[]
      */
-    public $models;
+    public $models = [];
 
     /**
      * @var string|array position of add button.
@@ -122,25 +122,47 @@ class TabularInput extends Widget
      */
     public $enableError = false;
 
+    /**
+     * @var string a class of model which is used to render the widget.
+     * You have to specify this property in case you set `min` property to 0 (when you want to allow an empty list)
+     * @since 2.13
+     */
+    public $modelClass;
+
     /**
      * Initialization.
      *
      * @throws \yii\base\InvalidConfigException
      */
     public function init()
     {
-        if (empty($this->models)) {
-            throw new InvalidConfigException('You must specify "models"');
+        if (empty($this->models) && !$this->modelClass) {
+            throw new InvalidConfigException('You must at least specify "models" or "modelClass"');
         }
 
         if ($this->form !== null && !$this->form instanceof ActiveForm) {
             throw new InvalidConfigException('Property "form" must be an instance of yii\widgets\ActiveForm');
         }
 
-        foreach ($this->models as $model) {
-            if (!$model instanceof Model) {
-                throw new InvalidConfigException('Model has to be an instance of yii\base\Model');
+        if (!is_array($this->models)) {
+            throw new InvalidConfigException('Property "models" must be an array');
+        }
+
+        if ($this->models) {
+            $modelClasses = [];
+            foreach ($this->models as $model) {
+                if (!$model instanceof Model) {
+                    throw new InvalidConfigException('Model has to be an instance of yii\base\Model');
+                }
+
+                $modelClasses[get_class($model)] = true;
+            }
+
+            if (count($modelClasses) > 1) {
+                throw new InvalidConfigException("You cannot use models of different classes");
             }
+
+            $this->modelClass = key($modelClasses);
         }
 
         parent::init();