T
- The model object typepublic class DropDownChoice<T> extends AbstractSingleSelectChoice<T> implements IOnChangeListener
Java:
List SITES = Arrays.asList(new String[] { "The Server Side", "Java Lobby", "Java.Net" }); // Add a dropdown choice component that uses Input's 'site' property to designate the // current selection, and that uses the SITES list for the available options. // Note that when the selection is null, Wicket will lookup a localized string to // represent this null with key: "id + '.null'". In this case, this is 'site.null' // which can be found in DropDownChoicePage.properties form.add(new DropDownChoice("site", SITES));HTML:
<select wicket:id="site"> <option>site 1</option> <option>site 2</option> </select>
You can can extend this class and override method wantOnSelectionChangedNotifications() to force server roundtrips on each selection change.
AbstractChoice.LabelPosition
FLAG_CONVERT_EMPTY_INPUT_STRING_TO_NULL, VALUE_SEPARATOR
ENABLE, FLAG_AFTER_RENDERING, FLAG_INITIALIZED, FLAG_PREPARED_FOR_RENDER, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RENDERING, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING
INTERFACE
Constructor and Description |
---|
DropDownChoice(String id)
Constructor.
|
DropDownChoice(String id,
IModel<? extends List<? extends T>> choices)
Constructor.
|
DropDownChoice(String id,
IModel<? extends List<? extends T>> choices,
IChoiceRenderer<? super T> renderer)
Constructor.
|
DropDownChoice(String id,
IModel<T> model,
IModel<? extends List<? extends T>> choices)
Constructor.
|
DropDownChoice(String id,
IModel<T> model,
IModel<? extends List<? extends T>> choices,
IChoiceRenderer<? super T> renderer)
Constructor.
|
DropDownChoice(String id,
IModel<T> model,
List<? extends T> choices)
Constructor.
|
DropDownChoice(String id,
IModel<T> model,
List<? extends T> choices,
IChoiceRenderer<? super T> renderer)
Constructor.
|
DropDownChoice(String id,
List<? extends T> choices)
Constructor.
|
DropDownChoice(String id,
List<? extends T> choices,
IChoiceRenderer<? super T> renderer)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
protected boolean |
getStatelessHint()
Returns whether the component can be stateless.
|
protected void |
onComponentTag(ComponentTag tag)
Processes the component tag.
|
void |
onSelectionChanged()
Called when a selection changes.
|
protected void |
onSelectionChanged(T newSelection)
Template method that can be overridden by clients that implement IOnChangeListener to be
notified by onChange events of a select element.
|
protected boolean |
wantOnSelectionChangedNotifications()
Whether this component's onSelectionChanged event handler should be called using javascript
window.location if the selection changes.
|
convertChoiceIdToChoice, convertValue, getDefaultChoice, getModelValue, getNullKey, getNullKeyDisplayValue, getNullValidDisplayValue, getNullValidKey, isNullValid, isSelected, setNullValid
appendOptionHtml, detachModel, escapeOptionHtml, getChoiceRenderer, getChoices, getChoicesModel, isDisabled, localizeDisplayValues, onComponentTagBody, setChoiceRenderer, setChoices, setChoices, setOptionAttributes, setType
add, add, checkRequired, clearInput, convertInput, error, getConvertedInput, getDefaultLabel, getDefaultLabel, getForm, getInput, getInputAsArray, getInputName, getModel, getModelObject, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isRequired, isValid, newValidatable, newValidationError, onDetach, onDisabled, onInvalid, onRequired, onValid, processChildren, processInput, remove, reportRequiredError, setConvertedInput, setLabel, setModel, setModelObject, setModelValue, setRequired, shouldTrimInput, trim, updateAutoLabels, updateCollectionModel, updateModel, valid, validate, validateRequired, validateValidators, visitComponentsPostOrder, visitFormComponentsPostOrder
getLabel
getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession
add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findComponentToDequeue, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onAfterRenderChildren, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren
add, addStateChange, afterRender, beforeRender, canCallListenerInterface, canCallListenerInterfaceAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, debug, detach, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalPrepareForRender, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onBeforeRender, onConfigure, onEvent, onInitialize, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap
public DropDownChoice(String id)
id
- See Componentpublic DropDownChoice(String id, List<? extends T> choices)
id
- See Componentchoices
- The collection of choices in the dropdownpublic DropDownChoice(String id, List<? extends T> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentrenderer
- The rendering enginechoices
- The collection of choices in the dropdownpublic DropDownChoice(String id, IModel<T> model, List<? extends T> choices)
id
- See Componentmodel
- See Componentchoices
- The collection of choices in the dropdownpublic DropDownChoice(String id, IModel<T> model, List<? extends T> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentmodel
- See Componentchoices
- The drop down choicesrenderer
- The rendering enginepublic DropDownChoice(String id, IModel<? extends List<? extends T>> choices)
id
- See Componentchoices
- The collection of choices in the dropdownpublic DropDownChoice(String id, IModel<T> model, IModel<? extends List<? extends T>> choices)
id
- See Componentmodel
- See Componentchoices
- The drop down choicespublic DropDownChoice(String id, IModel<? extends List<? extends T>> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentchoices
- The drop down choicesrenderer
- The rendering enginepublic final void onSelectionChanged()
onSelectionChanged
in interface IOnChangeListener
protected void onComponentTag(ComponentTag tag)
onComponentTag
in class FormComponent<T>
tag
- Tag to modifyComponent.onComponentTag(org.apache.wicket.markup.ComponentTag)
protected void onSelectionChanged(T newSelection)
Called when a option is selected of a dropdown list that wants to be notified of this event. This method is to be implemented by clients that want to be notified of selection events.
newSelection
- The newly selected object of the backing model NOTE this is the same as you would
get by calling getModelObject() if the new selection were currentprotected boolean wantOnSelectionChangedNotifications()
wantOnSelectionChangedNotifications()
return false and add an
AjaxFormComponentUpdatingBehavior
to the component using the onchange event.protected boolean getStatelessHint()
getStatelessHint
in class Component
Copyright © 2006–2016 Apache Software Foundation. All rights reserved.