	Language
	English
	English
	English
	French
	German
	German
	German
	Italian
	Korean
	Spanish
	Catalan
	Dutch
	Portuguese
	Portuguese
	Arabic
	Arabic
	Bulgarian
	Bangla
	Bosnian
	Czech
	Greek
	Estonian
	Persian
	Finnish
	Danish
	Hindi
	Indonesian
	Icelandic
	Croatian
	Japanese
	Hungarian
	Hebrew
	Georgian
	Central Kurdish
	Khmer
	Kyrgyz
	Kazakh
	Lithuanian
	Latvian
	Malay
	Norwegian
	Polish
	Romanian
	Russian
	Slovak
	Slovenian
	Serbian
	Serbian
	Swedish
	Thai
	Turkish
	Ukrainian
	Uzbek
	Vietnamese
	Chinese
	Chinese

OutputPanel

Output panel is a container element with several use cases such as autoUpdate and deferred loading. This example demonstrates the deferred loading feature with two modes where the content of the panel is loaded after the page itself is loaded to speed up initial page load time. There are two deferred modes, "load" (after page load) and "visible" (after page load and visible after page scroll). A progress indicator is also provided while loading the content.

OutputPanel Tag Documentation

OutputPanel is a container component with deferred loading and layout options.

Name	Type	Required	Default	Description
id	String	false	generated	Unique identifier of the component in a namingContainer.
rendered	boolean	false	true	Boolean value to specify the rendering of the component, when set to false component will not be rendered.
binding	UIComponent	false	generated	An EL expression referring to a server side UIComponent instance in a backing bean.
widgetVar	String	false	generated ('widget_' + componentClientId)	Name of the client side widget.
deferred	boolean	false	false	When true, panel content is loaded lazily.
deferredMode	String	false	load	Mode of deferred loading, valid values are "load" and "visible".
layout	String	false	block	Layout of the panel, valid values are "block" and "inline".
loaded	Boolean	false		Whether the panel content is loaded.
style	String	false		Inline style of the component.
styleClass	String	false		Style class of the component.

Name	Description
loading	Facet to render when the panel is loading.

Name	Type	Default	Description
load	AjaxBehaviorEvent	true	Fires when the panel content is loaded.

Name	Library	Target
components.css	primefaces
jquery/jquery.js	primefaces
jquery/jquery-plugins.js	primefaces
core.js	primefaces
components.js	primefaces

Family org.primefaces.component

Type org.primefaces.component.OutputPanel

Class org.primefaces.component.outputpanel.OutputPanel

Renderer Type org.primefaces.component.OutputPanelRenderer

Renderer Class org.primefaces.component.outputpanel.OutputPanelRenderer

RESOURCES

Tag DocumentationNew DocumentationNew Documentation JSDoc


<h:form>
    <div class="card" style="min-height: 175px">
        <p:outputPanel deferred="true">
            <h5>Loaded after page load</h5>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
                Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
                Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
                Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
        </p:outputPanel>
    </div>

    <div class="card" style="min-height: 230px">
        <p:tabView dynamic="true">
            <p:tab title="Skeletons">
                <p:outputPanel deferred="true" class="mt-2">
                    <p:ajax event="load" listener="#{outputPanelView.loadData}"/>
                    <f:facet name="loading">
                        <p:skeleton width="200px" height="21px" class="mb-4"/>
                        <p:skeleton width="100%" height="42px"/>
                    </f:facet>
                    <h5>#{outputPanelView.data.title}</h5>
                    <p>#{outputPanelView.data.body}</p>
                </p:outputPanel>
            </p:tab>
            <p:tab title="Ajax / Loaded">
                <p:outputPanel deferred="true" loaded="#{not empty outputPanelView.data2}" class="mt-2">
                    <p:ajax event="load" listener="#{outputPanelView.loadData2}"/>
                    <f:facet name="loading">
                        <p:skeleton width="200px" height="21px" class="mb-4"/>
                        <p:skeleton width="100%" height="42px"/>
                    </f:facet>
                    <h5>#{outputPanelView.data2.title}</h5>
                    <p>#{outputPanelView.data2.body}</p>
                </p:outputPanel>
            </p:tab>
        </p:tabView>
    </div>

    <div style="height:1000px"></div>

    <div class="card">
        <p:outputPanel deferred="true" deferredMode="visible">
            <h5>Loaded after the panel becomes visible on page scroll</h5>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
                Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
                Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
                Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
        </p:outputPanel>
    </div>
</h:form>


package org.primefaces.showcase.view.panel;

import java.io.Serializable;
import java.util.HashMap;
import java.util.Map;

import jakarta.faces.view.ViewScoped;
import jakarta.inject.Named;

@Named
@ViewScoped
public class OutputPanelView implements Serializable {

    private Map<String, String> data = new HashMap<>();
    private Map<String, String> data2 = new HashMap<>();

    public void loadData() throws InterruptedException {
        Thread.sleep(1000); // Sleep a bit to show the skeletons
        data.put("title", "OutputPanel loading facet");
        data.put("body", "Deferred loading can be used with the \"loading\" facet to show UI while the data is being "
                + "loaded. This is normally combined with the load ajax event with a listener which loads the data you "
                + "want to show in your panel. See xhtml and OutputPanelView.java");
    }

    public void loadData2() throws InterruptedException {
        Thread.sleep(1000); // Sleep a bit to show the skeletons
        data2.put("title", "Deferred loading in Ajax requests");
        data2.put("body", "By default deferred loading does not work with Ajax requests. As a solution you can use the "
                + "\"loaded\" boolean attribute to enforce loading (even in Ajax requests). Normally you would use "
                + "an expression here checking if your data is empty. See xhtml and OutputPanelView.java");
    }

    public Map<String, String> getData() {
        return data;
    }

    public Map<String, String> getData2() {
        return data2;
    }

}

OutputPanel

OutputPanel Tag Documentation

Usage

Reloading page