org.apache.wicket.ajax.markup.html.form

Class AjaxFallbackButton

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<String>

org.apache.wicket.markup.html.form.Button

org.apache.wicket.ajax.markup.html.form.AjaxFallbackButton

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IConverterLocator, IGenericComponent<String>, IFormModelUpdateListener, IFormSubmitter, IFormSubmittingComponent, IFormVisitorParticipant, ILabelProvider<String>, IHeaderContributor, IRequestableComponent, IHierarchical<Component>, IClusterable

public abstract class AjaxFallbackButton
extends Button

An ajax submit button that will degrade to a normal request if ajax is not available or javascript is disabled.

Since:

1.3

Author:

Jeremy Thomerson (jthomerson), Alastair Maw

See Also:

Serialized Form

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_AFTER_RENDERING, FLAG_INITIALIZED, FLAG_PREPARED_FOR_RENDER, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RENDERING, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING

Constructor Summary

Constructors

Constructor and Description
AjaxFallbackButton(String id, Form<?> form) Construct.
AjaxFallbackButton(String id, IModel<String> model, Form<?> form) Construct.

Method Summary

Methods

Modifier and Type	Method and Description
Form<?>	getForm() Override to not throw exception if there is no parent form.
protected boolean	isButtonEnabled() Helper methods that both checks whether the link is enabled and whether the action ENABLE is allowed.
protected AjaxFormSubmitBehavior	newAjaxEventBehavior(Form<?> form, String event)
void	onAfterSubmit() Override this method to provide special submit handling in a multi-button form.
protected void	onAfterSubmit(AjaxRequestTarget target, Form<?> form) Callback for the onClick event.
protected void	onComponentTag(ComponentTag tag) Processes the component tag.
void	onError() Method that is invoked when form processing fails; for example, when there are validation errors.
protected void	onError(AjaxRequestTarget target, Form<?> form) Listener method invoked on form submit with errors.
void	onSubmit() Override this method to provide special submit handling in a multi-button form.
protected void	onSubmit(AjaxRequestTarget target, Form<?> form) Callback for the onClick event.
protected void	updateAjaxAttributes(AjaxRequestAttributes attributes)

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

getDefaultFormProcessing, getOnClickScript, initModel, onComponentTagBody, setDefaultFormProcessing, updateModel

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

add, add, checkRequired, clearInput, convertInput, convertValue, error, getConvertedInput, getDefaultLabel, getDefaultLabel, getInput, getInputAsArray, getInputName, getModel, getModelObject, getModelValue, getParameterValues, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isRequired, isValid, newValidatable, newValidationError, onDetach, onDisabled, onInvalid, onRequired, onValid, processChildren, processInput, remove, reportRequiredError, setConvertedInput, setLabel, setModel, setModelObject, setModelValue, setRequired, setType, shouldTrimInput, trim, updateAutoLabels, updateCollectionModel, valid, validate, validateRequired, validateValidators, visitComponentsPostOrder, visitFormComponentsPostOrder

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, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onAfterRenderChildren, onInitialize, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, canCallListenerInterface, canCallListenerInterfaceAfterExpiry, 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, internalPrepareForRender, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onBeforeRender, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, 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 org.apache.wicket.markup.html.form.IFormSubmittingComponent

getInputName

Constructor Detail

AjaxFallbackButton

public AjaxFallbackButton(String id,
                  Form<?> form)

Construct.

Parameters:

id -

form -

AjaxFallbackButton

public AjaxFallbackButton(String id,
                  IModel<String> model,
                  Form<?> form)

Construct.

Parameters:

id -

model -

form -

Method Detail

newAjaxEventBehavior

protected AjaxFormSubmitBehavior newAjaxEventBehavior(Form<?> form,
                                          String event)

updateAjaxAttributes

protected void updateAjaxAttributes(AjaxRequestAttributes attributes)

onError

protected void onError(AjaxRequestTarget target,
           Form<?> form)

Listener method invoked on form submit with errors. If ajax failed and this event was generated via a normal submission, the target argument will be null.

Parameters:

target -

form -

onError

public final void onError()

Description copied from interface: IFormSubmitter

Method that is invoked when form processing fails; for example, when there are validation errors.

Specified by:

onError in interface IFormSubmitter

Overrides:

onError in class Button

onSubmit

public final void onSubmit()

Description copied from class: Button

Override this method to provide special submit handling in a multi-button form. It is called whenever the user clicks this particular button, except if validation fails. This method will be called before Form.onSubmit().

Specified by:

onSubmit in interface IFormSubmitter

Overrides:

onSubmit in class Button

See Also:

IFormSubmitter.onSubmit()

onAfterSubmit

public final void onAfterSubmit()

Description copied from class: Button

Override this method to provide special submit handling in a multi-button form. It is called whenever the user clicks this particular button, except if validation fails. This method will be called after Form.onSubmit().

Specified by:

onAfterSubmit in interface IFormSubmitter

Overrides:

onAfterSubmit in class Button

See Also:

IFormSubmitter.onAfterSubmit()

getForm

public Form<?> getForm()

Description copied from class: Button

Override to not throw exception if there is no parent form.

Specified by:

getForm in interface IFormSubmitter

Overrides:

getForm in class Button

Returns:

the parent form or null

See Also:

Button.getForm()

onSubmit

protected void onSubmit(AjaxRequestTarget target,
            Form<?> form)

Callback for the onClick event. If ajax failed and this event was generated via a normal submission, the target argument will be null. This method will be called before Form.onSubmit().

Parameters:

target - ajax target if this linked was invoked using ajax, null otherwise

form -

onAfterSubmit

protected void onAfterSubmit(AjaxRequestTarget target,
                 Form<?> form)

Callback for the onClick event. If ajax failed and this event was generated via a normal submission, the target argument will be null. This method will be called after Form.onSubmit().

Parameters:

target - ajax target if this linked was invoked using ajax, null otherwise

form -

isButtonEnabled

protected final boolean isButtonEnabled()

Helper methods that both checks whether the link is enabled and whether the action ENABLE is allowed.

Returns:

whether the link should be rendered as enabled

onComponentTag

protected void onComponentTag(ComponentTag tag)

Description copied from class: Button

Processes the component tag. A value attribute is added with the value of the model object, if available. An onclick attribute is added if the subclass specified javascript.

NOTE. For a <button> the value attribute is not rendered, markup needs to be added within the button to display the button's label.

Overrides:

onComponentTag in class Button

Parameters:

tag - Tag to modify

See Also:

Component.onComponentTag(ComponentTag)