API: container YAHOO.widget.SimpleDialog (YUI Library)

# Yahoo! UI Library

### Container 2.9.0

Yahoo! UI Library > container > YAHOO.widget.SimpleDialog
Search:
Filters Show Private Show Protected Show Deprecated

## Class YAHOO.widget.SimpleDialog - extends YAHOO.widget.Dialog

SimpleDialog is a simple implementation of Dialog that can be used to submit a single value. Forms can be processed in 3 ways -- via an asynchronous Connection utility call, a simple form POST or GET, or manually.

### Constructor

YAHOO.widget.SimpleDialog `( el , userConfig )`

Parameters:
  `el <String>` The element ID representing the SimpleDialog OR
  `el <HTMLElement>` The element representing the SimpleDialog
  `userConfig <Object>` The configuration object literal containing the configuration that should be set for this SimpleDialog. See configuration documentation for more details.

### Properties

#### DEFAULT_CONFIG - `private final Object`

Constant representing the SimpleDialog's configuration properties

#### YAHOO.widget.SimpleDialog.CSS_SIMPLEDIALOG - `static final String`

Constant representing the default CSS class used for a SimpleDialog

#### YAHOO.widget.SimpleDialog.ICON_ALARM - `static final String`

Constant for the standard network icon for alarm

#### YAHOO.widget.SimpleDialog.ICON_BLOCK - `static final String`

Constant for the standard network icon for a blocking action

#### YAHOO.widget.SimpleDialog.ICON_CSS_CLASSNAME - `static final String`

Constant representing the name of the CSS class applied to the element created by the "icon" configuration property.

#### YAHOO.widget.SimpleDialog.ICON_HELP - `static final String`

Constant for the standard network icon for help

#### YAHOO.widget.SimpleDialog.ICON_INFO - `static final String`

Constant for the standard network icon for info

#### YAHOO.widget.SimpleDialog.ICON_TIP - `static final String`

Constant for the standard network icon for a tip

#### YAHOO.widget.SimpleDialog.ICON_WARN - `static final String`

Constant for the standard network icon for warn

#### Properties inherited from YAHOO.widget.Panel:

`dd, DEFAULT_CONFIG, EVENT_TYPES`

#### Properties inherited from YAHOO.widget.Module:

`body, browser, cacheEffects, cfg, contructor, DEFAULT_CONFIG, element, EVENT_TYPES, footer, header, id, imageRoot, isSecure, platform`

#### Properties inherited from YAHOO.widget.Dialog:

`callback, callback.argument, callback.failure, callback.success, callback.upload, DEFAULT_CONFIG, EVENT_TYPES, form`

#### Properties inherited from YAHOO.widget.Overlay:

`CONTEXT_TRIGGERS, DEFAULT_CONFIG, EVENT_TYPES, YAHOO.widget.Overlay._initialized`

### Methods

#### configIcon

`void configIcon ( type , args , obj )`
Fired when the "icon" property is set.

Parameters:
  `type <String>` The CustomEvent type (usually the property name)
  `args <Object[]>` The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
  `obj <Object>` The scope object. For configuration handlers, this will usually equal the owner.

#### configText

`void configText ( type , args , obj )`
Fired when the "text" property is set.

Parameters:
  `type <String>` The CustomEvent type (usually the property name)
  `args <Object[]>` The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
  `obj <Object>` The scope object. For configuration handlers, this will usually equal the owner.

#### init

`void init ( el , userConfig )`
The SimpleDialog initialization method, which is executed for SimpleDialog and all of its subclasses. This method is automatically called by the constructor, and sets up all DOM references for pre-existing markup, and creates required markup if it is not already present.

Parameters:
  `el <String>` The element ID representing the SimpleDialog OR
  `el <HTMLElement>` The element representing the SimpleDialog
  `userConfig <Object>` The configuration object literal containing the configuration that should be set for this SimpleDialog. See configuration documentation for more details.

#### initDefaultConfig

`void initDefaultConfig ( )`
Initializes the class's configurable properties which can be changed using the SimpleDialog's Config object (cfg).

#### registerForm

`void registerForm ( )`
Prepares the SimpleDialog's internal FORM object, creating one if one is not currently present, and adding the value hidden field.

#### setBody

`void setBody ( bodyContent )`

Sets the SimpleDialog's body content to the HTML specified. If no body is present, one will be automatically created. An empty string can be passed to the method to clear the contents of the body.

NOTE: SimpleDialog provides the text and icon configuration properties to set the contents of it's body element in accordance with the UI design for a SimpleDialog (an icon and message text). Calling setBody on the SimpleDialog will not enforce this UI design constraint and will replace the entire contents of the SimpleDialog body. It should only be used if you wish the replace the default icon/text body structure of a SimpleDialog with your own custom markup.

Parameters:
  `bodyContent <HTML>` The HTML used to set the body. As a convenience, non HTMLElement objects can also be passed into the method, and will be treated as strings, with the body innerHTML set to their default toString implementations.

  NOTE: Markup passed into this method is added to the DOM as HTML, and should be escaped by the implementor if coming from an external source.

  OR
  `bodyContent <HTMLElement>` The HTMLElement to add as the first and only child of the body element. OR
  `bodyContent <DocumentFragment>` The document fragment containing elements which are to be added to the body

#### toString

`String toString ( )`
Returns a string representation of the object.

Returns: `String`
  The string representation of the SimpleDialog

#### Methods inherited from YAHOO.widget.Panel:

`_addFocusHandlers, _autoFillOnHeightChange, _createHiddenFocusElement, _doClose, _focusFirstModal, _focusOnShow, _onElementFocus, _removeFocusHandlers, _renderBody, _renderFooter, _renderHeader, _setTabLoop, _testIfFocusable, buildMask, buildWrapper, configClose, configDraggable, configHeight, configKeyListeners, configModal, configStrings, configUnderlay, configWidth, configzIndex, destroy, focusFirst, focusLast, forceUnderlayRedraw, getFocusableElements, hideMask, init, initDefaultConfig, initEvents, registerDragDrop, removeMask, render, setFirstLastFocusable, setTabLoop, showMask, sizeMask, sizeUnderlay, stackMask, toString`

#### Methods inherited from YAHOO.widget.Module:

`_addToParent, _createEffects, _initResizeMonitor, _renderBody, _renderFooter, _renderHeader, _supportsCWResize, appendToBody, appendToFooter, appendToHeader, configEffect, configMonitorResize, configVisible, destroy, hide, init, initDefaultConfig, initEvents, initResizeMonitor, onDomResize, render, setBody, setFooter, setHeader, show, toString`

#### Methods inherited from YAHOO.widget.Dialog:

`_doClose, _getButton, _getFormAttributes, _setTabLoop, _submitHandler, blurButtons, cancel, configButtons, configClose, configPostMethod, destroy, doSubmit, focusDefaultButton, focusFirst, focusFirstButton, focusLast, focusLastButton, getButtons, getData, init, initDefaultConfig, initEvents, registerForm, setFirstLastFocusable, setTabLoop, submit, toString, validate`

#### Methods inherited from YAHOO.widget.Overlay:

`_alignOnTrigger, _autoFillOnHeightChange, _findTriggerCE, _getComputedHeight, _getConstrainedPos, _getPreciseHeight, _preventOverlap, _primeXYFromDOM, _processTriggers, _setDomVisibility, _validateAutoFillHeight, align, bringToTop, center, configAutoFillHeight, configConstrainToViewport, configContext, configFixedCenter, configHeight, configIframe, configVisible, configWidth, configX, configXY, configY, configzIndex, destroy, doCenterOnDOMEvent, enforceConstraints, fillHeight, fitsInViewport, forceContainerRedraw, getConstrainedX, getConstrainedXY, getConstrainedY, hideIframe, hideMacGeckoScrollbars, init, initDefaultConfig, initEvents, moveTo, onDomResize, showIframe, showMacGeckoScrollbars, stackIframe, syncIframe, syncPosition, toString`

#### Events inherited from YAHOO.widget.Panel:

`beforeHideMaskEvent, beforeShowMaskEvent, dragEvent, hideMaskEvent, showMaskEvent,`

#### Events inherited from YAHOO.widget.Module:

`appendEvent, beforeHideEvent, beforeInitEvent, beforeRenderEvent, beforeShowEvent, changeBodyEvent, changeContentEvent, changeFooterEvent, changeHeaderEvent, destroyEvent, hideEvent, initEvent, renderEvent showEvent YAHOO.widget.Module.textResizeEvent`

#### Events inherited from YAHOO.widget.Dialog:

`asyncSubmitEvent, beforeSubmitEvent, cancelEvent, formSubmitEvent, manualSubmitEvent, submitEvent,`

#### Events inherited from YAHOO.widget.Overlay:

`beforeMoveEvent, moveEvent, YAHOO.widget.Overlay.windowResizeEvent, YAHOO.widget.Overlay.windowScrollEvent,`

### Configuration Attributes

#### icon `- String`

Sets the informational icon for the SimpleDialog
Default Value: "none"

#### text `- HTML`

Sets the text for the SimpleDialog. The text is inserted into the DOM as HTML, and should be escaped by the implementor if coming from an external source.
Default Value: ""

#### Configuration attributes inherited from YAHOO.widget.Panel:

`close, draggable, dragOnly, keylisteners modal strings underlay`

#### Configuration attributes inherited from YAHOO.widget.Module:

`appendtodocumentbody, effect monitorresize visible`

#### Configuration attributes inherited from YAHOO.widget.Dialog:

`buttons, hideaftersubmit postdata postmethod`

#### Configuration attributes inherited from YAHOO.widget.Overlay:

`autofillheight, constraintoviewport, context, fixedcenter, height, iframe preventcontextoverlap width x xy y zIndex`

Copyright © 2011 Yahoo! Inc. All rights reserved.