Suggestor

Wie aus vielen Anwendungen und Websites bekannt, bietet auch die FormEngine die Möglichkeit, Vorschläge für die Eingabe während des Tippens anzuzeigen. Der sogenannte Suggestor liefert anhand der aktuellen Texteingabe Optionen, die in das Textfeld übernommen werden können.

Dazu kann ein TextRenderer, ein AddTextRenderer oder ein EditableOutputRenderer mit einem Parameter namens suggestor ausgestattet werden, mit welchem eine Ableitung von de.imatics.forms.type.TextSuggestor als Vorschlagsgenerator angegeben wird. Auch eigene Renderer können Suggestor unterstützen, indem sie das Interface SuggestorRenderer implementieren.

Die FormEngine bringt bereits zwei Implementierungen mit: den OptionListSuggestor und den TreePathSuggestor. Der erste arbeitet auf Basis einer Optionsliste, die für die Komponente definiert ist. Er filtert die Optionen heraus, deren Wert mit dem aktuellen Eingabetext beginnt. Werden dabei keine passenden Optionen gefunden, wird eine Teil-String-Suche durchgeführt und deren Ergebnisse als Vorschläge präsentiert.

Der TreePathSuggestor hingegen nutzt den Optionsbaum einer Komponente als Quelle für die Vorschläge.

Im Beispiel unten wird die Eingabe eines Landesnamens (in englischer Sprache) verlangt. Eine Liste möglicher Länder wurden hier als statische Optionen im Formular definiert. Die Groß-/Kleinschreibung spielt keine Rolle.