org.apache.wicket.extensions.breadcrumb.panel
Class BreadCrumbPanel

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.breadcrumb.panel.BreadCrumbPanel

All Implemented Interfaces:

Serializable, IBreadCrumbParticipant, IClusterable, IConverterLocator, IHeaderPartContainerProvider

Direct Known Subclasses:

FirstPanel, FourthPanel, ResultPanel, SecondPanel, ThirdPanel

public abstract class BreadCrumbPanel
extends Panel
implements IBreadCrumbParticipant

A panel that participates with a bread crumb model. The idea is that you would have a dialog-like component that is much like a wizard, but more decoupled. A typical setup is that you have a panel, where the content is dynamic but hierarchical in nature, and that there are links on the panel that take you deeper into the hierarchy

An example of using bread crumb panels and bread crumb links:

 add(new BreadCrumbLink("myLink", breadCrumbModel)
 {
        protected IBreadCrumbParticipant getParticipant(String componentId)
        {
                return new MyPanel(componentId, breadCrumbModel);
        }
 });
 

where MyPanel is a bread crumb panel and the link is added to another bread crumb panel instance (this). When clicked, MyPanel will replace the panel that the link is placed on, and it will set (and add) MyPanel as the active bread crumb in the bread crumb component model.

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

BreadCrumbPanel(String id, IBreadCrumbModel breadCrumbModel)
Construct.

BreadCrumbPanel(String id, IBreadCrumbModel breadCrumbModel, IModel<?> model)
Construct.

Method Summary

void	activate(IBreadCrumbPanelFactory breadCrumbPanelFactory) Activates the bread crumb panel that is the result of calling the create method of the bread crumb panel factory.
void	activate(IBreadCrumbParticipant participant) Activates the provided participant, which typically has the effect of replacing this current panel with the one provided - as the participant typically would be a bread crumb panel - and updating the bread crumb model of this panel, pushing the bread crumb for the given participant on top.
IBreadCrumbModel	getBreadCrumbModel() Gets the bread crumb panel.
Component	getComponent() The participating component == this.
void	onActivate(IBreadCrumbParticipant previous) Called when the corresponding bread crumb is activated.
void	setBreadCrumbModel(IBreadCrumbModel breadCrumbModel) Sets the bread crumb panel.

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, detachModel, 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, onBeforeRender, 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

Methods inherited from interface org.apache.wicket.extensions.breadcrumb.IBreadCrumbParticipant

getTitle

Constructor Detail

BreadCrumbPanel

public BreadCrumbPanel(String id,
                       IBreadCrumbModel breadCrumbModel)

Construct.

Parameters:

id - Component id

breadCrumbModel - The bread crumb model

BreadCrumbPanel

public BreadCrumbPanel(String id,
                       IBreadCrumbModel breadCrumbModel,
                       IModel<?> model)

Construct.

Parameters:

id - Component id

breadCrumbModel - The bread crumb model

model - The model

Method Detail

activate

public void activate(IBreadCrumbPanelFactory breadCrumbPanelFactory)

Activates the bread crumb panel that is the result of calling the create method of the bread crumb panel factory.

Parameters:

breadCrumbPanelFactory -

activate

public void activate(IBreadCrumbParticipant participant)

Activates the provided participant, which typically has the effect of replacing this current panel with the one provided - as the participant typically would be a bread crumb panel - and updating the bread crumb model of this panel, pushing the bread crumb for the given participant on top.

Parameters:

participant - The participant to set as the active one

getBreadCrumbModel

public final IBreadCrumbModel getBreadCrumbModel()

Gets the bread crumb panel.

Returns:

The bread crumb panel

getComponent

public Component getComponent()

The participating component == this.

Specified by:

getComponent in interface IBreadCrumbParticipant

Returns:

The participating component, must return a non-null value

See Also:

IBreadCrumbParticipant.getComponent()

onActivate

public void onActivate(IBreadCrumbParticipant previous)

Description copied from interface: IBreadCrumbParticipant

Called when the corresponding bread crumb is activated.

Specified by:

onActivate in interface IBreadCrumbParticipant

Parameters:

previous - The previously active bread crumb participant, possibly null

See Also:

IBreadCrumbParticipant.onActivate(org.apache.wicket.extensions.breadcrumb.IBreadCrumbParticipant)

setBreadCrumbModel

public final void setBreadCrumbModel(IBreadCrumbModel breadCrumbModel)

Sets the bread crumb panel.

Parameters:

breadCrumbModel - The bread crumb panel