To open: use app.UI.lightbox(position, options, content);
which contains the first parameter position as the position of the lightbox that can only be "top", "center" or "bottom" & second parameter options as a JSON {} which contains attributes as so (all are optional)
title: "Title of the lightbox"
/* Default: null */
allowClose: true|false /* True allows users to force close with an "×" at the top right corner of the lightbox and false don't */
/* Default: true */
exitTap: true|false /* True allows users to anywhere outside of the box to close */
/* Default: true */
autoClose: integer|float /* The lightbox will automatically close after the determined second */
/* Default: 0 (infinite) */
allowScroll: true|false /* True allows users to scroll in background */
/* Default: false */
Please note that all of these attributes are optional, but be careful if you're leaving the allowClose blank or false it may cause the lightbox to not being able to close until the page reloads so maybe you want to set the attribute autoClose for safety
And the third parameter content which is a HTML to be displayed in the lightbox.
To close: regularly users will be the ones to close it or the timeout set, but if you want it to be programmatically close, then use app.UI.lightbox.close();
To get status: use app.UI.lightbox.isOpen();