Add default value support for select dropdowns

Author: Bradie Tilley

classes/HtmlGenerator.php

@@ -516,17 +516,19 @@ public function resolveTypeRadio(Form $form, Field $field)
      */
     public function resolveTypeSelect(Form $form, Field $field)
     {
-        $el = new HtmlSelect([
-        ]);
+        $el = new HtmlSelect([]);
 
         $el->set($this->resolveTypeGlobal($form, $field));
+        $defaultValue = $field->default_value;
 
-        $el->addChild(new HtmlOption([
-            'value' => '',
-            'selected' => true,
-            'disabled' => $field->required,
-            'node' => $field->placeholder,
-        ]));
+        if (($field->placeholder !== null) && ($defaultValue === null)) {
+            $el->addChild(new HtmlOption([
+                'value' => '',
+                'selected' => true, // Selected by default
+                'disabled' => $field->required, // If the field is required, you cannot select the placeholder
+                'node' => $field->placeholder,
+            ]));
+        }
 
         foreach ($field->getOptions() as $option) {
             if ($option->is_optgroup) {
@@ -536,6 +538,7 @@ public function resolveTypeSelect(Form $form, Field $field)
 
                 foreach ($option->options as $option) {
                     $optgroup->addChild(new HtmlOption([
+                        'selected' => ($defaultValue !== null) ? ($option->option_code === $defaultValue) : false,
                         'value' => $option->option_code,
                         'node' => $option->option_label,
                     ]));
@@ -547,6 +550,7 @@ public function resolveTypeSelect(Form $form, Field $field)
             }
 
             $el->addChild(new HtmlOption([
+                'selected' => ($defaultValue !== null) ? ($option->option_code === $defaultValue) : false,
                 'value' => $option->option_code,
                 'node' => $option->option_label,
             ]));

models/Field.php

@@ -1,4 +1,6 @@
-<?php namespace ABWebDevelopers\Forms\Models;
+<?php
+
+namespace ABWebDevelopers\Forms\Models;
 
 use Model;
 use October\Rain\Database\Traits\Sortable;
@@ -41,6 +43,7 @@ class Field extends Model
         'group_class',
         'label_class',
         'options',
+        'default',
     ];
 
     /**
@@ -236,7 +239,7 @@ public function getOptionKeys(): array
      * @param string $key
      * @return string|null The option label
      */
-    public function getOption(string $key):  ? string
+    public function getOption(string $key): ?string
     {
         foreach ($this->options as $option) {
             if ($option['is_optgroup'] ?? false) {
@@ -254,4 +257,28 @@ public function getOption(string $key):  ? string
 
         return null;
     }
+
+    /**
+     * Get the placeholder for this field
+     *
+     * @return mixed
+     */
+    public function getPlaceholderAttribute()
+    {
+        return (isset($this->attributes['placeholder']) && ($this->attributes['placeholder'] !== ''))
+            ? $this->attributes['placeholder']
+            : null;
+    }
+
+    /**
+     * Get the default value for this field
+     *
+     * @return mixed
+     */
+    public function getDefaultValueAttribute()
+    {
+        return (isset($this->attributes['default']) && ($this->attributes['default'] !== ''))
+            ? $this->attributes['default']
+            : null;
+    }
 }

updates/version.yaml

@@ -50,4 +50,6 @@
 1.4.0:
     - 'Added new plain text field type for adding general HTML to forms'
 1.5.0:
-    - '** Remove foreign key constraints from historic migrations **'
+    - '** Remove foreign key constraints from historic migrations **'
+1.5.1:
+    - 'Add default value support for select dropdowns'