|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.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.RadioChoice
public class RadioChoice
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.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 | |
---|---|
RadioChoice(java.lang.String id)
Constructor |
|
RadioChoice(java.lang.String id,
IModel choices)
Constructor |
|
RadioChoice(java.lang.String id,
IModel choices,
IChoiceRenderer renderer)
Constructor |
|
RadioChoice(java.lang.String id,
IModel model,
IModel choices)
Constructor |
|
RadioChoice(java.lang.String id,
IModel model,
IModel choices,
IChoiceRenderer renderer)
Constructor |
|
RadioChoice(java.lang.String id,
IModel model,
java.util.List choices)
Constructor |
|
RadioChoice(java.lang.String id,
IModel model,
java.util.List choices,
IChoiceRenderer renderer)
Constructor |
|
RadioChoice(java.lang.String id,
java.util.List choices)
Constructor |
|
RadioChoice(java.lang.String id,
java.util.List choices,
IChoiceRenderer renderer)
Constructor |
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()
|
java.lang.String |
getPrefix()
|
protected boolean |
getStatelessHint()
Returns whether the component can be stateless. |
java.lang.String |
getSuffix()
|
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 new option is selected. |
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. |
RadioChoice |
setPrefix(java.lang.String prefix)
|
RadioChoice |
setSuffix(java.lang.String suffix)
|
protected boolean |
supportsPersistence()
|
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, 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 RadioChoice(java.lang.String id)
id
- See ComponentComponent.Component(String)
,
AbstractChoice.AbstractChoice(String)
public RadioChoice(java.lang.String id, java.util.List choices)
id
- See Componentchoices
- The collection of choices in the radio choiceComponent.Component(String)
,
AbstractChoice.AbstractChoice(String, List)
public RadioChoice(java.lang.String id, java.util.List choices, IChoiceRenderer renderer)
id
- See Componentrenderer
- The rendering enginechoices
- The collection of choices in the radio choiceComponent.Component(String)
,
AbstractChoice.AbstractChoice(String,
List,IChoiceRenderer)
public RadioChoice(java.lang.String id, IModel model, java.util.List choices)
id
- See Componentmodel
- See Componentchoices
- The collection of choices in the radio choiceComponent.Component(String, IModel)
,
AbstractChoice.AbstractChoice(String, IModel, List)
public RadioChoice(java.lang.String id, IModel model, java.util.List choices, IChoiceRenderer renderer)
id
- See Componentmodel
- See Componentchoices
- The collection of choices in the radio choicerenderer
- The rendering engineComponent.Component(String, IModel)
,
AbstractChoice.AbstractChoice(String, IModel,
List,IChoiceRenderer)
public RadioChoice(java.lang.String id, IModel choices)
id
- See Componentchoices
- The collection of choices in the radio choiceComponent.Component(String)
,
AbstractChoice.AbstractChoice(String, IModel)
public RadioChoice(java.lang.String id, IModel model, IModel choices)
id
- See Componentmodel
- The model that is updated with changes in this component. See Componentchoices
- The collection of choices in the radio choiceAbstractChoice.AbstractChoice(String, IModel,IModel)
,
Component.Component(String, IModel)
public RadioChoice(java.lang.String id, IModel choices, IChoiceRenderer renderer)
id
- See Componentchoices
- The collection of choices in the radio choicerenderer
- The rendering engineAbstractChoice.AbstractChoice(String,
IModel,IChoiceRenderer)
,
Component.Component(String)
public RadioChoice(java.lang.String id, IModel model, IModel choices, IChoiceRenderer renderer)
id
- See Componentmodel
- The model that is updated with changes in this component. See Componentchoices
- The collection 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
tag
- Tag to modifyFormComponent.onComponentTag(org.apache.wicket.markup.ComponentTag)
public void onSelectionChanged()
IOnChangeListener
onSelectionChanged
in interface IOnChangeListener
IOnChangeListener.onSelectionChanged()
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()
protected boolean getStatelessHint()
Component
getStatelessHint
in class Component
Component.getStatelessHint()
public java.lang.String getPrefix()
public final RadioChoice setPrefix(java.lang.String prefix)
prefix
- Prefix to use before choice
public java.lang.String getSuffix()
public final RadioChoice setSuffix(java.lang.String suffix)
suffix
- Separator to use between radio options
protected final void onComponentTagBody(MarkupStream markupStream, ComponentTag openTag)
markupStream
- The markup streamopenTag
- The open tag for the bodyComponent.onComponentTagBody(MarkupStream, ComponentTag)
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 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 |