_QLInput
Shows an input field that, when the user types some text and presses Enter, executes some QL and can show the result --
Function
The same Type -> _QLInput
(label, ql, target, append, replace, noIcon, noDiv, updateSectionAfter) -> Value has not been set
- Receives -- The same Type
- The value that will be passed to the QL.
- label
- The text to display, greyed-out, in the input, to prompt the user.
- ql
- The QL to execute when the user presses Enter.
- target (optional)
- The id of a div or span to put the results into; if it
is not given, the results will be displayed below the input.
- append (optional)
- If set to true, entering something else runs
the QL again, and appends the result to the target div. Otherwise, pressing Enter again
closes the div.
- replace (optional)
- If set to true, pressing Enter again re-runs
the QL with the new value of the input field, and replaces the previous result in the target div.
- noIcon (optional)
- Not currently used in _QLInput.
- noDiv (optional)
- Normally, Querki displays the result of the QL expression
in a div. If
noDiv is set to True, the results will be added with nothing around them.
- updateSectionAfter (optional)
- If this is contained within an
_updateableSection,
and you set updateSectionAfter to true, that enclosing section will be redisplayed after this is clicked.
- Produces
- The input field, ready for the page
This function is unusual, in that it is a way to do something only if the user enters some text.
It displays an input with the given placeholder; if the user clicks that, it evaluates the given ql
(using the received Thing as its context).
The entered input text is available in the QL expression as $input.
