jQueryMobile - SimpleDialog2

Home

Available Options

• mode

  Type:

  String

  Default:

  'blank'

  Mode of operation.

  Valid options: ['blank', 'button']

• Themeing

• themeDialog

  Type:

  String

  Default:

  'b'

  Modes:

  all

  Theme for the dialog.

• themeHeader

  Type:

  String

  Default:

  'a'

  Modes:

  all

  Theme for the header, if used.

• themeInput

  Type:

  String

  Default:

  'e'

  Modes:

  button

  Theme for the input element in Button->Input mode.

• themeButtonDefault

  Type:

  String

  Default:

  false

  Modes:

  button

  Default theme for the buttons in Button->Input mode, defaults to whatever themeDialog is set to.

• animate

  Type:

  Boolean

  Default:

  true

  Modes:

  all

  Use animations on transition.

• transition

  Type:

  String

  Default:

  'pop'

  Modes:

  all

  Animation style for transitions.

• width

  Type:

  String

  Default:

  '280px'

  Modes:

  all

  Width of the dialog popup.

• top

  Type:

  Number

  Default:

  false

  Modes:

  all

  Force position of top of popup.

• left

  Type:

  Number

  Default:

  false

  Modes:

  all

  Force position of left of popup.

• Header Options

• headerText

  Type:

  String

  Default:

  false

  Modes:

  all

  Text to use in the header. If this, and headerButton are FALSE, no header is used.

• headerClose

  Type:

  Boolean

  Default:

  false

  Modes:

  all

  Show a close button in the header. If this, and headerText are FALSE, no header is used.

• Display Options

• dialogAllow

  Type:

  Boolean

  Default:

  false

  Modes:

  all

  Allow use of jQM native dialogs if screen size < 400px.

• dialogForce

  Type:

  Boolean

  Default:

  false

  Modes:

  all

  Always use the jQM native dialogs.

• fullScreen

  Type:

  Boolean

  Default:

  false

  Modes:

  all

  Allow the use of the custom full screen display is screen size < 400px.

• fullScreenForce

  Type:

  Boolean

  Default:

  false

  Modes:

  all

  Always use the custom full screen display

• showModal

  Type:

  Boolean

  Default:

  true

  Modes:

  all

  Blank the background when using popup mode, modal style.

• forceInput

  Type:

  Boolean

  Default:

  false

  Modes:

  all

  Do not close dialog when clicking outside the dialog.

• Internal Operation

• clickEvent

  Type:

  String

  Default:

  'click'

  Modes:

  all

  Event to bind all actions to (including header close button, buttons in button mode, and outside dialog trap).

• zindex

  Type:

  Number

  Default:

  500

  Modes:

  all

  z-Index of the popup element (For fixed headers/footers, this might need to be extreamly high).

• resizeListener

  Type:

  Boolean

  Default:

  true

  Modes:

  all

  Listen to resize events, and reposition accordingly (Desktop operation really).

• safeNuke

  Type:

  Boolean

  Default:

  true

  Modes:

  all

  Try and detect if you used an unattached, empty node as your selector - if you did, delete it for you after the dialog closes. (If you run into really odd errors, try turning this off, then contact J.T. - he'll want to know.)

• Widget Callbacks

• callbackOpen

  Type:

  Function

  Default:

  false

  Modes:

  all

  Function to run when the dialog opens.

• callbackOpenArgs

  Type:

  Array

  Default:

  empty

  Modes:

  all

  An array of arguments to send to the open callback. Remember 'this' is the widget object.

• callbackClose

  Type:

  Function

  Default:

  false

  Modes:

  all

  Function to run when the dialog closes, before cleanup is done - return false to prevent close.

• callbackCloseArgs

  Type:

  Array

  Default:

  empty

  Modes:

  all

  An array of arguments to send to the close callback. Remember 'this' is the widget object.

• Blank Mode Options

• blankContent

  Type:

  String

  Default:

  false

  Modes:

  blank

  A String of the HTML you wish to use in the blank/freeform mode. This may also be a jQuery object. Set to true if inlining options.

• blankContentAdopt

  Type:

  boolean

  Default:

  false

  Modes:

  blank

  When inlining, brink all data and controls with the HTML. You almost certainly want this, set to false by default to preserve backwards compatibility with older installs.

• Button Mode Options

• buttonPrompt

  Type:

  String

  Default:

  false

  Modes:

  button

  A string to use as a prompt in the dialog, HTML allowed, wrapper in a <p>

• buttonInput

  Type:

  Boolean

  Default:

  false

  Modes:

  button

  Show an input box in the dialog.

• buttonInputDefault

  Type:

  String

  Default:

  false

  Modes:

  button

  Default text for the input box.

• buttonPassword

  Type:

  Boolean

  Default:

  false

  Modes:

  button

  Show an input box of type password in the dialog - buttonInput must also be TRUE.

• button

  Type:

  Boolean

  Default:

  false

  Modes:

  button

  An object of buttons - see below for individual button options.

• Button Object Options

• id

  Type:

  String

  Default:

  false

  Modes:

  button object

  The HTML ID of the button. If false, one is generated.

• theme

  Type:

  String

  Default:

  inherited

  Modes:

  button object

  The theme of the button.

• icon

  Type:

  String

  Default:

  'check'

  Modes:

  button object

  The icon of the button.

• iconpos

  Type:

  String

  Default:

  'left'

  Modes:

  button object

  The position of the icon on the button.

• corners

  Type:

  Boolean

  Default:

  true

  Modes:

  button object

  If true, round the corners of the button.

• shadow

  Type:

  Boolean

  Default:

  true

  Modes:

  button object

  If true, button will have a drop shadow.

• close

  Type:

  Boolean

  Default:

  true

  Modes:

  button object

  Clicking this button will close the dialog.

• click

  Type:

  Function

  Modes:

  button object

  A function to run when this button is clicked. If it returns false, the dialog will not close.

• args

  Type:

  Array

  Modes:

  button object

  An array of arguments to *also* pass to the click function. The first argument is always the event.