Optionslisten

Für diverse Komponenten können Wertoptionen bereitgestellt werden. Bei Komponenten, die nur einen Wert enthalten dürfen, z. B. Text- oder Zahlkomponenten, können mit Hilfe verschiedener Renderer beispielsweise Auswahllisten oder Radio-Buttons angezeigt werden. Bei Listenkomponenten bieten sich Listboxen, Checkboxen oder Picklisten an. Durch unterschiedliche Parameterisierung dieser Renderer lassen sich zudem verschiedene Varianten der Darstellung realisieren.

Im ersten Beispiel ist die erste Komponente (single_select) eine Integer-Komponente, die eine Wochentagskonstante (java.util.Calendar) als Wert bekommen soll. Zur Unterstützung des Nutzers werden alle Wochentage mit zwei verschiedenen Renderern angeboten: Der DropDownRenderer stellt eine einfache Auswahlliste dar, während der RadioRenderer Radio-Buttons ausgibt. Der Einfachheit halber wurden hier statische Optionen mit internationalisierten Beschriftungen definiert. Als Standardwert wurde in dieser Komponente der aktuelle Wochentag gesetzt, der vom Kalkulator date-field (DateFieldCalculator) berechnet wird.

Unterhalb der Integer-Komponente befinden sich drei Multiselect-Komponenten, die die unterschiedliche Darstellung von Mehrfachauswahlkomponenten demonstrieren. Die Komponente listbox stellt die Wochentagsoptionen als einfache Listbox und in Form von Checkboxen dar. Die Komponente picklist zeigt eine Pickliste. Die verfügbaren Optionen werden auf der linken Seite dargestellt und die bereits ausgewählten auf der rechten Seite. Ein einfacher Klick auf eine Option übernimmt diese auf die jeweils andere Seite. Per CSS wurde ein Richtungspfeil eingebunden, der dem Nutzer verdeutlicht, von wo nach wo er die Optionen schieben muss, um sie zu selektieren.

Die Optionen werden in der Reihenfolge in die Komponente übernommen, wie sie ausgewählt wurden. Über den Parameter show-order-buttons am ModifySelectionRenderer können sie jedoch frei sortiert werden. Beim Überfahren der selektierten Optionen mit der Maus erscheinen selbsterklärende Sortier-Buttons neben der gerade aktiven Option.

Die Komponente picklist_popup wird ebenfalls als Pickliste dargestellt. Hierbei werden die verfügbaren Optionen allerdings in einem Popup dargestellt, welches sich beim Überfahren des Plus-Buttons öffnet. Dies wurde mit dem Attribut popup mit dem Wert "onmouseover" festgelegt. Eine weitere Besonderheit in diesem Beispiel ist, dass die selektierten Optionen in der Reihenfolge sortiert werden, wie sie in der Optionsliste angeboten wurden. Die zeitliche Reihenfolge der Auswahl spielt hier also keine Rolle. Um diese Sortierungsart festzulegen, wurde der ModiySelectionRenderer mit dem Parameter display-order und dem Wert "optionlist" ausgestattet. Optional kann alphabetisch sortiert werden.