JBoss.orgCommunity Documentation
This chapter details those components in the a4j tag library which define an area used as a container or wrapper for other components.
component-type: org.ajax4jsf.OutputPanel
component-family: javax.faces.Panel
component-class: org.ajax4jsf.component.html.HtmlAjaxOutputPanel
renderer-type: org.ajax4jsf.components.AjaxOutputPanelRenderer
The <a4j:outputPanel> component is used to group together components in to update them as a whole, rather than having to specify the components individually.
The layout attribute can be used to determine how the component is rendered in HTML:
layout="inline" is the default behavior, which will render the component as a pair of <span> tags containing the child components.
layout="block" will render the component as a pair of <div> tags containing the child components, which will use any defined <div> element styles.
layout="none" will render the component as a pair of <span> tags with an identifier equal to that of a child component. If the child component is rendered then the <span> are not included, leaving no markup representing the <a4j:outputPanel> in HTML.
Setting ajaxRendered="true" will cause the <a4j:outputPanel> to be updated with each Ajax response for the page, even when not listed explicitly by the requesting component. This can in turn be overridden by specific attributes on any requesting components.