The DojoMobileOpener widget is a component that encapsulates
the mechanism for displaying secondary views such as dialogs.
Properties
- isModal
- A boolean value that indicates whether the opener is modal. If
the opener is modal, you cannot interact with the parent widget until
it disappears.
- children
- An array of child widgets.
Functions
- showOpener
Shows the content that is specified in the children field
of the widget in a separate view. If the screen height or width of
some devices is less than 500px, the view is displayed as an overlay
that pops up from bottom without an arrow. Otherwise, the view might
display with an arrow pointing to the widget specified by the aroundWidget as
a tooltip.
The
aroundWidget widget indicates
the location from where the opener pops up when it behaves as a tooltip.
You can only use this parameter when the opener behaves as a tooltip
in the
modal mode. Therefore, the following
code only works for non-modal opener, but might fail for modal opener
when it runs on a tablet device whose width and height are both greater
than 500px.
nonModalOpener DojoMobileOpener{isModal = false};
_nonmodalOpener.showOpener( null, null ); //successed
_modalOpener DojoMobileOpener{isModal = true};
_modalOpener.showOpener( null, null ); // may fail
The
tooltip content is placed in the positions that are relateds to the
aroundWidget in
a best-fit mode. The parameter is only used when the opener behaves
as a tooltip in the
modal mode. See the following
options for the parameters:
* DojoMobileLib.OPENER_POP_BEFORE: places drop down before the aroundWidget
* DojoMobileLib.OPENER_POP_AFTER: places drop down after the aroundWidget
* DojoMobileLib.OPENER_POP_ABOVE: drop down goes above aroundWidget
* DojoMobileLib.OPENER_POP_BELOW: drop down goes below aroundWidget
- hideOpener
- Hides the content of the opener.