Refs #10145: QFQ fills data-typeahead-initial-suggestion

Documentation/Manual.rst

@@ -3227,6 +3227,8 @@ See also at specific *FormElement* definitions.
 |                        |        | (defaults to 00:00:00 if none entered).                                                                  |
 +------------------------+--------+----------------------------------------------------------------------------------------------------------+
 | typeAheadLimit,        | string | See `input-typeahead`_                                                                                   |
+| typeAheadInitial       |        |                                                                                                          |
+| Suggestion,            |        |                                                                                                          |
 | typeAheadMinLength,    |        |                                                                                                          |
 | typeAheadSql,          |        |                                                                                                          |
 | typeAheadSqlPrefetch,  |        |                                                                                                          |
@@ -3540,7 +3542,7 @@ configured).
 Configuration via Form / FormElement
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-All of the `typeAhead*` (except `typeAheadLdap`) and `ldap*` parameter can be specified either in
+All of the `typeAhead*` (except `typeAheadLdap`, `typeAheadInitialSuggestion`) and `ldap*` parameter can be specified either in
 *Form.parameter* or in *FormElement.parameter*.
 SQL
@@ -3548,7 +3550,7 @@ SQL
 * *FormElement.parameter*:
-  * *typeAheadSql* = `SELECT ... AS 'id', ... AS 'value' FROM ... WHERE name LIKE ? OR firstName LIKE ? LIMIT 100`
+  * *typeAheadSql* = ``SELECT ... AS 'id', ... AS 'value' FROM ... WHERE name LIKE ? OR firstName LIKE ? LIMIT 100``
     * If there is only one column in the SELECT statement, that one will be used and there is no dict (key/value pair).
     * If there is no column `id` or no column `value`, then the first column becomes `id` and the second column becomes `value`.
@@ -3556,11 +3558,17 @@ SQL
     * The value, typed by the user, will be replaced on all places where a `?` appears.
     * All `?` will be automatically surrounded by '%'. Therefore wildcard search is implemented: `... LIKE '%<?>%' ...`
-  * *typeAheadSqlPrefetch* = `SELECT firstName, ' ', lastName FROM Person WHERE id = ?`
+  * *typeAheadSqlPrefetch* = ``SELECT firstName, ' ', lastName FROM Person WHERE id = ?``
     * If the query returns several results, only the first one is returned and displayed.
     * If the query selects multiple columns, the columns are concatenated.
+  * *typeAheadInitialSuggestion* = ``{{!SELECT fr.id AS id, fr.name AS value FROM Fruit AS fr}}``
+
+    * Shows suggestions when the input element gets the focus, before the user starts to type anything.
+    * If given, *typeAheadMinLength* will be set to 0.
+    * Limit the number of rows via SQL ``... LIMIT ...`` clause.
+
 LDAP
 ;;;;