webgui/www/extras/yui/docs/YAHOO.widget.Panel.html
2008-03-25 16:13:25 +00:00

2055 lines
115 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>API: container YAHOO.widget.Panel (YUI Library)</title>
<link rel="stylesheet" type="text/css" href="assets/api.css">
<script type="text/javascript" src="assets/api-js"></script>
<script type="text/javascript" src="assets/ac-js"></script>
</head>
<body id="yahoo-com">
<div id="doc3" class="yui-t2">
<div id="hd">
<a href="http://developer.yahoo.com/yui/"><h1>Yahoo! UI Library</h1></a>
<h3>Container&nbsp; <span class="subtitle">2.5.1</span></h3>
<p>
<a href="./index.html">Yahoo! UI Library</a>
&gt; <a href="./module_container.html">container</a>
&gt; YAHOO.widget.Panel
</p>
</div>
<div id="bd">
<div id="yui-main">
<div class="yui-b">
<form name="yui-classopts-form">
<span id="classopts"><input type="checkbox" name="showprivate" id="showprivate" /> Show Private</span>
<span id="classopts"><input type="checkbox" name="showprotected" id="showprotected" /> Show Protected</span>
</form>
<h2>
Class <b>YAHOO.widget.Panel</b>
<span class="extends">
- extends <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a>
</span>
<span class="extends">
</span>
</code>
</h2>
<!-- class tree goes here -->
<dl class="subclasses">
<dt>Known Subclasses:</dd>
<dd>
<a href="YAHOO.widget.Dialog.html">YAHOO.widget.Dialog</a>
</dd>
</dl>
<div class="summary description">
Panel is an implementation of Overlay that behaves like an OS window,
with a draggable header and an optional close icon at the top right.
</div>
<div class="section constructor details">
<h3 id="constructor">Constructor</h3>
<div class="content">
<div class="detail">
<strong>YAHOO.widget.Panel</strong>
<code>
(
el
,
userConfig
)
</code>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>el
&lt;String&gt;
</code>
The element ID representing the Panel <em>OR</em>
</dd>
<dd>
<code>el
&lt;HTMLElement&gt;
</code>
The element representing the Panel
</dd>
<dd>
<code>userConfig
&lt;Object&gt;
</code>
The configuration object literal containing
the configuration that should be set for this Panel. See configuration
documentation for more details.
</dd>
</dl>
</div>
</div>
</div>
</div>
<div class="section field details">
<h3 id="properties">Properties</h3>
<div class="content">
<div class="private">
<h4><a name="property_DEFAULT_CONFIG">DEFAULT_CONFIG</a>
<code>- private final Object</code>
</h4>
<div class="detail">
<div class="description">
Constant representing the Panel's configuration properties
</div>
</div>
<hr />
</div>
<div class="private">
<h4><a name="property_EVENT_TYPES">EVENT_TYPES</a>
<code>- private final Object</code>
</h4>
<div class="detail">
<div class="description">
Constant representing the name of the Panel's events
</div>
</div>
<hr />
</div>
<div class="">
<h4><a name="property_YAHOO.widget.Panel.CSS_PANEL">YAHOO.widget.Panel.CSS_PANEL</a>
<code>- static final String</code>
</h4>
<div class="detail">
<div class="description">
Constant representing the default CSS class used for a Panel
</div>
</div>
<hr />
</div>
<div class="">
<h4><a name="property_YAHOO.widget.Panel.CSS_PANEL_CONTAINER">YAHOO.widget.Panel.CSS_PANEL_CONTAINER</a>
<code>- static final String</code>
</h4>
<div class="detail">
<div class="description">
Constant representing the default CSS class used for a Panel's
wrapping container
</div>
</div>
<hr />
</div>
<div class="">
<h4><a name="property_YAHOO.widget.Panel.FOCUSABLE">YAHOO.widget.Panel.FOCUSABLE</a>
<code>- static Array</code>
</h4>
<div class="detail">
<div class="description">
Constant representing the default set of focusable elements
on the pagewhich Modal Panels will prevent access to, when
the modal mask is displayed
</div>
</div>
<hr />
</div>
</div>
</div>
<div class="section field inheritance">
<h4>Properties inherited from <a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a>:</h4>
<div class="content">
<code>
<a class="" href="YAHOO.widget.Module.html#property_body">body</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_browser">browser</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_cfg">cfg</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_contructor">contructor</a><span class="">,</span>
<a class="private" href="YAHOO.widget.Module.html#property_DEFAULT_CONFIG">DEFAULT_CONFIG</a><span class="private">,</span>
<a class="" href="YAHOO.widget.Module.html#property_element">element</a><span class="">,</span>
<a class="private" href="YAHOO.widget.Module.html#property_EVENT_TYPES">EVENT_TYPES</a><span class="private">,</span>
<a class="" href="YAHOO.widget.Module.html#property_footer">footer</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_header">header</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_id">id</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_imageRoot">imageRoot</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_isSecure">isSecure</a><span class="">,</span>
<a class="" href="YAHOO.widget.Module.html#property_platform">platform</a>
</code>
</div>
</div>
<div class="section field inheritance">
<h4>Properties inherited from <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a>:</h4>
<div class="content">
<code>
<a class="private" href="YAHOO.widget.Overlay.html#property_DEFAULT_CONFIG">DEFAULT_CONFIG</a><span class="private">,</span>
<a class="private" href="YAHOO.widget.Overlay.html#property_EVENT_TYPES">EVENT_TYPES</a><span class="private">,</span>
<a class="private" href="YAHOO.widget.Overlay.html#property_YAHOO.widget.Overlay._initialized">YAHOO.widget.Overlay._initialized</a>
</code>
</div>
</div>
<div class="section method details">
<h3 id="methods">Methods</h3>
<div class="content">
<div class="protected">
<h4>
<a name="method__addFocusHandlers">_addFocusHandlers</a></h4>
<div class="detail">
<code>
protected
void
<strong>_addFocusHandlers</strong>
(
p_sType
,
p_aArgs
)
</code>
<div class="description">
"showMask" event handler that adds a "focus" event handler to all
focusable elements in the document to enforce a Panel instance's
modality from being compromised.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>p_sType &lt;String&gt;</code>
Custom event type
</dd>
<dd>
<code>p_aArgs &lt;Array&gt;</code>
Custom event arguments
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="private">
<h4>
<a name="method__onElementFocus">_onElementFocus</a></h4>
<div class="detail">
<code>
private
void
<strong>_onElementFocus</strong>
(
e
)
</code>
<div class="description">
"focus" event handler for a focuable element. Used to automatically
blur the element when it receives focus to ensure that a Panel
instance's modality is not compromised.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>e &lt;Event&gt;</code>
The DOM event object
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="protected">
<h4>
<a name="method__removeFocusHandlers">_removeFocusHandlers</a></h4>
<div class="detail">
<code>
protected
void
<strong>_removeFocusHandlers</strong>
(
p_sType
,
p_aArgs
)
</code>
<div class="description">
"hideMask" event handler that removes all "focus" event handlers added
by the "addFocusEventHandlers" method.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>p_sType &lt;String&gt;</code>
Event type
</dd>
<dd>
<code>p_aArgs &lt;Array&gt;</code>
Event Arguments
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_buildMask">buildMask</a></h4>
<div class="detail">
<code>
void
<strong>buildMask</strong>
(
)
</code>
<div class="description">
Builds the mask that is laid over the document when the Panel is
configured to be modal.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_buildWrapper">buildWrapper</a></h4>
<div class="detail">
<code>
void
<strong>buildWrapper</strong>
(
)
</code>
<div class="description">
Builds the wrapping container around the Panel that is used for
positioning the shadow and matte underlays. The container element is
assigned to a local instance variable called container, and the
element is reinserted inside of it.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configClose">configClose</a></h4>
<div class="detail">
<code>
void
<strong>configClose</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "close" property is changed.
The method controls the appending or hiding of the close icon at the
top right of the Panel.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configDraggable">configDraggable</a></h4>
<div class="detail">
<code>
void
<strong>configDraggable</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "draggable" property
is changed.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configHeight">configHeight</a></h4>
<div class="detail">
<code>
void
<strong>configHeight</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "height" property is changed.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configKeyListeners">configKeyListeners</a></h4>
<div class="detail">
<code>
void
<strong>configKeyListeners</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "keylisteners" property
is changed.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configModal">configModal</a></h4>
<div class="detail">
<code>
void
<strong>configModal</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "modal" property is
changed. This handler subscribes or unsubscribes to the show and hide
events to handle the display or hide of the modality mask.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configUnderlay">configUnderlay</a></h4>
<div class="detail">
<code>
void
<strong>configUnderlay</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "underlay" property
is changed.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configWidth">configWidth</a></h4>
<div class="detail">
<code>
void
<strong>configWidth</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "width" property is changed.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_configzIndex">configzIndex</a></h4>
<div class="detail">
<code>
void
<strong>configzIndex</strong>
(
type
,
args
,
obj
)
</code>
<div class="description">
The default event handler fired when the "zIndex" property is changed.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>type &lt;String&gt;</code>
The CustomEvent type (usually the property name)
</dd>
<dd>
<code>args &lt;Object[]&gt;</code>
The CustomEvent arguments. For configuration
handlers, args[0] will equal the newly applied value for the property.
</dd>
<dd>
<code>obj &lt;Object&gt;</code>
The scope object. For configuration handlers,
this will usually equal the owner.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_destroy">destroy</a></h4>
<div class="detail">
<code>
void
<strong>destroy</strong>
(
)
</code>
<div class="description">
Removes the Panel element from the DOM and sets all child elements
to null.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_hideMask">hideMask</a></h4>
<div class="detail">
<code>
void
<strong>hideMask</strong>
(
)
</code>
<div class="description">
Hides the modality mask.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_init">init</a></h4>
<div class="detail">
<code>
void
<strong>init</strong>
(
el
,
userConfig
)
</code>
<div class="description">
The Overlay initialization method, which is executed for Overlay 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.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>el &lt;String&gt;</code>
The element ID representing the Overlay <em>OR</em>
</dd>
<dd>
<code>el &lt;HTMLElement&gt;</code>
The element representing the Overlay
</dd>
<dd>
<code>userConfig &lt;Object&gt;</code>
The configuration object literal
containing the configuration that should be set for this Overlay.
See configuration documentation for more details.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_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 Panel's Config object (cfg).
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_initEvents">initEvents</a></h4>
<div class="detail">
<code>
void
<strong>initEvents</strong>
(
)
</code>
<div class="description">
Initializes the custom events for Module which are fired
automatically at appropriate times by the Module class.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_registerDragDrop">registerDragDrop</a></h4>
<div class="detail">
<code>
void
<strong>registerDragDrop</strong>
(
)
</code>
<div class="description">
Registers the Panel's header for drag & drop capability.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_removeMask">removeMask</a></h4>
<div class="detail">
<code>
void
<strong>removeMask</strong>
(
)
</code>
<div class="description">
Removes the modality mask.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_render">render</a></h4>
<div class="detail">
<code>
boolean
<strong>render</strong>
(
appendToNode
)
</code>
<div class="description">
Renders the Panel by inserting the elements that are not already in
the main Panel into their correct places. Optionally appends the
Panel to the specified node prior to the render's execution. NOTE:
For Panels without existing markup, the appendToNode argument is
REQUIRED. If this argument is ommitted and the current element is
not present in the document, the function will return false,
indicating that the render was a failure.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>appendToNode &lt;String&gt;</code>
The element id to which the Module
should be appended to prior to rendering <em>OR</em>
</dd>
<dd>
<code>appendToNode &lt;HTMLElement&gt;</code>
The element to which the Module
should be appended to prior to rendering
</dd>
</dl>
<dl>
<dt>Returns:
<code>
boolean
</code></dt>
<dd>Success or failure of the render</dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_showMask">showMask</a></h4>
<div class="detail">
<code>
void
<strong>showMask</strong>
(
)
</code>
<div class="description">
Shows the modality mask.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_sizeMask">sizeMask</a></h4>
<div class="detail">
<code>
void
<strong>sizeMask</strong>
(
)
</code>
<div class="description">
Sets the size of the modality mask to cover the entire scrollable
area of the document
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_sizeUnderlay">sizeUnderlay</a></h4>
<div class="detail">
<code>
void
<strong>sizeUnderlay</strong>
(
)
</code>
<div class="description">
Adjusts the size of the shadow based on the size of the element.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_stackMask">stackMask</a></h4>
<div class="detail">
<code>
void
<strong>stackMask</strong>
(
)
</code>
<div class="description">
Sets the zindex of the mask, if it exists, based on the zindex of
the Panel element. The zindex of the mask is set to be one less
than the Panel element's zindex.
<p>NOTE: This method will not bump up the zindex of the Panel
to ensure that the mask has a non-negative zindex. If you require the
mask zindex to be 0 or higher, the zindex of the Panel
should be set to a value higher than 0, before this method is called.
</p>
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="method_toString">toString</a></h4>
<div class="detail">
<code>
String
<strong>toString</strong>
(
)
</code>
<div class="description">
Returns a String representation of the object.
</div>
<div class="description">
<dl>
<dt>Returns:
<code>
String
</code></dt>
<dd>The string representation of the Panel.</dd>
</dl>
</div>
</div>
<hr />
</div>
</div>
</div>
<div class="section field inheritance">
<h4>Methods inherited from <a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a>:</h4>
<div class="content">
<code>
<a class="protected" href="YAHOO.widget.Module.html#method__addToParent">_addToParent</a><span class="protected">,</span> <a class="protected" href="YAHOO.widget.Module.html#method__initResizeMonitor">_initResizeMonitor</a><span class="protected">,</span> <a class="private" href="YAHOO.widget.Module.html#method__supportsCWResize">_supportsCWResize</a><span class="private">,</span> <a class="" href="YAHOO.widget.Module.html#method_appendToBody">appendToBody</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_appendToFooter">appendToFooter</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_appendToHeader">appendToHeader</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_configMonitorResize">configMonitorResize</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_configVisible">configVisible</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_destroy">destroy</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_hide">hide</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_init">init</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_initDefaultConfig">initDefaultConfig</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_initEvents">initEvents</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_initResizeMonitor">initResizeMonitor</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_onDomResize">onDomResize</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_render">render</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_setBody">setBody</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_setFooter">setFooter</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_setHeader">setHeader</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_show">show</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#method_toString">toString</a>
</code>
</div>
</div>
<div class="section field inheritance">
<h4>Methods inherited from <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a>:</h4>
<div class="content">
<code>
<a class="protected" href="YAHOO.widget.Overlay.html#method__primeXYFromDOM">_primeXYFromDOM</a><span class="protected">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_align">align</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_bringToTop">bringToTop</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_center">center</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configConstrainToViewport">configConstrainToViewport</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configContext">configContext</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configFixedCenter">configFixedCenter</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configHeight">configHeight</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configIframe">configIframe</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configVisible">configVisible</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configWidth">configWidth</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configX">configX</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configXY">configXY</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configY">configY</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_configzIndex">configzIndex</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_destroy">destroy</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_doCenterOnDOMEvent">doCenterOnDOMEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_enforceConstraints">enforceConstraints</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_getConstrainedXY">getConstrainedXY</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_hideIframe">hideIframe</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_hideMacGeckoScrollbars">hideMacGeckoScrollbars</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_init">init</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_initDefaultConfig">initDefaultConfig</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_initEvents">initEvents</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_moveTo">moveTo</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_onDomResize">onDomResize</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_showIframe">showIframe</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_showMacGeckoScrollbars">showMacGeckoScrollbars</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_stackIframe">stackIframe</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_syncIframe">syncIframe</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_syncPosition">syncPosition</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#method_toString">toString</a>
</code>
</div>
</div>
<div class="section method details">
<h3 id="events">Events</h3>
<div class="content">
<div class="">
<h4>
<a name="event_dragEvent">dragEvent</a></h4>
<div class="detail">
<code>
<strong>dragEvent</strong>
(
)
</code>
<div class="description">
CustomEvent when the Panel is dragged
</div>
<div class="description">
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="event_hideMaskEvent">hideMaskEvent</a></h4>
<div class="detail">
<code>
<strong>hideMaskEvent</strong>
(
)
</code>
<div class="description">
CustomEvent fired after the modality mask is hidden
</div>
<div class="description">
</div>
</div>
<hr />
</div>
<div class="">
<h4>
<a name="event_showMaskEvent">showMaskEvent</a></h4>
<div class="detail">
<code>
<strong>showMaskEvent</strong>
(
)
</code>
<div class="description">
CustomEvent fired after the modality mask is shown
</div>
<div class="description">
</div>
</div>
<hr />
</div>
</div>
</div>
<div class="section field inheritance">
<h4>Events inherited from <a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a>:</h4>
<div class="content">
<code>
<a class="" href="YAHOO.widget.Module.html#event_appendEvent">appendEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_beforeHideEvent">beforeHideEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_beforeInitEvent">beforeInitEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_beforeRenderEvent">beforeRenderEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_beforeShowEvent">beforeShowEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_changeBodyEvent">changeBodyEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_changeContentEvent">changeContentEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_changeFooterEvent">changeFooterEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_changeHeaderEvent">changeHeaderEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_destroyEvent">destroyEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#event_hideEvent">hideEvent</a> <a class="" href="YAHOO.widget.Module.html#event_initEvent">initEvent</a> <a class="" href="YAHOO.widget.Module.html#event_renderEvent">renderEvent</a> <a class="" href="YAHOO.widget.Module.html#event_showEvent">showEvent</a> <a class="" href="YAHOO.widget.Module.html#event_YAHOO.widget.Module.textResizeEvent">YAHOO.widget.Module.textResizeEvent</a>
</code>
</div>
</div>
<div class="section field inheritance">
<h4>Events inherited from <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a>:</h4>
<div class="content">
<code>
<a class="" href="YAHOO.widget.Overlay.html#event_beforeMoveEvent">beforeMoveEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#event_moveEvent">moveEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#event_YAHOO.widget.Overlay.windowResizeEvent">YAHOO.widget.Overlay.windowResizeEvent</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#event_YAHOO.widget.Overlay.windowScrollEvent">YAHOO.widget.Overlay.windowScrollEvent</a><span class="">,</span>
</code>
</div>
</div>
<div class="section field details">
<h3 id="configattributes">Configuration Attributes</h3>
<div class="content">
<div class="">
<h4><a name="config_close">close</a>
<code>- Boolean</code>
</h4>
<div class="detail">
<div class="description">
True if the Panel should display a "close" button
</div>
</div>
<div class="default">
Default Value: true
</div>
<hr />
</div>
<div class="">
<h4><a name="config_draggable">draggable</a>
<code>- Boolean</code>
</h4>
<div class="detail">
<div class="description">
Boolean specifying if the Panel should be draggable. The default
value is "true" if the Drag and Drop utility is included,
otherwise it is "false." <strong>PLEASE NOTE:</strong> There is a
known issue in IE 6 (Strict Mode and Quirks Mode) and IE 7
(Quirks Mode) where Panels that either don't have a value set for
their "width" configuration property, or their "width"
configuration property is set to "auto" will only be draggable by
placing the mouse on the text of the Panel's header element.
To fix this bug, draggable Panels missing a value for their
"width" configuration property, or whose "width" configuration
property is set to "auto" will have it set to the value of
their root HTML element's offsetWidth before they are made
visible. The calculated width is then removed when the Panel is
hidden. <em>This fix is only applied to draggable Panels in IE 6
(Strict Mode and Quirks Mode) and IE 7 (Quirks Mode)</em>. For
more information on this issue see:
SourceForge bugs #1726972 and #1589210.
</div>
</div>
<div class="default">
Default Value: true
</div>
<hr />
</div>
<div class="">
<h4><a name="config_dragOnly">dragOnly</a>
<code>- Boolean</code>
</h4>
<div class="detail">
<div class="description">
Boolean specifying if the draggable Panel should be drag only, not interacting with drop
targets on the page.
<p>
When set to true, draggable Panels will not check to see if they are over drop targets,
or fire the DragDrop events required to support drop target interaction (onDragEnter,
onDragOver, onDragOut, onDragDrop etc.).
If the Panel is not designed to be dropped on any target elements on the page, then this
flag can be set to true to improve performance.
</p>
<p>
When set to false, all drop target related events will be fired.
</p>
<p>
The property is set to false by default to maintain backwards compatibility but should be
set to true if drop target interaction is not required for the Panel, to improve performance.</p>
</div>
</div>
<div class="default">
Default Value: false
</div>
<hr />
</div>
<div class="">
<h4><a name="config_keylisteners">keylisteners</a>
<code>- YAHOO.util.KeyListener[]</code>
</h4>
<div class="detail">
<div class="description">
A KeyListener (or array of KeyListeners) that will be enabled
when the Panel is shown, and disabled when the Panel is hidden.
</div>
</div>
<div class="default">
Default Value: null
</div>
<hr />
</div>
<div class="">
<h4><a name="config_modal">modal</a>
<code>- Boolean</code>
</h4>
<div class="detail">
<div class="description">
True if the Panel should be displayed in a modal fashion,
automatically creating a transparent mask over the document that
will not be removed until the Panel is dismissed.
</div>
</div>
<div class="default">
Default Value: false
</div>
<hr />
</div>
<div class="">
<h4><a name="config_underlay">underlay</a>
<code>- String</code>
</h4>
<div class="detail">
<div class="description">
Sets the type of underlay to display for the Panel. Valid values
are "shadow," "matte," and "none". <strong>PLEASE NOTE:</strong>
The creation of the underlay element is deferred until the Panel
is initially made visible. For Gecko-based browsers on Mac
OS X the underlay elment is always created as it is used as a
shim to prevent Aqua scrollbars below a Panel instance from poking
through it (See SourceForge bug #836476).
</div>
</div>
<div class="default">
Default Value: shadow
</div>
<hr />
</div>
</div>
</div>
<div class="section field inheritance">
<h4>Configuration attributes inherited from <a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a>:</h4>
<div class="content">
<code>
<a class="" href="YAHOO.widget.Module.html#config_appendtodocumentbody">appendtodocumentbody</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#config_effect">effect</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#config_monitorresize">monitorresize</a><span class="">,</span> <a class="" href="YAHOO.widget.Module.html#config_visible">visible</a><span class="">,</span>
</code>
</div>
</div>
<div class="section field inheritance">
<h4>Configuration attributes inherited from <a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a>:</h4>
<div class="content">
<code>
<a class="" href="YAHOO.widget.Overlay.html#config_constraintoviewport">constraintoviewport</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_context">context</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_fixedcenter">fixedcenter</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_height">height</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_iframe">iframe</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_width">width</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_x">x</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_xy">xy</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_y">y</a><span class="">,</span> <a class="" href="YAHOO.widget.Overlay.html#config_zIndex">zIndex</a><span class="">,</span>
</code>
</div>
</div>
</div>
</div>
<div class="yui-b">
<div class="nav">
<div class="module">
<h4>Modules</h4>
<ul class="content">
<li class=""><a href="module_animation.html">animation</a></li>
<li class=""><a href="module_autocomplete.html">autocomplete</a></li>
<li class=""><a href="module_button.html">button</a></li>
<li class=""><a href="module_calendar.html">calendar</a></li>
<li class=""><a href="module_charts.html">charts</a></li>
<li class=""><a href="module_colorpicker.html">colorpicker</a></li>
<li class=""><a href="module_connection.html">connection</a></li>
<li class="selected"><a href="module_container.html">container</a></li>
<li class=""><a href="module_cookie.html">cookie</a></li>
<li class=""><a href="module_datasource.html">datasource</a></li>
<li class=""><a href="module_datatable.html">datatable</a></li>
<li class=""><a href="module_dom.html">dom</a></li>
<li class=""><a href="module_dragdrop.html">dragdrop</a></li>
<li class=""><a href="module_editor.html">editor</a></li>
<li class=""><a href="module_element.html">element</a></li>
<li class=""><a href="module_event.html">event</a></li>
<li class=""><a href="module_get.html">get</a></li>
<li class=""><a href="module_history.html">history</a></li>
<li class=""><a href="module_imagecropper.html">imagecropper</a></li>
<li class=""><a href="module_imageloader.html">imageloader</a></li>
<li class=""><a href="module_json.html">json</a></li>
<li class=""><a href="module_layout.html">layout</a></li>
<li class=""><a href="module_logger.html">logger</a></li>
<li class=""><a href="module_menu.html">menu</a></li>
<li class=""><a href="module_profiler.html">profiler</a></li>
<li class=""><a href="module_profilerviewer.html">profilerviewer</a></li>
<li class=""><a href="module_resize.html">resize</a></li>
<li class=""><a href="module_selector.html">selector</a></li>
<li class=""><a href="module_slider.html">slider</a></li>
<li class=""><a href="module_tabview.html">tabview</a></li>
<li class=""><a href="module_treeview.html">treeview</a></li>
<li class=""><a href="module_uploader.html">uploader</a></li>
<li class=""><a href="module_yahoo.html">yahoo</a></li>
<li class=""><a href="module_yuiloader.html">yuiloader</a></li>
<li class=""><a href="module_yuitest.html">yuitest</a></li>
</ul>
</div>
<div class="module">
<h4>Classes</h4>
<ul class="content">
<li class=""><a href="YAHOO.util.Config.html">YAHOO.util.Config</a></li>
<li class=""><a href="YAHOO.widget.ContainerEffect.html">YAHOO.widget.ContainerEffect</a></li>
<li class=""><a href="YAHOO.widget.Dialog.html">YAHOO.widget.Dialog</a></li>
<li class=""><a href="YAHOO.widget.Module.html">YAHOO.widget.Module</a></li>
<li class=""><a href="YAHOO.widget.Overlay.html">YAHOO.widget.Overlay</a></li>
<li class=""><a href="YAHOO.widget.OverlayManager.html">YAHOO.widget.OverlayManager</a></li>
<li class="selected"><a href="YAHOO.widget.Panel.html">YAHOO.widget.Panel</a></li>
<li class=""><a href="YAHOO.widget.SimpleDialog.html">YAHOO.widget.SimpleDialog</a></li>
<li class=""><a href="YAHOO.widget.Tooltip.html">YAHOO.widget.Tooltip</a></li>
</ul>
</div>
<div class="module">
<h4>Files</h4>
<ul class="content">
<li class=""><a href="Config.js.html">Config.js</a></li>
<li class=""><a href="ContainerEffect.js.html">ContainerEffect.js</a></li>
<li class=""><a href="Dialog.js.html">Dialog.js</a></li>
<li class=""><a href="Module.js.html">Module.js</a></li>
<li class=""><a href="Overlay.js.html">Overlay.js</a></li>
<li class=""><a href="OverlayManager.js.html">OverlayManager.js</a></li>
<li class=""><a href="Panel.js.html">Panel.js</a></li>
<li class=""><a href="SimpleDialog.js.html">SimpleDialog.js</a></li>
<li class=""><a href="Tooltip.js.html">Tooltip.js</a></li>
</ul>
</div>
<div class="module">
<h4>Properties</h4>
<ul class="content">
<li class="private"><a href="#property_DEFAULT_CONFIG">DEFAULT_CONFIG</a>
<!--<code>&lt;Array&gt;</code>-->
</li>
<li class="private"><a href="#property_EVENT_TYPES">EVENT_TYPES</a>
<!--<code>&lt;Array&gt;</code>-->
</li>
<li class=""><a href="#property_YAHOO.widget.Panel.CSS_PANEL">YAHOO.widget.Panel.CSS_PANEL</a>
<!--<code>&lt;Array&gt;</code>-->
</li>
<li class=""><a href="#property_YAHOO.widget.Panel.CSS_PANEL_CONTAINER">YAHOO.widget.Panel.CSS_PANEL_CONTAINER</a>
<!--<code>&lt;Array&gt;</code>-->
</li>
<li class=""><a href="#property_YAHOO.widget.Panel.FOCUSABLE">YAHOO.widget.Panel.FOCUSABLE</a>
<!--<code>&lt;Array&gt;</code>-->
</li>
</ul>
</div>
<div class="module">
<h4>Methods</h4>
<ul class="content">
<li class="protected"><!--<code>void</code>-->
<a href="#method__addFocusHandlers">_addFocusHandlers</a>
</li>
<li class="private"><!--<code>void</code>-->
<a href="#method__onElementFocus">_onElementFocus</a>
</li>
<li class="protected"><!--<code>void</code>-->
<a href="#method__removeFocusHandlers">_removeFocusHandlers</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_buildMask">buildMask</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_buildWrapper">buildWrapper</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configClose">configClose</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configDraggable">configDraggable</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configHeight">configHeight</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configKeyListeners">configKeyListeners</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configModal">configModal</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configUnderlay">configUnderlay</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configWidth">configWidth</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_configzIndex">configzIndex</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_destroy">destroy</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_hideMask">hideMask</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_init">init</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_initDefaultConfig">initDefaultConfig</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_initEvents">initEvents</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_registerDragDrop">registerDragDrop</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_removeMask">removeMask</a>
</li>
<li class=""><!--<code>boolean</code>-->
<a href="#method_render">render</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_showMask">showMask</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_sizeMask">sizeMask</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_sizeUnderlay">sizeUnderlay</a>
</li>
<li class=""><!--<code>void</code>-->
<a href="#method_stackMask">stackMask</a>
</li>
<li class=""><!--<code>String</code>-->
<a href="#method_toString">toString</a>
</li>
</ul>
</div>
<div class="module">
<h4>Events</h4>
<ul class="content">
<li class="">
<a href="#event_dragEvent">dragEvent</a>
</li>
<li class="">
<a href="#event_hideMaskEvent">hideMaskEvent</a>
</li>
<li class="">
<a href="#event_showMaskEvent">showMaskEvent</a>
</li>
</ul>
</div>
<div class="module">
<h4>Configuration Attributes</h4>
<ul class="content">
<li class="">
<a href="#config_close">close</a>
</li>
<li class="">
<a href="#config_draggable">draggable</a>
</li>
<li class="">
<a href="#config_dragOnly">dragOnly</a>
</li>
<li class="">
<a href="#config_keylisteners">keylisteners</a>
</li>
<li class="">
<a href="#config_modal">modal</a>
</li>
<li class="">
<a href="#config_underlay">underlay</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div id="ft">
<hr />
Copyright &copy; 2007 Yahoo! Inc. All rights reserved.
</div>
</div>
</body>
</html>