	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

Dialog

Dialog is a container to display content in an overlay window.

Dialog Tag Documentation

Dialog is a container component to display content in an overlay window.

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.
appendTo	String	false		Append dialog to the element with the given identifier.
blockScroll	boolean	false	false	Blocks scrolling of the document when dialog is modal.
cache	boolean	false	true	Caches the content when dynamic loading is enabled.
closable	boolean	false	true	Makes dialog closable.
closeOnEscape	boolean	false	false	Closes dialog when escape key is pressed.
dir	String	false	ltr	Defines text direction, valid values are ltr and rtl.
dismissibleMask	boolean	false	false	Closes dialog by clicking on the modal background mask.
draggable	boolean	false	true	Makes dialog draggable.
dynamic	boolean	false	false	Enables lazy loading of dialog content.
fitViewport	boolean	false	false	Fits dialog in the viewport.
focus	String	false		Component to receive focus when dialog is opened.
footer	String	false		Footer text.
header	String	false		Header text.
height	String	false		Height of the dialog.
hideEffect	String	false		Hide effect to be used when hiding dialog.
maximizable	boolean	false	false	Makes dialog maximizable.
minHeight	int	false	Integer.MIN_VALUE	Minimum height in pixels.
minWidth	int	false	Integer.MIN_VALUE	Minimum width in pixels.
minimizable	boolean	false	false	Makes dialog minimizable.
modal	boolean	false	false	Makes dialog modal.
my	String	false	center	Position of the dialog relative to the target element.
onHide	String	false		Client-side callback to execute when dialog is hidden.
onShow	String	false		Client-side callback to execute when dialog is shown.
position	String	false		Position of the target element relative to the dialog.
positionType	String	false	fixed	Position type of the dialog, valid values are 'fixed' and 'absolute'.
resizable	boolean	false	true	Makes dialog resizable.
responsive	boolean	false	true	In responsive mode, dialog adjusts itself based on screen width.
showEffect	String	false		Show effect to be used when displaying dialog.
showHeader	boolean	false	true	Renders dialog header.
style	String	false		Inline style of the component.
styleClass	String	false		Style class of the component.
visible	boolean	false	false	Renders dialog as visible.
width	String	false		Width of the dialog.

Name	Description
actions	Allows to add custom action to the titlebar.
footer	Allows custom HTML in the footer. Alternative to footer.
header	Allows custom HTML in the header. Alternative to header.

Name	Type	Default	Description
close	CloseEvent	true	Fires when dialog is closed.
minimize	AjaxBehaviorEvent	false	Fires when dialog is minimized.
maximize	AjaxBehaviorEvent	false	Fires when dialog is maximized.
move	MoveEvent	false	Fires when dialog is moved.
restoreMinimize	AjaxBehaviorEvent	false	Fires when dialog is restored from minimized state.
restoreMaximize	AjaxBehaviorEvent	false	Fires when dialog is restored from maximized state.
open	AjaxBehaviorEvent	false	Fires when dialog is opened.
loadContent	AjaxBehaviorEvent	false	Fires when dialog content is loaded.
resizeStart	ResizeEvent	false	Fires when dialog resize starts.
resizeStop	ResizeEvent	false	Fires when dialog resize stops.

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.Dialog

Class org.primefaces.component.dialog.Dialog

Renderer Type org.primefaces.component.DialogRenderer

Renderer Class org.primefaces.component.dialog.DialogRenderer

RESOURCES

Tag DocumentationNew DocumentationNew Documentation JSDoc

Basic

Modal

Button Bar

Minimize and Maximize

Fit Viewport

Custom Toolbar

Usage

dialog.xhtml


<div class="card">
    <h5>Basic</h5>
    <p:commandButton value="Show" type="button" icon="pi pi-external-link" onclick="PF('dlg1').show()"/>

    <h5>Modal</h5>
    <p:commandButton value="Show" type="button" icon="pi pi-external-link" onclick="PF('dlg2').show()"/>

    <h5>Button Bar</h5>
    <p:commandButton value="Show" type="button" icon="pi pi-external-link" onclick="PF('dlg3').show()"/>

    <h5>Minimize and Maximize</h5>
    <p:commandButton value="Show" type="button" icon="pi pi-external-link" onclick="PF('dlg4').show()"/>

    <h5>Fit Viewport</h5>
    <p:commandButton value="Show" type="button" icon="pi pi-external-link" onclick="PF('dlg5').show()"/>

    <h5>Custom Toolbar</h5>
    <p:commandButton value="Show" type="button" icon="pi pi-external-link" onclick="PF('dlg6').show()"/>
</div>

<p:dialog header="Header" widgetVar="dlg1" minHeight="40" width="350" showEffect="fade" closeOnEscape="true">
    <p class="m-0">Lorem ipsum dolor sit amet, consectetur adipiscing 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:dialog>

<p:dialog header="Header" widgetVar="dlg2" minHeight="40" width="350" showEffect="fade" modal="true" closeOnEscape="true" dismissibleMask="true">
    <p class="m-0">Lorem ipsum dolor sit amet, consectetur adipiscing 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:dialog>

<p:dialog header="Header" widgetVar="dlg3" minHeight="40" width="350" showEffect="fade" focus="btnYes" closeOnEscape="true">
    <p class="m-0">Lorem ipsum dolor sit amet, consectetur adipiscing 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>
    <f:facet name="footer">
        <p:commandButton type="button" value="No" styleClass="ui-button-flat mr-2" style="width: 6rem" />
        <p:commandButton id="btnYes" type="button" value="Yes" style="width: 5rem" />
    </f:facet>
</p:dialog>

<p:dialog header="Header" widgetVar="dlg4" minHeight="40" width="350" showEffect="fade" minimizable="true" maximizable="true">
    <p class="m-0">Lorem ipsum dolor sit amet, consectetur adipiscing 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:dialog>

<p:dialog header="Header" widgetVar="dlg5" height="1500" width="1500" fitViewport="true">
    <p class="m-0 mb-2">Lorem ipsum dolor sit amet, consectetur adipiscing 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 class="m-0 mb-2">Lorem ipsum dolor sit amet, consectetur adipiscing 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 class="m-0">Lorem ipsum dolor sit amet, consectetur adipiscing 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:dialog>

<p:dialog header="Header" widgetVar="dlg6" minHeight="40" width="350" showEffect="fade" closeOnEscape="true">
    <f:facet name="actions">
        <p:commandLink styleClass="ui-dialog-titlebar-icon"><i class="ui-icon pi pi-calendar"></i></p:commandLink>
        <p:commandLink styleClass="ui-dialog-titlebar-icon"><i class="ui-icon pi pi-question"></i></p:commandLink>
    </f:facet>
    <p class="m-0">Lorem ipsum dolor sit amet, consectetur adipiscing 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:dialog>