|
||||||||||
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 org.apache.wicket.markup.html.form.AbstractSingleSelectChoice org.apache.wicket.markup.html.form.DropDownChoice
public class DropDownChoice
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.FormComponent |
---|
FormComponent.AbstractVisitor, FormComponent.IVisitor |
Nested classes/interfaces inherited from class org.apache.wicket.Component |
---|
Component.ComponentModelChange, Component.EnabledChange, Component.VisibilityChange |
Field Summary |
---|
Fields inherited from class org.apache.wicket.markup.html.form.AbstractSingleSelectChoice |
---|
NO_SELECTION_VALUE |
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_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED6, FLAG_RESERVED7, FLAG_RESERVED8, PATH_SEPARATOR, RENDER |
Fields inherited from interface org.apache.wicket.markup.html.form.IOnChangeListener |
---|
INTERFACE |
Constructor Summary | |
---|---|
DropDownChoice(java.lang.String id)
|
|
DropDownChoice(java.lang.String id,
IModel choices)
|
|
DropDownChoice(java.lang.String id,
IModel choices,
IChoiceRenderer renderer)
|
|
DropDownChoice(java.lang.String id,
IModel model,
IModel choices)
|
|
DropDownChoice(java.lang.String id,
IModel model,
IModel choices,
IChoiceRenderer renderer)
|
|
DropDownChoice(java.lang.String id,
IModel model,
java.util.List choices)
|
|
DropDownChoice(java.lang.String id,
IModel model,
java.util.List data,
IChoiceRenderer renderer)
|
|
DropDownChoice(java.lang.String id,
java.util.List choices)
|
|
DropDownChoice(java.lang.String id,
java.util.List data,
IChoiceRenderer renderer)
|
Method Summary | |
---|---|
protected void |
appendOptionHtml(AppendingStringBuffer buffer,
java.lang.Object choice,
int index,
java.lang.String selected)
Generates and appends html for a single choice into the provided buffer |
protected void |
detachModel()
Detaches the model for this component if it is detachable. |
protected java.lang.CharSequence |
escapeOptionHtml(java.lang.String displayValue)
Method to override if you want special escaping of the options html. |
IChoiceRenderer |
getChoiceRenderer()
|
java.util.List |
getChoices()
|
protected boolean |
getStatelessHint()
Returns whether the component can be stateless. |
protected boolean |
isDisabled(java.lang.Object object,
int index,
java.lang.String selected)
Gets whether the given value is disabled. |
protected boolean |
localizeDisplayValues()
Override this method if you want to localize the display values of the generated options. |
protected void |
onComponentTag(ComponentTag tag)
Processes the component tag. |
protected void |
onComponentTagBody(MarkupStream markupStream,
ComponentTag openTag)
Handle the container's body. |
void |
onSelectionChanged()
Called when a selection changes. |
protected void |
onSelectionChanged(java.lang.Object newSelection)
Template method that can be overridden by clients that implement IOnChangeListener to be notified by onChange events of a select element. |
org.apache.wicket.markup.html.form.AbstractChoice |
setChoiceRenderer(IChoiceRenderer renderer)
Set the choice renderer to be used. |
org.apache.wicket.markup.html.form.AbstractChoice |
setChoices(IModel choices)
Sets the list of choices |
org.apache.wicket.markup.html.form.AbstractChoice |
setChoices(java.util.List choices)
Sets the list of choices. |
protected boolean |
supportsPersistence()
|
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, isNullValid, isSelected, setNullValid |
Methods inherited from class org.apache.wicket.markup.html.form.FormComponent |
---|
add, checkRequired, clearInput, convertInput, error, getBehaviors, getConvertedInput, getForm, getInput, getInputAsArray, getInputName, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isPersistent, isRequired, isValid, onDetach, onDisabled, onInvalid, onValid, processChildren, processInput, setConvertedInput, setLabel, setModelValue, setModelValue, setPersistent, setRequired, setType, shouldTrimInput, trim, updateModel, valid, validate, validateRequired, validateValidators, visitFormComponentsPostOrder |
Methods inherited from class org.apache.wicket.markup.html.form.LabeledWebMarkupContainer |
---|
getLabel, setLabelInternal |
Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer |
---|
getMarkupType, getWebPage |
Methods inherited from class org.apache.wicket.MarkupContainer |
---|
add, addOrReplace, autoAdd, autoAdd, contains, findMarkupStream, get, getAssociatedMarkupStream, getMarkupStream, hasAssociatedMarkup, internalAdd, isTransparentResolver, iterator, iterator, newMarkupResourceStream, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderComponentTagBody, replace, setMarkupStream, setModel, size, toString, toString, visitChildren, visitChildren |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public DropDownChoice(java.lang.String id)
AbstractChoice.AbstractChoice(String)
public DropDownChoice(java.lang.String id, java.util.List choices)
AbstractChoice.AbstractChoice(String, List)
public DropDownChoice(java.lang.String id, java.util.List data, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String,
List,IChoiceRenderer)
public DropDownChoice(java.lang.String id, IModel model, java.util.List choices)
AbstractChoice.AbstractChoice(String, IModel, List)
public DropDownChoice(java.lang.String id, IModel model, java.util.List data, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String, IModel, List,
IChoiceRenderer)
public DropDownChoice(java.lang.String id, IModel choices)
AbstractChoice.AbstractChoice(String, IModel)
public DropDownChoice(java.lang.String id, IModel model, IModel choices)
AbstractChoice.AbstractChoice(String, IModel,IModel)
public DropDownChoice(java.lang.String id, IModel choices, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String,
IModel,IChoiceRenderer)
public DropDownChoice(java.lang.String id, IModel model, IModel choices, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String, IModel,
IModel,IChoiceRenderer)
Method Detail |
---|
public final void onSelectionChanged()
onSelectionChanged
in interface IOnChangeListener
protected void onComponentTag(ComponentTag tag)
onComponentTag
in class FormComponent
tag
- Tag to modifyComponent.onComponentTag(org.apache.wicket.markup.ComponentTag)
protected void onSelectionChanged(java.lang.Object 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()
Component
getStatelessHint
in class Component
Component.getStatelessHint()
public java.util.List getChoices()
public final org.apache.wicket.markup.html.form.AbstractChoice setChoices(IModel choices)
choices
- model representing the list of choices
public final org.apache.wicket.markup.html.form.AbstractChoice setChoices(java.util.List choices)
choices
- the list of choices
public final IChoiceRenderer getChoiceRenderer()
public final org.apache.wicket.markup.html.form.AbstractChoice setChoiceRenderer(IChoiceRenderer renderer)
renderer
-
protected void detachModel()
Component
detachModel
in class Component
Component.detachModel()
protected boolean isDisabled(java.lang.Object object, int index, java.lang.String selected)
object
- The object to checkindex
- The index in the choices collection this object is in.selected
- The currently selected string value
protected void onComponentTagBody(MarkupStream markupStream, ComponentTag openTag)
onComponentTagBody
in class MarkupContainer
markupStream
- The markup streamopenTag
- The open tag for the bodyComponent.onComponentTagBody(MarkupStream, ComponentTag)
protected void appendOptionHtml(AppendingStringBuffer buffer, java.lang.Object choice, int index, java.lang.String selected)
buffer
- Appending string buffer that will have the generated html appendedchoice
- Choice objectindex
- The index of this optionselected
- The currently selected string valueprotected java.lang.CharSequence escapeOptionHtml(java.lang.String displayValue)
displayValue
-
protected boolean supportsPersistence()
supportsPersistence
in class FormComponent
FormComponent.supportsPersistence()
protected boolean localizeDisplayValues()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |