org.apache.wicket.extensions.wizard
Class WizardStep

java.lang.Object
  org.apache.wicket.Component
      org.apache.wicket.MarkupContainer
          org.apache.wicket.markup.html.WebMarkupContainer
              org.apache.wicket.markup.html.WebMarkupContainerWithAssociatedMarkup
                  org.apache.wicket.markup.html.panel.Panel
                      org.apache.wicket.extensions.wizard.WizardStep

All Implemented Interfaces:

Serializable, IWizardStep, IClusterable, IConverterLocator, IHeaderPartContainerProvider

Direct Known Subclasses:

DynamicWizardStep, StaticContentStep

public class WizardStep
extends Panel
implements IWizardStep

default implementation of IWizardStep. It is also a panel, which is used as the view component.

And example of a custom step with a panel follows. Java (defined e.g. in class x.NewUserWizard):

 private final class UserNameStep extends WizardStep
 {
        public UserNameStep()
        {
                super(new ResourceModel("username.title"), new ResourceModel("username.summary"));
                add(new RequiredTextField("user.userName"));
                add(new RequiredTextField("user.email").add(EmailAddressValidator.getInstance()));
        }
 }
 

HTML (defined in e.g. file x/NewUserWizard$UserNameStep.html):

  <wicket:panel>
   <table>
    <tr>
     <td><wicket:message key="username">Username</wicket:message></td>
     <td><input type="text" wicket:id="user.userName" /></td>
    </tr>
    <tr>
     <td><wicket:message key="email">Email Address</wicket:message></td>
     <td><input type="text" wicket:id="user.email" /></td>
    </tr>
   </table>
  </wicket:panel>
 

Author:

Eelco Hillenius

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.wicket.Component

Component.ComponentModelChange, Component.EnabledChange, Component.IVisitor<T extends Component>, Component.VisibilityChange

Field Summary

Fields inherited from class org.apache.wicket.Component

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

Constructor Summary

WizardStep()
Construct without a title and a summary.

WizardStep(IModel<String> title, IModel<String> summary)
Creates a new step with the specified title and summary.

WizardStep(IModel<String> title, IModel<String> summary, IModel<?> model)
Creates a new step with the specified title and summary.

WizardStep(String title, String summary)
Creates a new step with the specified title and summary.

WizardStep(String title, String summary, IModel<?> model)
Creates a new step with the specified title and summary.

Method Summary

void	add(IFormValidator validator) Adds a form validator.
void	applyState() This method is called whenever the user presses next while this step is active.
protected void	detachModel() Detaches the model for this component if it is detachable.
Component	getHeader(String id, Component parent, IWizard wizard) Gets the header component for this step.
String	getSummary() Gets the summary of this step.
String	getTitle() Gets the title of this step.
Component	getView(String id, Component parent, IWizard wizard) Returns the current view this step is displaying.
IWizardModel	getWizardModel()
void	init(IWizardModel wizardModel) Called to initialize the step.
boolean	isComplete() Checks if this step is compete.
protected void	onBeforeRender() Workaround for adding the form validators.
protected void	onInit(IWizardModel wizardModel) Template method that is called when the step is being initialized.
void	setComplete(boolean complete) Marks this step as compete.
void	setSummaryModel(IModel<String> summary) Sets summary.
void	setTitleModel(IModel<String> title) Sets title.

Methods inherited from class org.apache.wicket.markup.html.panel.Panel

onComponentTag, onComponentTagBody, renderHead

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

newHeaderPartContainer, renderHeadFromAssociatedMarkupFile

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

getMarkupType, getWebPage, getWebRequest

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, autoAdd, contains, findMarkupStream, get, get, getAssociatedMarkupStream, getMarkupStream, hasAssociatedMarkup, internalAdd, isTransparentResolver, iterator, iterator, newMarkupResourceStream, onAfterRenderChildren, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderComponentTagBody, renderNext, replace, setDefaultModel, setMarkupStream, size, swap, toString, toString, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, callOnBeforeRenderIfNotVisible, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, configure, continueToOriginalDestination, debug, detach, detachBehaviors, detachModels, determineVisibility, error, exceptionMessage, fatal, findPage, findParent, findParentWithAssociatedMarkup, getApplication, getBehaviors, getBehaviors, getBehaviorsRawList, getClassRelativePath, getComponentBorder, getConverter, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessage, getFlag, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdImpl, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalAttach, internalDetach, internalOnAttach, internalOnDetach, internalOnModelChanged, isActionAuthorized, isAncestorOf, isAttached, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, locateMarkupStream, markAttached, markRendering, modelChanged, modelChanging, onAfterRender, onAttach, onBeginRequest, onConfigure, onDetach, onEndRequest, onInitialize, onModelChanged, onModelChanging, onRemove, prepareForRender, prepareForRender, redirectToInterceptPage, remove, remove, render, render, renderComponent, renderComponent, renderComponentTag, rendered, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, setAuto, setComponentBorder, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setFlag, setIgnoreAttributeModifier, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setRedirect, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, urlFor, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Constructor Detail

WizardStep

public WizardStep()

Construct without a title and a summary. Useful for when you provide a custom header by overiding getHeader(String, Component, IWizard).

WizardStep

public WizardStep(IModel<String> title,
                  IModel<String> summary)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

WizardStep

public WizardStep(IModel<String> title,
                  IModel<String> summary,
                  IModel<?> model)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

model - Any model which is to be used for this step

WizardStep

public WizardStep(String title,
                  String summary)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

WizardStep

public WizardStep(String title,
                  String summary,
                  IModel<?> model)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

model - Any model which is to be used for this step

Method Detail

add

public final void add(IFormValidator validator)

Adds a form validator.

Parameters:

validator -

applyState

public void applyState()

Description copied from interface: IWizardStep

This method is called whenever the user presses next while this step is active.

This method will only be called if IWizardModel.isNextAvailable() and IWizardStep.isComplete() return true.

Specified by:

applyState in interface IWizardStep

See Also:

IWizardStep.applyState()

getHeader

public Component getHeader(String id,
                           Component parent,
                           IWizard wizard)

Description copied from interface: IWizardStep

Gets the header component for this step. This component is displayed in a special section of the wizard.

Specified by:

getHeader in interface IWizardStep

Parameters:

id - The id that the component should be created with

parent - The parent component (for post 1.2)

wizard - The wizard component the header will be placed on

Returns:

The header component

See Also:

IWizardStep.getHeader(java.lang.String, org.apache.wicket.Component, org.apache.wicket.extensions.wizard.IWizard)

getSummary

public String getSummary()

Gets the summary of this step. This will be displayed in the title of the wizard while this step is active. The summary is typically an overview of the step or some usage guidelines for the user.

Returns:

the summary of this step.

getTitle

public String getTitle()

Gets the title of this step.

Returns:

the title of this step.

getView

public Component getView(String id,
                         Component parent,
                         IWizard wizard)

Description copied from interface: IWizardStep

Returns the current view this step is displaying. This component will be displayed in the main section of the wizard with this step is active. This may changed at any time by as long as an appropriate property change event is fired.

Specified by:

getView in interface IWizardStep

Parameters:

id - The id that the component should be created with

parent - The parent component (for post 1.2)

wizard - The wizard component the header will be placed on

Returns:

The current view of the step.

See Also:

IWizardStep.getView(java.lang.String, org.apache.wicket.Component, org.apache.wicket.extensions.wizard.IWizard)

init

public final void init(IWizardModel wizardModel)

Called to initialize the step. When this method is called depends on the kind of wizard model that is used. The static wizard model knows all the steps upfront and initializes themm when starting up. This method will be called when the wizard is initializing. The dynamic wizard model initializes steps every time they are encountered. This method sets the wizard model and then calls template method onInit(IWizardModel)

Specified by:

init in interface IWizardStep

Parameters:

wizardModel - the model to which the step belongs.

isComplete

public boolean isComplete()

Checks if this step is compete. This method should return true if the wizard can proceed to the next step. This property is bound and changes can be made at anytime by calling setComplete(boolean) .

Specified by:

isComplete in interface IWizardStep

Returns:

true if the wizard can proceed from this step, false otherwise.

See Also:

setComplete(boolean)

setComplete

public void setComplete(boolean complete)

Marks this step as compete. The wizard will not be able to proceed from this step until this property is configured to true.

Parameters:

complete - true to allow the wizard to proceed, false otherwise.

See Also:

isComplete()

setSummaryModel

public void setSummaryModel(IModel<String> summary)

Sets summary.

Parameters:

summary - summary

setTitleModel

public void setTitleModel(IModel<String> title)

Sets title.

Parameters:

title - title

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()

onBeforeRender

protected void onBeforeRender()

Workaround for adding the form validators.

Overrides:

onBeforeRender in class Component

See Also:

Component.onBeforeRender()

onInit

protected void onInit(IWizardModel wizardModel)

Template method that is called when the step is being initialized.

Parameters:

wizardModel -

See Also:

init(IWizardModel)

getWizardModel

public IWizardModel getWizardModel()

Returns:

wizard model