org.apache.wicket.extensions.breadcrumb
Class BreadCrumbBar

java.lang.Object
  org.apache.wicket.Component
      org.apache.wicket.MarkupContainer
          org.apache.wicket.markup.html.WebMarkupContainer
              org.apache.wicket.markup.html.panel.Panel
                  org.apache.wicket.extensions.breadcrumb.BreadCrumbBar

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IBreadCrumbModel, IConverterLocator, IHeaderContributor, IRequestableComponent, org.apache.wicket.util.IHierarchical<Component>, org.apache.wicket.util.io.IClusterable

public class BreadCrumbBar
extends Panel
implements IBreadCrumbModel

A component that renders bread crumbs. By default, it renders a horizontal list from left to right (oldest left) with bread crumb links and a ' / ' as a separator, e.g.

 first / second / third
 

Delegates how the bread crumb model works to DefaultBreadCrumbsModel.

Override and provide your own markup file if you want to work with other elements, e.g. uls instead of spans.

Author:

Eelco Hillenius

See Also:

Serialized Form

Nested Class Summary

protected class

BreadCrumbBar.BreadCrumbsListView List view for rendering the bread crumbs.

Field Summary

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

PANEL

Fields inherited from class org.apache.wicket.Component

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

Constructor Summary

BreadCrumbBar(String id)
Construct.

Method Summary

void	addListener(IBreadCrumbModelListener listener) Adds a bread crumb model listener.
List<IBreadCrumbParticipant>	allBreadCrumbParticipants() Lists the bread crumb participants in this model.
IBreadCrumbParticipant	getActive() Gets the currently active participant, if any.
protected boolean	getEnableLinkToCurrent() Gets whether the current bread crumb should be displayed as a link (e.g.
protected String	getSeparatorMarkup()
protected Component	newBreadCrumbComponent(String id, long index, int total, IBreadCrumbParticipant breadCrumbParticipant) Creates a new bread crumb component.
protected void	onDetach()
void	removeListener(IBreadCrumbModelListener listener) Removes a bread crumb model listener.
void	setActive(IBreadCrumbParticipant breadCrumbParticipant) Sets the bread crumb as the active one.

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

newMarkupSourcingStrategy

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

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onComponentTagBody, onRender, 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, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, 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, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onEvent, onInitialize, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, 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

Constructor Detail

BreadCrumbBar

public BreadCrumbBar(String id)

Construct.

Parameters:

id - Component id

Method Detail

addListener

public void addListener(IBreadCrumbModelListener listener)

Description copied from interface: IBreadCrumbModel

Adds a bread crumb model listener.

Specified by:

addListener in interface IBreadCrumbModel

Parameters:

listener - The listener to add

allBreadCrumbParticipants

public List<IBreadCrumbParticipant> allBreadCrumbParticipants()

Description copied from interface: IBreadCrumbModel

Lists the bread crumb participants in this model.

Specified by:

allBreadCrumbParticipants in interface IBreadCrumbModel

Returns:

The bread crumbs participants, as list with bread crumb participants.

getActive

public IBreadCrumbParticipant getActive()

Description copied from interface: IBreadCrumbModel

Gets the currently active participant, if any.

Specified by:

getActive in interface IBreadCrumbModel

Returns:

The currently active participant, may be null

removeListener

public void removeListener(IBreadCrumbModelListener listener)

Description copied from interface: IBreadCrumbModel

Removes a bread crumb model listener.

Specified by:

removeListener in interface IBreadCrumbModel

Parameters:

listener - The listener to remove

setActive

public void setActive(IBreadCrumbParticipant breadCrumbParticipant)

Description copied from interface: IBreadCrumbModel

Sets the bread crumb as the active one. Implementations should call bread crumb added when the bread crumb was not yet part of the model, and bread crumb removed for every crumb that was removed as the result of this call.

Specified by:

setActive in interface IBreadCrumbModel

Parameters:

breadCrumbParticipant - The bread crump that should be set as the currently active

getEnableLinkToCurrent

protected boolean getEnableLinkToCurrent()

Gets whether the current bread crumb should be displayed as a link (e.g. for refreshing) or as a disabled link (effectively just a label). The latter is the default. Override if you want different behavior.

Returns:

Whether the current bread crumb should be displayed as a link; this method returns false

getSeparatorMarkup

protected String getSeparatorMarkup()

Returns:

markup used as a separator between breadcrumbs. By default / is used, but >> is also a popular choice.

newBreadCrumbComponent

protected Component newBreadCrumbComponent(String id,
                                           long index,
                                           int total,
                                           IBreadCrumbParticipant breadCrumbParticipant)

Creates a new bread crumb component. That component will be rendered as part of the bread crumbs list (which is a <ul> <li> structure).

Parameters:

id - The component id

index - The index of the bread crumb

total - The total number of bread crumbs in the current model

breadCrumbParticipant - the bread crumb

Returns:

A new bread crumb component

onDetach

protected void onDetach()

Overrides:

onDetach in class Component