Final docs on list types.

WhazzItToYa · WhazzItToYa · commit 10300ed2abab · 2025-08-12T18:40:31.000-07:00
diff --git a/README.md b/README.md
@@ -94,6 +94,11 @@ You specify the editable options of your extension in a JSON document. This docu
                         ["value314159", "pi"] // Third dropdown, Displays "pi" to user, but the stored value is "value314159"
                        ],
 
+            // For "list"
+            
+            "style" : "csv" // comma-separated list (optional, default)
+            "style" : "textblock" // mutli-line text, one item per line.
+            
             // For "file" (a file picker)
 
             "accept" : "image/*,video/*,.webp", // The extensions or mime types to filter by
@@ -151,7 +156,7 @@ Example JSON:
             "name" : "sampleSelect",
             "type" : "select",
             "label" : "Sample Selection",
-            "description" : "A list of simple values, or values and their labels",
+            "description" : "A selector among simple values, or values with custom labels",
             "values" : [
                 "Value1", "Value2", ["Value3", "Value3's Label"]
             ],
@@ -170,14 +175,31 @@ Example JSON:
             "label" : "Sample Block",
             "description" : "A multiline text block"
         },
+        {
+            "name" : "sampleCSVList",
+            "type" : "list",
+            "style" : "csv",
+            "label" : "Sample CSV List",
+            "description" : "A list of simple strings, separated by commas",
+            "default" : ["one", "two", "three"]
+        },
+        {
+            "name" : "sampleBlockList",
+            "type" : "list",
+            "style" : "textblock",
+            "shape" : "list",
+            "label" : "Sample Multiline List",
+            "description" : "A list of simple strings, one per line",
+            "default" : ["one", "two", "three"]
+        },
         {
             "name" : "sampleFile",
             "type" : "file",
             "label" : "Sample File",
             "description" : "A chooser for file paths, with optional type filter",
             "accept" : "image/*"
         },
-
+        
         {
             "name" : "sampleBooleanDependency",
             "type" : "boolean",
@@ -247,6 +269,12 @@ The expression can have the usual simple operators:
 
 The simplest, and probably most useful expression, is simply the name of another simple boolean option: When it is checked, the option shows, and is hidden when the option is unchecked.
 
+### Lists
+
+Lists/Arrays of strings are currently supported with the "**list**" option type. It comes in two flavors:
+* `style: "csv"` : List items separated by commas (with any surrounding spaces removed)
+* `style: "textblock"` : List items are one per line.
+
 ### Option Groups
 
 You can create a group of options with an option of `"type" : "group"`. The `"name"` is optional.
diff --git a/config.js b/config.js
@@ -808,15 +808,15 @@ class ListOption extends OptionUI
     constructor(name, options) {
         super(name, options);
 
-        const style = options.style ?? "csv";
+        const style = (options.style ?? "csv").toLowerCase();
         
         // Delegate the actual UI to a text widget, and we'll
         // wrap it to convert the string to/from a list.
         if (style === "csv") {
             this.#uiWidget = new TextOption(name, options);
             this.#separator = ", ";
             this.#splitter = (str) => str.split(/\s*,\s*/);
-        } else if (style === "block") {
+        } else if (style === "textblock") {
             this.#uiWidget = new TextBlockOption(name, options);
             // Splits at line breaks, but ignores final blank lines.
             this.#splitter = (str) => str.split(/\r?\n/).filter((line, i, arr) => !(i === arr.length - 1 && line === ''));
diff --git a/sample.json b/sample.json
@@ -71,21 +71,12 @@
         {
             "name" : "sampleBlockList",
             "type" : "list",
-            "style" : "block",
+            "style" : "textblock",
             "shape" : "list",
             "label" : "Sample Multiline List",
             "description" : "A list of simple strings, one per line",
             "default" : ["one", "two", "three"]
         },
-        {
-            "name" : "sampleVarList",
-            "type" : "list",
-            "style" : "block",
-            "shape" : "indexedvars",
-            "label" : "Sample Multiline List",
-            "description" : "A list of simple strings, one per line, and stored in separate variables",
-            "default" : ["one", "two", "three"]
-        },
         {
             "name" : "sampleFile",
             "type" : "file",
