version 2.1.0 - autoSelectSingleOptions option added, documented, tested

Author: smarek

CHANGELOG.md

@@ -30,3 +30,7 @@
 ## 2.0.2
 
 - Added possibility to append extra CSS classes to used/generated select elements through option 'selectCssClass'
+
+## 2.1.0
+
+  Added option `autoSelectSingleOptions` to allow automatic pre-selection of option if there is only single one (works recursively)

README.md

@@ -46,6 +46,7 @@ $("#select-id").chainedSelects({
     sortByValue: false, // sort options by text value, defaults to `false`
     // IMPORTANT: if provided callback function fails, it will not report caught error if the `loggingEnabled` is not `true`
     onSelectedCallback: function(id){}, // will call user defined function with id of currently selected, or empty string if non-final option was chosen, defaults to `false`
+    autoSelectSingleOptions: true, // will automatically select single options at any level (recursively), forcing user to make a choice only when there is choice to make, defaults to `false`
 });
 ```
 

jquery.chained.selects.js

@@ -11,7 +11,8 @@
         defaultPath: false,
         sortByValue: false,
         onSelectedCallback: false,
-        selectCssClass: false
+        selectCssClass: false,
+        autoSelectSingleOptions: false
     };
 
     function ChainedSelect(element, options) {
@@ -91,7 +92,7 @@
             this.hideLevelsGreaterThan(sid, levelNum);
             let $level = this.getLevel(sid, levelNum);
             $level.empty();
-            if(this.options.placeholder) {
+            if (this.options.placeholder) {
                 $level.append(new Option(this.options.placeholder ? this.options.placeholder : "", ""));
             }
             if ($.isFunction(data)) {
@@ -141,6 +142,12 @@
                     }
                 }
             }
+            if (this.options.autoSelectSingleOptions === true) {
+                let childrenCount = $level.children().length;
+                if ((this.options.placeholder && childrenCount === 2) || (childrenCount === 1)) {
+                    $level.children().last().attr('selected', 'selected');
+                }
+            }
             $level.trigger('change');
             $level.show();
         },

package.json

@@ -1,6 +1,6 @@
 {
   "name": "jquery-chained-selects",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "jQuery plugin to create chained selects from JSON data",
   "main": "jquery.chained.selects.js",
   "scripts": {