Note: this page has not been updated after 1.3

Question:

Sometimes my custom select shows as a popup other times its a dialog.

Answer:

Whether a custom select shows as a dialog or popup is based on the number of options and the amount of available space on the screen for maximum usability across devices. By default, the framework will use a small popup if all the options fit on-screen without scrolling. Longer selects open in a dialog to avoid awkward scrolling within a popup.