Package org.apache.wicket.markup.html.form

Class CheckBoxSelector

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.AbstractCheckSelector

org.apache.wicket.markup.html.form.CheckBoxSelector

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable<Component>, IEventSink, IEventSource, IFeedbackContributor, IConverterLocator, IMetadataContext<java.io.Serializable,Component>, ILabelProvider<java.lang.String>, IHeaderContributor, IRequestableComponent, org.apache.wicket.util.IHierarchical<Component>, org.apache.wicket.util.io.IClusterable

public class CheckBoxSelector
extends AbstractCheckSelector

A Javascript-based "Select All" checkbox component that works with a loose collection of CheckBox components. By default, clicking on any of the controlled checkboxes automatically updates the state of the "select all" checkbox. Override AbstractCheckSelector.wantAutomaticUpdate() to change this.

Author:

Carl-Eric Menzel

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING

Constructor Summary

Constructors

Constructor	Description
CheckBoxSelector(java.lang.String id)
CheckBoxSelector(java.lang.String id, CheckBox... boxes)

Method Summary

Modifier and Type	Method	Description
static java.lang.Iterable<CheckBox>	collectCheckBoxes(WebMarkupContainer container)	Utility method to collect all CheckBoxes inside a container.
protected java.lang.Iterable<? extends CheckBox>	getCheckBoxes()	Override this method to control a dynamic collection of CheckBoxes.
protected java.lang.CharSequence	getFindCheckboxesFunction()	Concrete subclasses must override this to provide a Javascript function that returns the IDs of all checkboxes that should be controlled by this selector.

Methods inherited from class org.apache.wicket.markup.html.form.AbstractCheckSelector

onComponentTag, renderHead, wantAutomaticUpdate

Methods inherited from class org.apache.wicket.markup.html.form.LabeledWebMarkupContainer

getLabel, onDetach, setLabel

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onComponentTagBody, onInitialize, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, stream, streamChildren, toString, toString, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, beforeRender, canCallListener, canCallListenerAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isInitialized, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onBeforeRender, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderPart, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlForListener, urlForListener, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

CheckBoxSelector

public CheckBoxSelector(java.lang.String id)

Parameters:

id - The component ID

See Also:

getCheckBoxes()

CheckBoxSelector

public CheckBoxSelector(java.lang.String id,
                        CheckBox... boxes)

Parameters:

id - The component ID

boxes - checkBoxes this selector will control

Method Detail

getFindCheckboxesFunction

protected java.lang.CharSequence getFindCheckboxesFunction()

Description copied from class: AbstractCheckSelector

Concrete subclasses must override this to provide a Javascript function that returns the IDs of all checkboxes that should be controlled by this selector.

Specified by:

getFindCheckboxesFunction in class AbstractCheckSelector

Returns:

a String containing a Javascript expression that evaluates to a function(!). This function must return an array containing the IDs of all checkbox input elements that this selector should control.

getCheckBoxes

protected java.lang.Iterable<? extends CheckBox> getCheckBoxes()

Override this method to control a dynamic collection of CheckBoxes.

Returns:

by default returns the checkBoxes passed to the constructor

collectCheckBoxes

public static final java.lang.Iterable<CheckBox> collectCheckBoxes(WebMarkupContainer container)

Utility method to collect all CheckBoxes inside a container.

Parameters:

container - container with checkBoxes

Returns:

all contained checkBoxes