|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.wicket.Component org.apache.wicket.MarkupContainer org.apache.wicket.markup.html.WebMarkupContainer org.apache.wicket.markup.html.form.LabeledWebMarkupContainer org.apache.wicket.markup.html.form.FormComponent<T> org.apache.wicket.markup.html.form.AbstractChoice<T,T> org.apache.wicket.markup.html.form.AbstractSingleSelectChoice<T> org.apache.wicket.markup.html.form.DropDownChoice<T>
T
- The model object typepublic class DropDownChoice<T>
A choice implemented as a dropdown menu/list.
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.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.apache.wicket.markup.html.form.AbstractChoice |
---|
AbstractChoice.LabelPosition |
Field Summary |
---|
Fields inherited from class org.apache.wicket.markup.html.form.FormComponent |
---|
FLAG_CONVERT_EMPTY_INPUT_STRING_TO_NULL, VALUE_SEPARATOR |
Fields inherited from class org.apache.wicket.Component |
---|
ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER |
Fields inherited from interface org.apache.wicket.markup.html.form.IOnChangeListener |
---|
INTERFACE |
Constructor Summary | |
---|---|
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. |
Method Summary | |
---|---|
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. |
Methods inherited from class org.apache.wicket.markup.html.form.AbstractSingleSelectChoice |
---|
convertChoiceIdToChoice, convertValue, getDefaultChoice, getModelValue, getNullKey, getNullKeyDisplayValue, getNullValidDisplayValue, getNullValidKey, isNullValid, isSelected, setNullValid |
Methods inherited from class org.apache.wicket.markup.html.form.AbstractChoice |
---|
appendOptionHtml, detachModel, escapeOptionHtml, getChoiceRenderer, getChoices, isDisabled, localizeDisplayValues, onComponentTagBody, setChoiceRenderer, setChoices, setChoices, setOptionAttributes, setType |
Methods inherited from class org.apache.wicket.markup.html.form.LabeledWebMarkupContainer |
---|
getLabel |
Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer |
---|
getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession |
Methods inherited from class org.apache.wicket.MarkupContainer |
---|
add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
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 DropDownChoice(String id, IModel<T> model, IModel<? extends List<? extends T>> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentmodel
- See Componentchoices
- The drop down choicesrenderer
- The rendering engineMethod Detail |
---|
public 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
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |