wicket.markup.html.form
Class CheckBoxMultipleChoice

java.lang.Object
  wicket.Component
      wicket.MarkupContainer
          wicket.markup.html.WebMarkupContainer
              wicket.markup.html.form.FormComponent
                  wicket.markup.html.form.ListMultipleChoice
                      wicket.markup.html.form.CheckBoxMultipleChoice

All Implemented Interfaces:

java.io.Serializable

public class CheckBoxMultipleChoice
extends ListMultipleChoice

A choice subclass that shows choices via checkboxes.

Java:

 List SITES = Arrays.asList(new String[] { "The Server Side", "Java Lobby", "Java.Net" });
 // Add a set of checkboxes uses Input's 'site' property to designate the
 // current selections, and that uses the SITES list for the available options.
 form.add(new CheckBoxMultipleChoice("site", SITES));
 

HTML:

    <span valign="top" wicket:id="site">
        <input type="checkbox">site 1</input>
        <input type="checkbox">site 2</input>
    </span>
 

Author:

Jonathan Locke, Johan Compagner, Martijn Dashorst, Gwyn Evans, Igor Vaynberg (ivaynberg)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class wicket.markup.html.form.FormComponent

FormComponent.IVisitor

Nested classes/interfaces inherited from class wicket.Component

Component.ComponentModelChange, Component.EnabledChange, Component.VisibilityChange

Field Summary

Fields inherited from class wicket.markup.html.form.FormComponent

FLAG_CONVERT_EMPTY_INPUT_STRING_TO_NULL, VALUE_SEPARATOR

Fields inherited from class wicket.Component

ENABLE, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED6, FLAG_RESERVED7, FLAG_RESERVED8, PATH_SEPARATOR, RENDER

Constructor Summary

CheckBoxMultipleChoice(java.lang.String id)
Constructor

CheckBoxMultipleChoice(java.lang.String id, IModel choices)
Constructor

CheckBoxMultipleChoice(java.lang.String id, IModel choices, IChoiceRenderer renderer)
Constructor

CheckBoxMultipleChoice(java.lang.String id, IModel model, IModel choices)
Constructor

CheckBoxMultipleChoice(java.lang.String id, IModel model, IModel choices, IChoiceRenderer renderer)
Constructor

CheckBoxMultipleChoice(java.lang.String id, IModel model, java.util.List choices)
Constructor

CheckBoxMultipleChoice(java.lang.String id, IModel model, java.util.List choices, IChoiceRenderer renderer)
Constructor

CheckBoxMultipleChoice(java.lang.String id, java.util.List choices)
Constructor

CheckBoxMultipleChoice(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) Generats and appends html for a single choice into the provided buffer
protected void	detachModel() Detaches the model for this component if it is detachable.
IChoiceRenderer	getChoiceRenderer()
java.util.List	getChoices()
protected java.lang.CharSequence	getDefaultChoice(java.lang.Object selected)
java.lang.String	getPrefix()
java.lang.String	getSuffix()
protected boolean	localizeDisplayValues() Override this method if you want to localize the display values of the generated options.
protected void	onComponentTagBody(MarkupStream markupStream, ComponentTag openTag) Handle the container's body.
void	setChoiceRenderer(IChoiceRenderer renderer) Set the choice renderer to be used.
void	setChoices(IModel choices) Sets the list of choices
void	setChoices(java.util.List choices) Sets the list of choices.
CheckBoxMultipleChoice	setPrefix(java.lang.String prefix)
CheckBoxMultipleChoice	setSuffix(java.lang.String suffix)
protected boolean	supportsPersistence()

Methods inherited from class wicket.markup.html.form.ListMultipleChoice

convertValue, getDefaultMaxRows, getModelValue, isSelected, onComponentTag, setDefaultMaxRows, setMaxRows, updateModel

Methods inherited from class wicket.markup.html.form.FormComponent

add, checkRequired, clearInput, convert, error, getConvertedInput, getForm, getInput, getInputAsArray, getInputName, getLabel, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputAsStringArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isPersistent, isRequired, isValid, isValidated, onDetach, onDisabled, onInvalid, onValid, processInput, setLabel, setModelValue, setModelValue, setPersistent, setRequired, setType, valid, validate, validateRequired, validateValidators

Methods inherited from class wicket.markup.html.WebMarkupContainer

getMarkupType, getWebPage

Methods inherited from class wicket.MarkupContainer

add, autoAdd, contains, findMarkupStream, get, getAssociatedMarkupStream, getMarkupStream, internalAdd, internalAttach, internalDetach, isTransparentResolver, iterator, iterator, newMarkupResourceStream, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderComponentTagBody, replace, setMarkupStream, setModel, size, toString, toString, visitChildren, visitChildren

Methods inherited from class wicket.Component

add, addStateChange, checkComponentTag, checkComponentTagAttribute, continueToOriginalDestination, debug, detachBehaviors, detachModels, error, exceptionMessage, fatal, findPage, findParent, findParentWithAssociatedMarkup, getApplication, getApplicationPages, getApplicationSettings, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getEscapeModelStrings, getFeedbackMessage, getFlag, getFlag, getId, getLocale, getLocalizer, getMarkupAttributes, getMarkupId, getMetaData, getModel, getModelComparator, getModelObject, getModelObjectAsString, getOutputMarkupId, getPage, getPageFactory, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getResponse, getSession, getSizeInBytes, getString, getString, getString, getStyle, getVariation, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnAttach, internalOnDetach, isActionAuthorized, isAncestorOf, isBehaviorAccepted, isEnableAllowed, isEnabled, isHeadRendered, isIgnoreAttributeModifier, isRenderAllowed, isVersioned, isVisible, isVisibleInHierarchy, modelChanged, modelChanging, newPage, newPage, onAfterRender, onAttach, onBeforeRender, onBeginRequest, onEndRequest, onModelChanged, onModelChanging, onRender, redirectToInterceptPage, remove, render, render, renderComponent, renderComponent, renderComponentTag, rendered, renderedBehaviors, renderHead, replaceComponentTagBody, replaceWith, resetHeadRendered, sameRootModel, sameRootModel, setAuto, setEnabled, setEscapeModelStrings, setFlag, setFlag, setIgnoreAttributeModifier, setMetaData, setModelObject, setOutputMarkupId, setRedirect, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisible, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, warn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id)

Constructor

Parameters:

id - See Component

See Also:

Component.Component(String), AbstractChoice#AbstractChoice(String)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              java.util.List choices)

Constructor

Parameters:

id - See Component

choices - The collection of choices in the radio choice

See Also:

Component.Component(String), AbstractChoice#AbstractChoice(String, java.util.List)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              java.util.List choices,
                              IChoiceRenderer renderer)

Constructor

Parameters:

id - See Component

renderer - The rendering engine

choices - The collection of choices in the radio choice

See Also:

Component.Component(String), AbstractChoice#AbstractChoice(String, java.util.List,wicket.markup.html.form.IChoiceRenderer)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              IModel model,
                              java.util.List choices)

Constructor

Parameters:

id - See Component

model - See Component

choices - The collection of choices in the radio choice

See Also:

Component.Component(String, wicket.model.IModel), AbstractChoice#AbstractChoice(String, wicket.model.IModel, java.util.List)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              IModel model,
                              java.util.List choices,
                              IChoiceRenderer renderer)

Constructor

Parameters:

id - See Component

model - See Component

choices - The collection of choices in the radio choice

renderer - The rendering engine

See Also:

Component.Component(String, wicket.model.IModel), AbstractChoice#AbstractChoice(String, wicket.model.IModel, java.util.List,wicket.markup.html.form.IChoiceRenderer)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              IModel choices)

Constructor

Parameters:

id - See Component

choices - The collection of choices in the radio choice

See Also:

Component.Component(String), AbstractChoice#AbstractChoice(String, wicket.model.IModel)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              IModel model,
                              IModel choices)

Constructor

Parameters:

id - See Component

model - The model that is updated with changes in this component. See Component

choices - The collection of choices in the radio choice

See Also:

AbstractChoice#AbstractChoice(String, wicket.model.IModel,wicket.model.IModel), Component.Component(String, wicket.model.IModel)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              IModel choices,
                              IChoiceRenderer renderer)

Constructor

Parameters:

id - See Component

choices - The collection of choices in the radio choice

renderer - The rendering engine

See Also:

AbstractChoice#AbstractChoice(String, wicket.model.IModel,wicket.markup.html.form.IChoiceRenderer), Component.Component(String)

CheckBoxMultipleChoice

public CheckBoxMultipleChoice(java.lang.String id,
                              IModel model,
                              IModel choices,
                              IChoiceRenderer renderer)

Constructor

Parameters:

id - See Component

model - The model that is updated with changes in this component. See Component

choices - The collection of choices in the radio choice

renderer - The rendering engine

See Also:

Component.Component(String, wicket.model.IModel), AbstractChoice#AbstractChoice(String, wicket.model.IModel, wicket.model.IModel,wicket.markup.html.form.IChoiceRenderer)

Method Detail

getPrefix

public java.lang.String getPrefix()

Returns:

Prefix to use before choice

setPrefix

public final CheckBoxMultipleChoice setPrefix(java.lang.String prefix)

Parameters:

prefix - Prefix to use before choice

Returns:

this

getSuffix

public java.lang.String getSuffix()

Returns:

Separator to use between radio options

setSuffix

public final CheckBoxMultipleChoice setSuffix(java.lang.String suffix)

Parameters:

suffix - Separator to use between radio options

Returns:

this

onComponentTagBody

protected final void onComponentTagBody(MarkupStream markupStream,
                                        ComponentTag openTag)

Handle the container's body.

Parameters:

markupStream - The markup stream

openTag - The open tag for the body

See Also:

Component.onComponentTagBody(wicket.markup.MarkupStream, wicket.markup.ComponentTag)

getChoices

public java.util.List getChoices()

Returns:

The collection of object that this choice has

setChoices

public final void setChoices(IModel choices)

Sets the list of choices

Parameters:

choices - model representing the list of choices

setChoices

public final void setChoices(java.util.List choices)

Sets the list of choices.

Parameters:

choices - the list of choices

getChoiceRenderer

public final IChoiceRenderer getChoiceRenderer()

Returns:

The IChoiceRenderer used for rendering the data objects

setChoiceRenderer

public final void setChoiceRenderer(IChoiceRenderer renderer)

Set the choice renderer to be used.

Parameters:

renderer -

detachModel

protected void detachModel()

Description copied from class: Component

Detaches the model for this component if it is detachable.

Overrides:

detachModel in class Component

See Also:

Component.detachModel()

getDefaultChoice

protected java.lang.CharSequence getDefaultChoice(java.lang.Object selected)

Parameters:

selected - The object that's currently selected

Returns:

Any default choice, such as "Choose One", depending on the subclass

appendOptionHtml

protected void appendOptionHtml(AppendingStringBuffer buffer,
                                java.lang.Object choice,
                                int index,
                                java.lang.String selected)

Generats and appends html for a single choice into the provided buffer

Parameters:

buffer - Appending string buffer that will have the generated html appended

choice - Choice object

index - The index of this option

selected - The currently selected string value

supportsPersistence

protected boolean supportsPersistence()

Overrides:

supportsPersistence in class FormComponent

Returns:

True if this type of FormComponent can be persisted.

See Also:

FormComponent.supportsPersistence()

localizeDisplayValues

protected boolean localizeDisplayValues()

Override this method if you want to localize the display values of the generated options. By default false is returned so that the display values of options are not tested if they have a i18n key.

Returns:

true If you want to localize the display values, default == false