HtmlHeaderContainer (Wicket 1.4-rc4 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.wicket.markup.html.internal
Class HtmlHeaderContainer

java.lang.Object
  org.apache.wicket.Component
      org.apache.wicket.MarkupContainer
          org.apache.wicket.markup.html.WebMarkupContainer
              org.apache.wicket.markup.html.internal.HtmlHeaderContainer

All Implemented Interfaces:: java.io.Serializable, IClusterable, IConverterLocator

public class HtmlHeaderContainer
extends WebMarkupContainer
extends WebMarkupContainer

The HtmlHeaderContainer is automatically created and added to the component hierarchy by a HtmlHeaderResolver instance. HtmlHeaderContainer tries to handle/render the >head> tag and its body. However depending on the parent component, the behavior must be different. E.g. if parent component is a Page all components of the page's hierarchy must be asked if they have something to contribute to the <head> section of the html response. If yes, it must immediately be rendered.

<head> regions may contain additional wicket components, which can be added by means of add(Component) as usual.

<wicket:head> tags are handled by simple WebMarkupContainers also created by a HtmlHeaderResolver.

<head> will be inserted in output automatically if required
<head> is not a wicket specific tag and you must use add() to add components referenced in body of the head tag
<head> is supported by panels, borders and inherited markup, but is not copied to the output. They are for previewability only (except on Pages)
<wicket:head> does not make sense in page markup (but does in inherited page markup)
<wicket:head> makes sense in Panels, Borders and inherited markup (of Panels, Borders and Pages)
components within <wicket:head> must be added by means of add(), like always with Wicket. No difference.
<wicket:head> and it's content is copied to the output. Components contained in <org.apache.wicket.head> are rendered as usual

Author:: Juergen Donnerstag
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_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED6, FLAG_RESERVED7, FLAG_RESERVED8, PATH_SEPARATOR, RENDER`

Constructor Summary
`HtmlHeaderContainer(java.lang.String id)` Construct

Method Summary
`IHeaderResponse`	`getHeaderResponse()` Returns the header response.
`boolean`	`isTransparentResolver()` Some MarkupContainers (e.g.
`protected IHeaderResponse`	`newHeaderResponse()` Factory method for creating header response
`boolean`	`okToRenderComponent(java.lang.String scope, java.lang.String id)` Check if the header component is ok to render within the scope given.
`protected void`	`onComponentTagBody(MarkupStream markupStream, ComponentTag openTag)` First render the body of the component.
`protected void`	`onDetach()` Called to allow a component to detach resources after use.
`protected boolean`	`renderOpenAndCloseTags()`

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, iterator, iterator, newMarkupResourceStream, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderComponentTagBody, 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, 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, onComponentTag, onEndRequest, onModelChanged, onModelChanging, prepareForRender, prepareForRender, redirectToInterceptPage, remove, remove, render, render, renderComponent, renderComponent, renderComponentTag, rendered, renderHead, 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 org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, callOnBeforeRenderIfNotVisible, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, 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, onComponentTag, onEndRequest, onModelChanged, onModelChanging, prepareForRender, prepareForRender, redirectToInterceptPage, remove, remove, render, render, renderComponent, renderComponent, renderComponentTag, rendered, renderHead, 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

HtmlHeaderContainer

public HtmlHeaderContainer(java.lang.String id)

Construct

See Also:: Component.Component(String)

Method Detail

onComponentTagBody

protected final void onComponentTagBody(MarkupStream markupStream,
                                        ComponentTag openTag)

First render the body of the component. And if it is the header component of a Page (compared to a Panel or Border), than get the header sections from all component in the hierarchy and render them as well.

Overrides:: onComponentTagBody in class MarkupContainer

Parameters:: markupStream - The markup stream; openTag - The open tag for the body
See Also:: MarkupContainer.onComponentTagBody(org.apache.wicket.markup.MarkupStream, org.apache.wicket.markup.ComponentTag)

renderOpenAndCloseTags

protected boolean renderOpenAndCloseTags()

Returns:: True if open and close tag are to be rendered.

isTransparentResolver

public boolean isTransparentResolver()

Description copied from class: MarkupContainer

Some MarkupContainers (e.g. HtmlHeaderContainer) have to be transparent with respect to their child components. A transparent container gets its children from its parent container.

Overrides:: isTransparentResolver in class MarkupContainer

Returns:: false. By default a MarkupContainer is not transparent.
See Also:: MarkupContainer.isTransparentResolver()

okToRenderComponent

public boolean okToRenderComponent(java.lang.String scope,
                                   java.lang.String id)

Check if the header component is ok to render within the scope given.

Parameters:: scope - The scope of the header component; id - The component's id
Returns:: true, if the component ok to render

onDetach

protected void onDetach()

Description copied from class: Component

Called to allow a component to detach resources after use. Overrides of this method MUST call the super implementation, the most logical place to do this is the last line of the override method.

Overrides:: onDetach in class Component

See Also:: Component.onDetach()

newHeaderResponse

protected IHeaderResponse newHeaderResponse()

Factory method for creating header response

Returns:: new header response

getHeaderResponse

public IHeaderResponse getHeaderResponse()

Returns the header response.

Returns:: header response