To turn any div into a popup, add the data-role="popup" attribute to the div. If you would like the popup to appear when the user clicks on a link, create a link such that its href attribute is set to the id of the popup, and the link has the attribute data-rel="popup".
data-role="popup"
href
data-rel="popup"
<a href="#popupBasic" data-rel="popup">Tooltip</a> <div data-role="popup" id="popupBasic"> This is a completely basic popup, no options set. </div>
This will result in the following popup. Note that we shouldn't set any padding on the popup so widgets will fit cleanly inside.
There seems to be some inheritance going on with buttons: popup
Now on to some cool examples
Here is a tiny popup being used like a tooltip.
This is a regular page, styled as a dialog. To create a dialog, just link to a normal page and include a transition and data-rel="dialog" attribute.
data-rel="dialog"
Collapsible content
This plugin will auto initialize on any page that contains a div with the attribute data-role="popup". However, if needed you can directly call the popup plugin on any selector, just like any jQuery plugin:
popup
$('#myPopupDiv').popup();
Normally, the popup's theme will be set to align with the theme of the link that launches it. The above popup can be shown in multiple places. Each time, upon appearing, the popup's theme is set to match that of the link that launches it:
<a href="#popupTester" data-rel="popup" data-role="button" data-inline="true" data-theme="a">Pop</a> <a href="#popupTester" data-rel="popup" data-role="button" data-inline="true" data-theme="b">Pop</a> <a href="#popupTester" data-rel="popup" data-role="button" data-inline="true" data-theme="e">Pop</a>
The result: Pop Pop Pop
However, you can override this by setting the theme yourself. You can apply a theme separately to the popup itself and to its contents. To apply a theme to the popup itself, set the data-overlay-theme attribute to one of the swatches. For example, data-overlay-theme="a". To apply a theme to the contents of the popup, add the swatch of your choice via the data-theme attribute to the popup div. For example, data-theme="a". Here is an example of an explicitly themed popup:
data-overlay-theme
data-overlay-theme="a"
data-theme
data-theme="a"
<div data-role="popup" id="popupTesterThemed" data-overlay-theme="e" data-theme="a"> <table> <tr><td>Mary</td><td>had-a</td><td>little</td><td>lamb</td></tr> <tr><td>And</td><td>it-was</td><td>white-as</td><td>snow</td></tr> <tr><td>Everywhere</td><td>that</td><td>Mary</td><td>went</td></tr> <tr><td>It</td><td>was</td><td>sure</td><td>to-go</td></tr> </table> </div> <a href="#popupTesterThemed" data-rel="popup" data-role="button" data-inline="true">Pop</a>
This is the result: