This example demonstrates how to show and hide the Popup component, populate it with content, specify its position and other settings.
To see step-by-step instructions on how to get started with the DevExtreme Popup component, refer to the following tutorial: Getting Started with Popup.
Call the show() method to display the Popup. To close a Popup, choose one of the following options:
Built-in close button
Enable the showCloseButton property to display the Close button in a Popup's top toolbar.
Custom close button
This demo shows how to add custom buttons to the Popup. One of them uses an onClick handler to call the hide() method that closes the Popup. Refer to the next section (Configure the Popup) to learn how you can populate a popup with custom controls.
On outside click
Enable the hideOnOutsideClick property to allow users to hide the Popup by clicking outside the component.
The Popup inner area is divided into three parts:
Set showTitle to
true and use the title property to specify the caption. The Close button will appear if you do not disable the showCloseButton property.
Add toolbarItems markup and set each item's toolbar property to
top. If you want to display an item in the overflow menu, as shown in this demo, set the item's locateInMenu property to
always. You can also assign
never to this property to keep the item outside the overflow menu, or you can assign
auto to hide the item in the menu if the Popup's width decreases.
To populate the Popup with content, use the contentTemplate property.
To enable the bottom toolbar, declare the toolbarItems array as shown in this demo. Set each item's toolbar property to
bottom. To learn more about toolbar configuration, refer to the following tutorial: Getting Started with Toolbar
To specify Popup size, use the height and width properties.
In this demo, each Popup's location is relative to the image. The code specifies the my, at, and of properties of the position object. The configuration in the demo reads as follows: "place my
center side at the
bottom side of the
Use the container property to select the container in which you want to render the Popup. If you set the container property to an element on the page, the shading applies to this element.
Turn on the dragEnabled option to allow users to move the Popup around the page.