2020-07-13 16:42:55 +00:00
title: keyboard-driven-input Macro
tags: Macros [[Core Macros]]
2020-12-07 14:44:07 +00:00
The <<.def keyboard-driven-input>> [[macro|Macros]] generates an input field or textarea that lets you cycle through a given list of entries with the <kbd><<displayshortcuts ((input-up))>></kbd> and <kbd><<displayshortcuts ((input-down))>></kbd> keys. Doing so, an entry gets selected and can be processed with further actions
2020-07-13 16:42:55 +00:00
!! Parameters
To create the input field or textarea, the <<.def keyboard-driven-input>> [[macro|Macros]] accepts all parameters of the EditTextWidget
The additional parameters are:
2020-10-27 17:33:06 +00:00
|parameter |purpose |h
2020-07-13 16:42:55 +00:00
|storeTitle |the title of the tiddler that stores the user input |
2020-07-31 11:54:06 +00:00
|selectionStateTitle |the title of the tiddler that stores the selected entry with a -primaryList or -secondaryList suffix to make it unique |
2020-12-07 14:44:07 +00:00
|inputAcceptActions |the actions that get processed when the user hits <kbd><<displayshortcuts ((input-accept))>></kbd> |
|inputAcceptVariantActions |the actions that get processed when the user hits <kbd><<displayshortcuts ((input-accept-variant))>></kbd> |
|inputCancelActions |the actions that get processed when the user hits <kbd><<displayshortcuts ((input-cancel))>></kbd> |
2020-10-27 17:33:06 +00:00
|configTiddlerFilter |a ''filter'' that specifies the tiddler that stores the first item-filter in its <<.field first-search-filter>> field and the second item-filter in its <<.field second-search-filter>> field |
2020-11-02 19:04:25 +00:00
|firstSearchFilterField |the field of the configTiddler where the first search-filter is stored. Defaults to <<.field first-search-filter>> |
|secondSearchFilterField |the field of the configTiddler where the second search-filter is stored. Defaults to <<.field second-search-filter>> |
|filterMinLength |the minimum length of the user input after which items are filtered |
2020-07-13 16:42:55 +00:00
2021-05-21 09:02:35 +00:00
See [[Demonstration: keyboard-driven-input Macro]] for further guidance on using this macro.
