fixed the resizable text area with IE problem fixed the ad space with IE problem merged the 7.2.0 and 7.1.4 change logs
1290 lines
36 KiB
HTML
1290 lines
36 KiB
HTML
|
|
<html>
|
|
<head>
|
|
<title>JavaScript Documentation - </title>
|
|
<link href="stylesheet.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<div id="header">
|
|
<h1>JavaScript Documentation</h1>
|
|
<h3><a href="./index.html">Yahoo! UI Library: Container</a></h3>
|
|
|
|
<div class="breadcrumbs">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a href="./index.html">Yahoo! UI Library: Container</a>
|
|
>
|
|
<strong>YAHOO.widget.Dialog</strong>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div id="body">
|
|
|
|
|
|
<div class="nav">
|
|
<div class="module resources">
|
|
<ul class="content">
|
|
<li><a href="overview-tree.html">Tree View</a></li>
|
|
<li><a href="index-all.html">Element Index</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
|
|
<div class="module">
|
|
<h4><a href="./allclasses-noframe.html">Classes</a></h4>
|
|
<ul class="content">
|
|
|
|
|
|
|
|
<li>
|
|
<a href="YAHOO.util.Config.html">
|
|
YAHOO.util.Config</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.util.KeyListener.html">
|
|
YAHOO.util.KeyListener</a>
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.ContainerEffect.html">
|
|
YAHOO.widget.ContainerEffect</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.Dialog.html">
|
|
YAHOO.widget.Dialog</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.Module.html">
|
|
YAHOO.widget.Module</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.Overlay.html">
|
|
YAHOO.widget.Overlay</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.OverlayManager.html">
|
|
YAHOO.widget.OverlayManager</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.Panel.html">
|
|
YAHOO.widget.Panel</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.SimpleDialog.html">
|
|
YAHOO.widget.SimpleDialog</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="YAHOO.widget.Tooltip.html">
|
|
YAHOO.widget.Tooltip</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="module">
|
|
<h4><a href="./overview-summary.html">Files</a></h4>
|
|
<ul class="content">
|
|
|
|
<li>
|
|
<a href="overview-summary-Config.js.html">
|
|
Config.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-ContainerEffect.js.html">
|
|
ContainerEffect.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-Dialog.js.html">
|
|
Dialog.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-KeyListener.js.html">
|
|
KeyListener.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-Module.js.html">
|
|
Module.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-Overlay.js.html">
|
|
Overlay.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-OverlayManager.js.html">
|
|
OverlayManager.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-Panel.js.html">
|
|
Panel.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-SimpleDialog.js.html">
|
|
SimpleDialog.js</a>
|
|
</li>
|
|
|
|
<li>
|
|
<a href="overview-summary-Tooltip.js.html">
|
|
Tooltip.js</a>
|
|
</li>
|
|
|
|
</ul>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<div id="pri">
|
|
<div class="main">
|
|
|
|
<h2>Class YAHOO.widget.Dialog</h2>
|
|
<pre>Object
|
|
|
|
|
+--<a href='YAHOO.widget.Module.html'>YAHOO.widget.Module</a>
|
|
|
|
|
+--<a href='YAHOO.widget.Overlay.html'>YAHOO.widget.Overlay</a>
|
|
|
|
|
+--<a href='YAHOO.widget.Panel.html'>YAHOO.widget.Panel</a>
|
|
|
|
|
+--<b>YAHOO.widget.Dialog</b>
|
|
</pre>
|
|
|
|
|
|
<dl class="subclasses">
|
|
<dt>Direct Known Subclasses:</dd>
|
|
<dd>
|
|
<a href="YAHOO.widget.SimpleDialog.html">YAHOO.widget.SimpleDialog</a>
|
|
</dd>
|
|
</dl>
|
|
|
|
|
|
<hr />
|
|
|
|
<!-- Class definition -->
|
|
<div class="class-def">
|
|
<div class="class-name">
|
|
<span class="class-attribs">
|
|
|
|
</span>
|
|
<span class="class-type">class</span>
|
|
<b>YAHOO.widget.Dialog</b>
|
|
</div>
|
|
<div class="class-extends">
|
|
|
|
<dd>extends <a href='YAHOO.widget.Panel.html'>YAHOO.widget.Panel</a></dd>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<div class="meta">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<!-- ======== QUICK LINKS ======== -->
|
|
<div class="quick-links">
|
|
<strong>Quick Links:</strong>
|
|
|
|
|
|
<a href="#field_summary">Field Summary</a>
|
|
|
|
|
|
|
|
|
<a href="#constructor_summary">Constructor Summary</a>
|
|
|
|
|
|
|
|
|
<a href="#methodSummary">Method Summary</a> |
|
|
<a href="#methodDetails">Method Details</a>
|
|
|
|
</div>
|
|
<!-- ======== END QUICK LINKS ======== -->
|
|
|
|
<!-- ======== NESTED CLASS SUMMARY ======== -->
|
|
|
|
<!-- ======== END NESTED CLASS SUMMARY ======== -->
|
|
|
|
<!-- =========== FIELD SUMMARY =========== -->
|
|
|
|
<div class="section field summaries">
|
|
<h3><a name="field_summary">Field Summary</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<table border="1" cellpadding="3" cellspacing="0">
|
|
|
|
<tr>
|
|
<td class="flags">YAHOO.util.CustomEvent</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#asyncSubmitEvent">asyncSubmitEvent</a>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to asynchronous submission
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">YAHOO.util.CustomEvent</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#beforeSubmitEvent">beforeSubmitEvent</a>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to submission
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">YAHOO.util.CustomEvent</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#cancelEvent">cancelEvent</a>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired after cancel
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">YAHOO.util.CustomEvent</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#formSubmitEvent">formSubmitEvent</a>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to form-based submission
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">YAHOO.util.CustomEvent</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#manualSubmitEvent">manualSubmitEvent</a>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to manual submission
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">YAHOO.util.CustomEvent</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#submitEvent">submitEvent</a>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired after submission
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">string</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#CSS_DIALOG">CSS_DIALOG</a>
|
|
</code>
|
|
<div class="description">
|
|
Constant representing the default CSS class used for a Dialog
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<div class="section field inheritance">
|
|
<h3>Fields inherited from class <a href="YAHOO.widget.Panel.html">YAHOO.widget.Panel</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<code><a href="YAHOO.widget.Panel.html#showMaskEvent">showMaskEvent</a>, <a href="YAHOO.widget.Panel.html#hideMaskEvent">hideMaskEvent</a></code>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="section field inheritance">
|
|
<h3>Fields inherited from class <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<code><a href="YAHOO.widget.Overlay.html#beforeMoveEvent">beforeMoveEvent</a>, <a href="YAHOO.widget.Overlay.html#moveEvent">moveEvent</a></code>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="section field inheritance">
|
|
<h3>Fields inherited from class <a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<code><a href="YAHOO.widget.Module.html#element">element</a>, <a href="YAHOO.widget.Module.html#header">header</a>, <a href="YAHOO.widget.Module.html#body">body</a>, <a href="YAHOO.widget.Module.html#footer">footer</a>, <a href="YAHOO.widget.Module.html#id">id</a>, <a href="YAHOO.widget.Module.html#childNodesInDOM">childNodesInDOM</a>, <a href="YAHOO.widget.Module.html#imageRoot">imageRoot</a>, <a href="YAHOO.widget.Module.html#beforeInitEvent">beforeInitEvent</a>, <a href="YAHOO.widget.Module.html#initEvent">initEvent</a>, <a href="YAHOO.widget.Module.html#appendEvent">appendEvent</a>, <a href="YAHOO.widget.Module.html#beforeRenderEvent">beforeRenderEvent</a>, <a href="YAHOO.widget.Module.html#renderEvent">renderEvent</a>, <a href="YAHOO.widget.Module.html#changeHeaderEvent">changeHeaderEvent</a>, <a href="YAHOO.widget.Module.html#changeBodyEvent">changeBodyEvent</a>, <a href="YAHOO.widget.Module.html#changeFooterEvent">changeFooterEvent</a>, <a href="YAHOO.widget.Module.html#changeContentEvent">changeContentEvent</a>, <a href="YAHOO.widget.Module.html#destroyEvent">destroyEvent</a>, <a href="YAHOO.widget.Module.html#beforeShowEvent">beforeShowEvent</a>, <a href="YAHOO.widget.Module.html#showEvent">showEvent</a>, <a href="YAHOO.widget.Module.html#beforeHideEvent">beforeHideEvent</a>, <a href="YAHOO.widget.Module.html#hideEvent">hideEvent</a></code>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<!-- =========== END FIELD SUMMARY =========== -->
|
|
|
|
|
|
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
|
|
|
<div class="section contructor summaries">
|
|
<h3><a name="constructor_summary">Constructor Summary</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<code class="spec">
|
|
<a href="YAHOO.widget.Dialog.html#YAHOO.widget.Dialog()">YAHOO.widget.Dialog</a>
|
|
</code>
|
|
<div class="description">
|
|
Dialog is an implementation of Panel that can be used to submit form data.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- ======== END CONSTRUCTOR SUMMARY ======== -->
|
|
|
|
|
|
<!-- ========== METHOD SUMMARY =========== -->
|
|
|
|
<div class="section method summaries">
|
|
<h3><a name="methodSummary">Method Summary</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<table border="1" cellpadding="3" cellspacing="0">
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#blurButtons">blurButtons</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Blurs all the html buttons
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#cancel">cancel</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Executes the cancel of the Dialog followed by a hide.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#configButtons">configButtons</a>
|
|
(type, args, obj)
|
|
</code>
|
|
<div class="description">
|
|
The default event handler for the "buttons" configuration property
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#configOnFailure">configOnFailure</a>
|
|
(type,args,obj)
|
|
</code>
|
|
<div class="description">
|
|
The default handler fired when the "failure" property is changed.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#configOnSuccess">configOnSuccess</a>
|
|
(type,args,obj)
|
|
</code>
|
|
<div class="description">
|
|
The default handler fired when the "success" property is changed.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#doSubmit">doSubmit</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Executes a submission of the form based on the value of the postmethod property.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#focusDefaultButton">focusDefaultButton</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Sets the focus to the button that is designated as the default.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#focusFirst">focusFirst</a>
|
|
(type,args,obj)
|
|
</code>
|
|
<div class="description">
|
|
The default event handler used to focus the first field of the form when the Dialog is shown.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#focusFirstButton">focusFirstButton</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Sets the focus to the first button in the button list
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#focusLast">focusLast</a>
|
|
(type,args,obj)
|
|
</code>
|
|
<div class="description">
|
|
Sets the focus to the last button in the button or form element in the Dialog
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#focusLastButton">focusLastButton</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Sets the focus to the first button in the button list
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">object</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#getData">getData</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Returns a JSON-compatible data structure representing the data currently contained in the form.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#init">init</a>
|
|
(<string> <Element> el, <object> userConfig)
|
|
</code>
|
|
<div class="description">
|
|
The Dialog initialization method, which is executed for Dialog and all of its subclasses.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#initDefaultConfig">initDefaultConfig</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Initializes the class's configurable properties which can be changed using the Dialog's Config object (cfg).
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#initEvents">initEvents</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Initializes the custom events for Dialog which are fired automatically at appropriate times by the Dialog class.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">void</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#registerForm">registerForm</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Prepares the Dialog's internal FORM object, creating one if one is not currently present.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">Object</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#submit">submit</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Executes a submit of the Dialog followed by a hide, if validation is successful.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">string</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#toString">toString</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Returns a string representation of the object.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td class="flags">Object</td>
|
|
<td class="spec">
|
|
<code>
|
|
<a href="#validate">validate</a>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
Built-in function hook for writing a validation function that will be checked for a "true" value prior to a submit.
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="section method inheritance">
|
|
<h3>Methods inherited from class <a href="YAHOO.widget.Panel.html">YAHOO.widget.Panel</a></h3>
|
|
<div class="content">
|
|
<code><a href="YAHOO.widget.Panel.html#configClose">configClose</a>, <a href="YAHOO.widget.Panel.html#configDraggable">configDraggable</a>, <a href="YAHOO.widget.Panel.html#configUnderlay">configUnderlay</a>, <a href="YAHOO.widget.Panel.html#configModal">configModal</a>, <a href="YAHOO.widget.Panel.html#configKeyListeners">configKeyListeners</a>, <a href="YAHOO.widget.Panel.html#buildWrapper">buildWrapper</a>, <a href="YAHOO.widget.Panel.html#sizeUnderlay">sizeUnderlay</a>, <a href="YAHOO.widget.Panel.html#onDomResize">onDomResize</a>, <a href="YAHOO.widget.Panel.html#registerDragDrop">registerDragDrop</a>, <a href="YAHOO.widget.Panel.html#buildMask">buildMask</a>, <a href="YAHOO.widget.Panel.html#hideMask">hideMask</a>, <a href="YAHOO.widget.Panel.html#showMask">showMask</a>, <a href="YAHOO.widget.Panel.html#sizeMask">sizeMask</a>, <a href="YAHOO.widget.Panel.html#configHeight">configHeight</a>, <a href="YAHOO.widget.Panel.html#configWidth">configWidth</a>, <a href="YAHOO.widget.Panel.html#render">render</a></code>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="section method inheritance">
|
|
<h3>Methods inherited from class <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a></h3>
|
|
<div class="content">
|
|
<code><a href="YAHOO.widget.Overlay.html#moveTo">moveTo</a>, <a href="YAHOO.widget.Overlay.html#hideMacGeckoScrollbars">hideMacGeckoScrollbars</a>, <a href="YAHOO.widget.Overlay.html#showMacGeckoScrollbars">showMacGeckoScrollbars</a>, <a href="YAHOO.widget.Overlay.html#configVisible">configVisible</a>, <a href="YAHOO.widget.Overlay.html#doCenterOnDOMEvent">doCenterOnDOMEvent</a>, <a href="YAHOO.widget.Overlay.html#configFixedCenter">configFixedCenter</a>, <a href="YAHOO.widget.Overlay.html#configzIndex">configzIndex</a>, <a href="YAHOO.widget.Overlay.html#configXY">configXY</a>, <a href="YAHOO.widget.Overlay.html#configX">configX</a>, <a href="YAHOO.widget.Overlay.html#configY">configY</a>, <a href="YAHOO.widget.Overlay.html#showIframe">showIframe</a>, <a href="YAHOO.widget.Overlay.html#hideIframe">hideIframe</a>, <a href="YAHOO.widget.Overlay.html#configIframe">configIframe</a>, <a href="YAHOO.widget.Overlay.html#configConstrainToViewport">configConstrainToViewport</a>, <a href="YAHOO.widget.Overlay.html#configContext">configContext</a>, <a href="YAHOO.widget.Overlay.html#align">align</a>, <a href="YAHOO.widget.Overlay.html#enforceConstraints">enforceConstraints</a>, <a href="YAHOO.widget.Overlay.html#center">center</a>, <a href="YAHOO.widget.Overlay.html#syncPosition">syncPosition</a>, <a href="YAHOO.widget.Overlay.html#destroy">destroy</a></code>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="section method inheritance">
|
|
<h3>Methods inherited from class <a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a></h3>
|
|
<div class="content">
|
|
<code><a href="YAHOO.widget.Module.html#platform">platform</a>, <a href="YAHOO.widget.Module.html#browser">browser</a>, <a href="YAHOO.widget.Module.html#isSecure">isSecure</a>, <a href="YAHOO.widget.Module.html#initResizeMonitor">initResizeMonitor</a>, <a href="YAHOO.widget.Module.html#setHeader">setHeader</a>, <a href="YAHOO.widget.Module.html#appendToHeader">appendToHeader</a>, <a href="YAHOO.widget.Module.html#setBody">setBody</a>, <a href="YAHOO.widget.Module.html#appendToBody">appendToBody</a>, <a href="YAHOO.widget.Module.html#setFooter">setFooter</a>, <a href="YAHOO.widget.Module.html#appendToFooter">appendToFooter</a>, <a href="YAHOO.widget.Module.html#show">show</a>, <a href="YAHOO.widget.Module.html#hide">hide</a>, <a href="YAHOO.widget.Module.html#configMonitorResize">configMonitorResize</a></code>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- ========== END METHOD SUMMARY =========== -->
|
|
|
|
|
|
<!-- ============ FIELD DETAIL START =========== -->
|
|
|
|
<div class="section field details">
|
|
<h3><a name="field_detail">Field Detail</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
|
|
<h4><a name="asyncSubmitEvent">asyncSubmitEvent</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
YAHOO.util.CustomEvent
|
|
|
|
<strong>asyncSubmitEvent</strong>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to asynchronous submission
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="beforeSubmitEvent">beforeSubmitEvent</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
YAHOO.util.CustomEvent
|
|
|
|
<strong>beforeSubmitEvent</strong>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to submission
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="cancelEvent">cancelEvent</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
YAHOO.util.CustomEvent
|
|
|
|
<strong>cancelEvent</strong>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired after cancel
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="formSubmitEvent">formSubmitEvent</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
YAHOO.util.CustomEvent
|
|
|
|
<strong>formSubmitEvent</strong>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to form-based submission
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="manualSubmitEvent">manualSubmitEvent</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
YAHOO.util.CustomEvent
|
|
|
|
<strong>manualSubmitEvent</strong>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired prior to manual submission
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="submitEvent">submitEvent</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
YAHOO.util.CustomEvent
|
|
|
|
<strong>submitEvent</strong>
|
|
</code>
|
|
<div class="description">
|
|
CustomEvent fired after submission
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="CSS_DIALOG">CSS_DIALOG</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
string
|
|
|
|
<strong>CSS_DIALOG</strong>
|
|
</code>
|
|
<div class="description">
|
|
Constant representing the default CSS class used for a Dialog
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<!-- ============ FIELD DETAIL END =========== -->
|
|
|
|
<!-- ========= CONSTRUCTOR DETAIL START ======== -->
|
|
|
|
<div class="section constructor details">
|
|
<h3><a name="constructor_detail">Constructor Detail</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
<h4><a name="YAHOO.widget.Dialog()">YAHOO.widget.Dialog</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
<strong>YAHOO.widget.Dialog</strong>
|
|
()
|
|
</code>
|
|
<div class="description">
|
|
|
|
Dialog is an implementation of Panel that can be used to submit form data. Built-in functionality for buttons with event handlers is included, and button sets can be build dynamically, or the preincluded ones for Submit/Cancel and OK/Cancel can be utilized. Forms can be processed in 3 ways -- via an asynchronous Connection utility call, a simple form POST or GET, or manually.
|
|
|
|
|
|
|
|
<dl>
|
|
<dt>Parameters:</dt>
|
|
|
|
<dd>
|
|
<code>el</code> -
|
|
The element ID representing the Dialog <em>OR</em>
|
|
</dd>
|
|
|
|
<dd>
|
|
<code>el</code> -
|
|
The element representing the Dialog
|
|
</dd>
|
|
|
|
<dd>
|
|
<code>userConfig</code> -
|
|
The configuration object literal containing the configuration that should be set for this Dialog. See configuration documentation for more details.
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3e1f4)
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- ========= CONSTRUCTOR DETAIL END ======== -->
|
|
|
|
|
|
<!-- ============ METHOD DETAIL START ========== -->
|
|
|
|
<div class="section method details">
|
|
<h3><a name="methodDetails">Method Detail</a> <span class="top">[<a href="#top">top</a>]</span></h3>
|
|
<div class="content">
|
|
|
|
<h4><a name="blurButtons">blurButtons</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>blurButtons</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Blurs all the html buttons
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3e788)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="cancel">cancel</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>cancel</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Executes the cancel of the Dialog followed by a hide.
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3e8a8)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="configButtons">configButtons</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>configButtons</strong>
|
|
(type, args, obj)
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
The default event handler for the "buttons" configuration property
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3e9c8)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="configOnFailure">configOnFailure</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>configOnFailure</strong>
|
|
(type,args,obj)
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
The default handler fired when the "failure" property is changed. Used for asynchronous submission only.
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3eae8)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="configOnSuccess">configOnSuccess</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>configOnSuccess</strong>
|
|
(type,args,obj)
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
The default handler fired when the "success" property is changed. Used for asynchronous submission only.
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3ec08)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="doSubmit">doSubmit</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>doSubmit</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Executes a submission of the form based on the value of the postmethod property.
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3ed28)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="focusDefaultButton">focusDefaultButton</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>focusDefaultButton</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Sets the focus to the button that is designated as the default. By default, his handler is executed when the show event is fired.
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3ee48)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="focusFirst">focusFirst</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>focusFirst</strong>
|
|
(type,args,obj)
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
The default event handler used to focus the first field of the form when the Dialog is shown.
|
|
|
|
|
|
|
|
|
|
HASH(0x1d3ef68)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="focusFirstButton">focusFirstButton</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>focusFirstButton</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Sets the focus to the first button in the button list
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21104)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="focusLast">focusLast</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>focusLast</strong>
|
|
(type,args,obj)
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Sets the focus to the last button in the button or form element in the Dialog
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21224)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="focusLastButton">focusLastButton</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>focusLastButton</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Sets the focus to the first button in the button list
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21344)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="getData">getData</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
object
|
|
<strong>getData</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Returns a JSON-compatible data structure representing the data currently contained in the form.
|
|
|
|
|
|
|
|
<dl>
|
|
<dt>Returns:</dt>
|
|
<dd> A JSON object reprsenting the data of the current form.</dd>
|
|
</dl>
|
|
|
|
|
|
HASH(0x1e2144c)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="init">init</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>init</strong>
|
|
(<string> <Element> el, <object> userConfig)
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
The Dialog initialization method, which is executed for Dialog 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.
|
|
|
|
|
|
<dl>
|
|
<dt>Parameters:</dt>
|
|
|
|
<dd>
|
|
<code>el</code> -
|
|
The element ID representing the Dialog <em>OR</em>
|
|
</dd>
|
|
|
|
<dd>
|
|
<code>el</code> -
|
|
The element representing the Dialog
|
|
</dd>
|
|
|
|
<dd>
|
|
<code>userConfig</code> -
|
|
The configuration object literal containing the configuration that should be set for this Dialog. See configuration documentation for more details.
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
|
|
|
|
HASH(0x1e21554)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="initDefaultConfig">initDefaultConfig</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>initDefaultConfig</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Initializes the class's configurable properties which can be changed using the Dialog's Config object (cfg).
|
|
|
|
|
|
|
|
|
|
HASH(0x1e216f8)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="initEvents">initEvents</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>initEvents</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Initializes the custom events for Dialog which are fired automatically at appropriate times by the Dialog class.
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21818)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="registerForm">registerForm</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
void
|
|
<strong>registerForm</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Prepares the Dialog's internal FORM object, creating one if one is not currently present.
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21938)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="submit">submit</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
Object
|
|
<strong>submit</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Executes a submit of the Dialog followed by a hide, if validation is successful.
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21a58)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="toString">toString</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
string
|
|
<strong>toString</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Returns a string representation of the object.
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21b6c)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
<h4><a name="validate">validate</a></h4>
|
|
<div class="detail">
|
|
<code>
|
|
Object
|
|
<strong>validate</strong>
|
|
()
|
|
</code>
|
|
|
|
<div class="description">
|
|
|
|
Built-in function hook for writing a validation function that will be checked for a "true" value prior to a submit. This function, as implemented by default, always returns true, so it should be overridden if validation is necessary.
|
|
|
|
|
|
|
|
|
|
HASH(0x1e21c8c)
|
|
|
|
</div>
|
|
</div>
|
|
<hr />
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<!-- ============ METHOD DETAIL END ========== -->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<!-- ========= END OF CLASS DATA ========= -->
|
|
|
|
|
|
<div id="footer">
|
|
<hr />
|
|
Copyright © 2006 Yahoo! Inc. All rights reserved.
|
|
<br /><br />
|
|
Documentation generated by <a href="http://jsdoc.sourceforge.net/">
|
|
JSDoc</a>
|
|
</div>
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|