Package lumis.doui.control.itempicker

Class ItemPickerControl

  • All Implemented Interfaces:
    java.util.Observer, javax.servlet.jsp.el.VariableResolver, IControl, IDataBoundControl, IDataControl, IRenderer
    public class ItemPickerControl
extends DataBoundControl
    Used to select an item from a large list.
    This control contains three significant properties. The id of the field that it represents, the id of that field that represents a user friendly name for the field that it represents and finally an interface that is responsible for searching and selecting the item.
    The control renders a readonly user friendly name with a selection and clear icon beside it. When the user selects the selection icon the specified search interface is popped passing the javascript function name that should be called to update the identifier and friendly name of this control.

    Example use: <control:lum_itemPicker id="userId" displayDataId="userName"> <searchInterfaceId>lumis.service.sample.selectusingsearch.selectUser</searchInterfaceId> </control:lum_itemPicker>
    xml data available for xsl rendering: <control dataId="userId" displayDataId="userName" id="userId.userId" sourceId="default" type="lum_itemPicker"> <searchInterfaceId>lumis.service.sample.selectusingsearch.selectUser</searchInterfaceId> <control id="8A488A0F158A409701158A42522F0095" type="lum_requiredValueValidator"/> <data> <item> <id>00000000D00000000000000000000004</id> <displayString>LumisPageCacheUser</displayString> </item> <openPopupScript><!-- javascript for opening a pop to select an item --></openPopupScript> <selectItemFunction><!-- javascript function that is called by the pop to set the id and display name of the item selected --></selectItemFunction> <clearItemScript><!-- javascript to clear the id and name selected --></clearItemScript> </data> </control>
    Since:
    4.1.0
    Version:
    $Revision$ $Date$