T
- The model object typepublic class ListMultipleChoice<T> extends AbstractChoice<Collection<T>,T>
AbstractChoice.LabelPosition
FLAG_CONVERT_EMPTY_INPUT_STRING_TO_NULL, VALUE_SEPARATOR
ENABLE, FLAG_INITIALIZED, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING
Constructor and Description |
---|
ListMultipleChoice(String id) |
ListMultipleChoice(String id,
IModel<? extends Collection<T>> model,
IModel<? extends List<? extends T>> choices) |
ListMultipleChoice(String id,
IModel<? extends Collection<T>> model,
IModel<? extends List<? extends T>> choices,
IChoiceRenderer<? super T> renderer) |
ListMultipleChoice(String id,
IModel<? extends Collection<T>> object,
List<? extends T> choices) |
ListMultipleChoice(String id,
IModel<? extends Collection<T>> object,
List<? extends T> choices,
IChoiceRenderer<? super T> renderer) |
ListMultipleChoice(String id,
IModel<? extends List<? extends T>> choices) |
ListMultipleChoice(String id,
IModel<? extends List<? extends T>> choices,
IChoiceRenderer<? super T> renderer) |
ListMultipleChoice(String id,
List<? extends T> choices) |
ListMultipleChoice(String id,
List<? extends T> choices,
IChoiceRenderer<? super T> renderer) |
ListMultipleChoice(String id,
List<? extends T> choices,
int maxRows)
Creates a multiple choice list with a maximum number of visible rows.
|
Modifier and Type | Method and Description |
---|---|
protected List<T> |
convertChoiceIdsToChoices(String[] ids)
Converts submitted choice ids to choice objects.
|
protected Collection<T> |
convertValue(String[] ids)
Subclasses should overwrite this if the conversion is not done through the type field and the
IConverter . |
String |
getModelValue() |
boolean |
isRetainDisabledSelected()
If true, choices that were selected in the model but disabled in rendering will be retained
in the model after a form submit.
|
protected boolean |
isSelected(T choice,
int index,
String selected)
Gets whether the given value represents the current selection.
|
protected void |
onComponentTag(ComponentTag tag)
Processes the component tag.
|
ListMultipleChoice<T> |
setMaxRows(int maxRows)
Sets the number of visible rows in the listbox.
|
ListMultipleChoice<T> |
setRetainDisabledSelected(boolean retain) |
void |
updateModel()
See
FormComponent.updateCollectionModel(FormComponent) for details on how the model
is updated. |
appendOptionHtml, detachModel, escapeOptionHtml, getChoiceRenderer, getChoices, getChoicesModel, getDefaultChoice, isDisabled, localizeDisplayValues, onComponentTagBody, onDetach, setChoiceRenderer, setChoices, setChoices, setOptionAttributes, setType
add, add, checkRequired, clearInput, convertInput, error, getConvertedInput, getDefaultLabel, getDefaultLabel, getForm, getInput, getInputAsArray, getInputName, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isRequired, isValid, newValidatable, newValidationError, onDisabled, onInvalid, onRequired, onValid, processChildren, processInput, remove, reportRequiredError, setConvertedInput, setLabel, setModelValue, setRequired, shouldTrimInput, trim, updateAutoLabels, updateCollectionModel, valid, validate, validateRequired, validateValidators, visitComponentsPostOrder, visitFormComponentsPostOrder
getLabel
getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession
add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onInitialize, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, stream, streamChildren, toString, toString, visitChildren, visitChildren
add, addStateChange, beforeRender, canCallListener, canCallListenerAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, 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, 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, renderHead, 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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getDefaultModel, getDefaultModelObject, getModel, getModelObject, setDefaultModel, setDefaultModelObject, setModel, setModelObject
forEach, spliterator
public ListMultipleChoice(String id)
AbstractChoice.AbstractChoice(String)
public ListMultipleChoice(String id, List<? extends T> choices, int maxRows)
id
- component idchoices
- list of choicesmaxRows
- the maximum number of visible rows.AbstractChoice.AbstractChoice(String, List)
public ListMultipleChoice(String id, List<? extends T> choices, IChoiceRenderer<? super T> renderer)
public ListMultipleChoice(String id, IModel<? extends Collection<T>> object, List<? extends T> choices)
id
- object
- choices
- AbstractChoice.AbstractChoice(String, IModel, List)
public ListMultipleChoice(String id, IModel<? extends Collection<T>> object, List<? extends T> choices, IChoiceRenderer<? super T> renderer)
id
- object
- choices
- renderer
- AbstractChoice.AbstractChoice(String, IModel,
List,IChoiceRenderer)
public ListMultipleChoice(String id, IModel<? extends List<? extends T>> choices)
public ListMultipleChoice(String id, IModel<? extends Collection<T>> model, IModel<? extends List<? extends T>> choices)
id
- model
- choices
- AbstractChoice.AbstractChoice(String, IModel,IModel)
public ListMultipleChoice(String id, IModel<? extends List<? extends T>> choices, IChoiceRenderer<? super T> renderer)
public ListMultipleChoice(String id, IModel<? extends Collection<T>> model, IModel<? extends List<? extends T>> choices, IChoiceRenderer<? super T> renderer)
id
- model
- choices
- renderer
- AbstractChoice.AbstractChoice(String, IModel,
IModel,IChoiceRenderer)
public final ListMultipleChoice<T> setMaxRows(int maxRows)
maxRows
- the number of visible rowspublic final String getModelValue()
getModelValue
in class FormComponent<Collection<T>>
FormComponent.getModelValue()
protected final boolean isSelected(T choice, int index, String selected)
AbstractChoice
isSelected
in class AbstractChoice<Collection<T>,T>
choice
- The object to checkindex
- The index in the choices collection this object is in.selected
- The currently selected string valueAbstractChoice.isSelected(Object,int, String)
protected void onComponentTag(ComponentTag tag)
FormComponent
onComponentTag
in class FormComponent<Collection<T>>
tag
- Tag to modifyComponent.onComponentTag(ComponentTag)
protected Collection<T> convertValue(String[] ids) throws org.apache.wicket.util.convert.ConversionException
FormComponent
IConverter
. WARNING: this method may be removed in future versions.
If conversion fails then a ConversionException should be thrownconvertValue
in class FormComponent<Collection<T>>
ids
- The value can be the getInput() or through a cookieorg.apache.wicket.util.convert.ConversionException
- If input can't be convertedFormComponent.convertValue(String[])
protected List<T> convertChoiceIdsToChoices(String[] ids)
ids
- choice ids. this array is nonnull and always contains at least one id.public void updateModel()
FormComponent.updateCollectionModel(FormComponent)
for details on how the model
is updated.updateModel
in interface IFormModelUpdateListener
updateModel
in class FormComponent<Collection<T>>
public boolean isRetainDisabledSelected()
AbstractChoice.isDisabled(Object, int, String)
).
That means that four checkboxes are rendered, checkboxes 2 and 4 are checked, but 2 and 3 are
not clickable. User checks 1 and unchecks 4. If this flag is off, the model will be updated
to [1]. This is because the browser does not re-submit a disabled checked checkbox: it only
submits [1]. Therefore Wicket will only see the [1] and update the model accordingly. If you
set this flag to true, Wicket will check the model before updating to find choices that were
selected but disabled. These choices will then be retained, leading to a new model value of
[1, 2] as (probably) expected by the user. Note that this will lead to additional calls to
AbstractChoice.isDisabled(Object, int, String)
.public ListMultipleChoice<T> setRetainDisabledSelected(boolean retain)
retain
- flagisRetainDisabledSelected()
Copyright © 2006–2018 Apache Software Foundation. All rights reserved.