|
||||||||||
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.RadioChoice<T>
T
- The model object typepublic class RadioChoice<T>
A choice subclass that shows choices in radio style.
Java:
List SITES = Arrays.asList(new String[] { "The Server Side", "Java Lobby", "Java.Net" }); // Add a radio choice component that uses Input's 'site' property to designate the // current selection, and that uses the SITES list for the available options. form.add(new RadioChoice("site", SITES));HTML:
<span valign="top" wicket:id="site"> <input type="radio">site 1</input> <input type="radio">site 2</input> </span>
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 | |
---|---|
RadioChoice(String id)
Constructor |
|
RadioChoice(String id,
IModel<? extends List<? extends T>> choices)
Constructor |
|
RadioChoice(String id,
IModel<? extends List<? extends T>> choices,
IChoiceRenderer<? super T> renderer)
Constructor |
|
RadioChoice(String id,
IModel<T> model,
IModel<? extends List<? extends T>> choices)
Constructor |
|
RadioChoice(String id,
IModel<T> model,
IModel<? extends List<? extends T>> choices,
IChoiceRenderer<? super T> renderer)
Constructor |
|
RadioChoice(String id,
IModel<T> model,
List<? extends T> choices)
Constructor |
|
RadioChoice(String id,
IModel<T> model,
List<? extends T> choices,
IChoiceRenderer<? super T> renderer)
Constructor |
|
RadioChoice(String id,
List<? extends T> choices)
Constructor |
|
RadioChoice(String id,
List<? extends T> choices,
IChoiceRenderer<? super T> renderer)
Constructor |
Method Summary | |
---|---|
protected void |
appendOptionHtml(AppendingStringBuffer buffer,
T choice,
int index,
String selected)
Generates and appends html for a single choice into the provided buffer |
protected IValueMap |
getAdditionalAttributes(int index,
T choice)
You may subclass this method to provide additional attributes to the <input ..> tag. |
protected IValueMap |
getAdditionalAttributesForLabel(int index,
T choice)
You may subclass this method to provide additional attributes to the <label ..> tag. |
String |
getPrefix()
|
protected String |
getPrefix(int index,
T choice)
|
protected boolean |
getStatelessHint()
Returns whether the component can be stateless. |
String |
getSuffix()
|
protected String |
getSuffix(int index,
T choice)
|
protected void |
onComponentTag(ComponentTag tag)
Processes the component tag. |
void |
onComponentTagBody(MarkupStream markupStream,
ComponentTag openTag)
Handle the container's body. |
void |
onSelectionChanged()
Called when a new option is selected. |
protected void |
onSelectionChanged(Object newSelection)
Template method that can be overridden by clients that implement IOnChangeListener to be notified by onChange events of a select element. |
RadioChoice<T> |
setLabelPosition(AbstractChoice.LabelPosition labelPosition)
Sets the preferred position of the <label> for each choice |
RadioChoice<T> |
setPrefix(String prefix)
|
RadioChoice<T> |
setSuffix(String suffix)
|
protected boolean |
wantOnSelectionChangedNotifications()
Whether this component's onSelectionChanged event handler should called using javascript 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 |
---|
detachModel, escapeOptionHtml, getChoiceRenderer, getChoices, isDisabled, localizeDisplayValues, 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 RadioChoice(String id)
id
- See ComponentComponent.Component(String)
,
AbstractChoice.AbstractChoice(String)
public RadioChoice(String id, List<? extends T> choices)
id
- See Componentchoices
- The list of choices in the radio choiceComponent.Component(String)
,
AbstractChoice.AbstractChoice(String, List)
public RadioChoice(String id, List<? extends T> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentrenderer
- The rendering enginechoices
- The list of choices in the radio choiceComponent.Component(String)
,
AbstractChoice.AbstractChoice(String,
List,IChoiceRenderer)
public RadioChoice(String id, IModel<T> model, List<? extends T> choices)
id
- See Componentmodel
- See Componentchoices
- The list of choices in the radio choiceComponent.Component(String, IModel)
,
AbstractChoice.AbstractChoice(String, IModel, List)
public RadioChoice(String id, IModel<T> model, List<? extends T> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentmodel
- See Componentchoices
- The list of choices in the radio choicerenderer
- The rendering engineComponent.Component(String, IModel)
,
AbstractChoice.AbstractChoice(String, IModel,
List,IChoiceRenderer)
public RadioChoice(String id, IModel<? extends List<? extends T>> choices)
id
- See Componentchoices
- The list of choices in the radio choiceComponent.Component(String)
,
AbstractChoice.AbstractChoice(String, IModel)
public RadioChoice(String id, IModel<T> model, IModel<? extends List<? extends T>> choices)
id
- See Componentmodel
- The model that is updated with changes in this component. See Componentchoices
- The list of choices in the radio choiceAbstractChoice.AbstractChoice(String, IModel,IModel)
,
Component.Component(String, IModel)
public RadioChoice(String id, IModel<? extends List<? extends T>> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentchoices
- The list of choices in the radio choicerenderer
- The rendering engineAbstractChoice.AbstractChoice(String,
IModel,IChoiceRenderer)
,
Component.Component(String)
public RadioChoice(String id, IModel<T> model, IModel<? extends List<? extends T>> choices, IChoiceRenderer<? super T> renderer)
id
- See Componentmodel
- The model that is updated with changes in this component. See Componentchoices
- The list of choices in the radio choicerenderer
- The rendering engineComponent.Component(String, IModel)
,
AbstractChoice.AbstractChoice(String, IModel,
IModel,IChoiceRenderer)
Method Detail |
---|
protected void onComponentTag(ComponentTag tag)
FormComponent
onComponentTag
in class FormComponent<T>
tag
- Tag to modifyFormComponent.onComponentTag(org.apache.wicket.markup.ComponentTag)
public void onSelectionChanged()
IOnChangeListener
onSelectionChanged
in interface IOnChangeListener
IOnChangeListener.onSelectionChanged()
protected void onSelectionChanged(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()
protected boolean getStatelessHint()
Component
getStatelessHint
in class Component
Component.getStatelessHint()
public String getPrefix()
protected String getPrefix(int index, T choice)
index
- index of the choicechoice
- the choice itself
getPrefix()
. Override to have a prefix dependent on the choice item.protected String getSuffix(int index, T choice)
index
- index of the choicechoice
- the choice itself
getSuffix()
. Override to have a prefix dependent on the choice item.public final RadioChoice<T> setPrefix(String prefix)
prefix
- Prefix to use before choice
public String getSuffix()
public final RadioChoice<T> setSuffix(String suffix)
suffix
- Separator to use between radio options
public RadioChoice<T> setLabelPosition(AbstractChoice.LabelPosition labelPosition)
labelPosition
- The preferred position for the label
this
instance, for chainingpublic final void onComponentTagBody(MarkupStream markupStream, ComponentTag openTag)
AbstractChoice
onComponentTagBody
in class AbstractChoice<T,T>
markupStream
- The markup streamopenTag
- The open tag for the bodyComponent.onComponentTagBody(MarkupStream, ComponentTag)
protected void appendOptionHtml(AppendingStringBuffer buffer, T choice, int index, String selected)
appendOptionHtml
in class AbstractChoice<T,T>
buffer
- Appending string buffer that will have the generated html appendedchoice
- Choice objectindex
- The index of this optionselected
- The currently selected string valueprotected IValueMap getAdditionalAttributesForLabel(int index, T choice)
index
- index of the choicechoice
- the choice itself
protected IValueMap getAdditionalAttributes(int index, T choice)
index
- index of the choicechoice
- the choice itself
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |