diff --git a/_advanced_configuration.html b/_advanced_configuration.html index 68e605f09..f892ccc40 100644 --- a/_advanced_configuration.html +++ b/_advanced_configuration.html @@ -4,7 +4,7 @@ - + OliveTin documentation + + + + + +
+
+

7.7. Suggestions

+
+

Argument inputs can also have "suggested" values, which can make it quicker to type commonly used options. The way that these are displayed will vary depending on your browser, as they are implemented as a modern HTML5 browser feature called "datalist".

+
+
+

Suggestions are configured like this;

+
+
+
Configuration example of input suggestions
+
+
actions:
+  - title: Restart Docker Container
+    icon: restart
+    shell: docker restart {{ container }}
+    arguments:
+      - name: container
+        title: Container name
+        suggestions:
+          - plex:
+          - graefik:
+          - grafana:
+          - wifi-controller: WiFi Controller
+          - firewall-controller: Firewall Controller
+
+
+
+

In the examples above, there are 5 suggestions. The first 3 suggestions contain a suggestion with a blank title. The last 2 suggestions contain a human readable title (eg: wifi-controller is the suggestion, and WiFi Controller is the title).

+
+
+ + + + + +
+
Note
+
+suggestions: is a yaml map, not a list. If you leave the title empty you must still end the suggestion with a ":". +
+
+
+

7.7.1. Examples

+
+
+arg suggestions firefox +
+
Figure 4. Screenshot of input suggestions with Firefox on Linux.
+
+
+
+arg suggestions chrome +
+
Figure 5. Screenshot of input suggestions with Chrome on Linux.
+
+
+
+

7.7.2. Browser Support

+
+

datalist is widely supported now-a-days, but Firefox on Android notably lacks support; https://caniuse.com/datalist . See the upstream bug here; https://bugzilla.mozilla.org/show_bug.cgi?id=1535985 .

+
+
+
+ +
+ + + \ No newline at end of file diff --git a/args-custom-regex.html b/args-custom-regex.html index 718ddfbc0..64aaccbb7 100644 --- a/args-custom-regex.html +++ b/args-custom-regex.html @@ -4,7 +4,7 @@ - + OliveTin documentation +