Added allowEmptyList option

Author: Eugene Tupikov

README.md

@@ -47,6 +47,7 @@ Widget support the following options that are additionally recognized over and a
 - `removeButtonOptions` *array*: the HTML options for `add` button. Can contains `class` and `label` keys
 - `data` *array*: array of values in case you use widget without model
 - `models` *array*: the list of models. Required in case you use `TabularInput` widget
+- `allowEmptyList` *boolean*: whether to allow the empty list
 - `columns` *array*: the row columns configuration where you can set the following properties:
   - `name` *string*: input name. *Required options*
   - `type` *string*: type of the input. If not set will default to `textInput`. Read more about the types described below

examples/views/multiple-input.php

@@ -33,6 +33,7 @@
 <?= $form->field($model, 'schedule')->widget(MultipleInput::className(), [
     'id' => 'schedule-wrapper',
     'limit' => 4,
+    'allowEmptyList' => true,
     'columns' => [
         [
             'name'  => 'user_id',

src/MultipleInput.php

@@ -54,6 +54,11 @@ class MultipleInput extends InputWidget
      */
     public $addButtonOptions;
 
+    /**
+     * @var bool whether to allow the empty list
+     */
+    public $allowEmptyList = false;
+
 
     /**
      * Initialization.
@@ -115,6 +120,7 @@ private function createRenderer()
             'attributeOptions'  => $this->attributeOptions,
             'data'              => $this->data,
             'columnClass'       => MultipleInputColumn::className(),
+            'allowEmptyList'    => $this->allowEmptyList,
             'context'           => $this
         ];
 

src/TabularInput.php

@@ -48,6 +48,11 @@ class TabularInput extends Widget
      */
     public $addButtonOptions;
 
+    /**
+     * @var bool whether to allow the empty list
+     */
+    public $allowEmptyList = false;
+
     /**
      * @var Model[]|ActiveRecord[]
      */
@@ -94,6 +99,7 @@ private function createRenderer()
             'attributeOptions'  => $this->attributeOptions,
             'data'              => $this->models,
             'columnClass'       => TabularColumn::className(),
+            'allowEmptyList'    => $this->allowEmptyList,
             'context'           => $this
         ];
 

src/assets/src/css/multiple-input.css

@@ -34,7 +34,7 @@ table.multiple-input-list tr > th {
     display: block;
     font-size: 13px;
 }
-.multiple-input-list__item .list-cell__button {
+.multiple-input-list .list-cell__button {
     width: 40px;
 }
 .multiple-input-list__item .radio,

src/components/BaseRenderer.php

@@ -64,11 +64,17 @@ abstract class BaseRenderer extends Object
      */
     public $addButtonOptions;
 
+    /**
+     * @var bool whether to allow the empty list
+     */
+    public $allowEmptyList = false;
+
     /**
      * @var string
      */
     public $columnClass;
 
+
     /**
      * @var TabularInput|MultipleInput
      */

src/renderers/TableRenderer.php

@@ -56,7 +56,8 @@ public function renderHeader()
             $cells[] = $this->renderHeaderCell($column);
         }
         if (is_null($this->limit) || $this->limit > 1) {
-            $cells[] = Html::tag('th', '', [
+            $button = $this->allowEmptyList ? $this->renderAddButton() : '';
+            $cells[] = Html::tag('th', $button, [
                 'class' => 'list-cell__button'
             ]);
         }
@@ -204,8 +205,10 @@ private function renderActionColumn($index = null)
     {
         if (is_null($index)) {
             $button = $this->renderRemoveButton();
+        } elseif ($index == 0) {
+            $button = $this->allowEmptyList ? $this->renderRemoveButton() : $this->renderAddButton();
         } else {
-            $button = $index == 0 ? $this->renderAddButton() : $this->renderRemoveButton();
+            $button = $this->renderRemoveButton();
         }
 
         return Html::tag('td', $button, [