webgui/www/extras/yui/docs/YAHOO.html
JT Smith cfd09a5cb6 upgraded to yui 0.12.0
upgraded to yui-ext 0.33 rc2
2006-11-28 02:23:34 +00:00

384 lines
18 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>API: yahoo YAHOO (YUI Library)</title>
<link rel="stylesheet" type="text/css" href="assets/reset-fonts-grids-min.css">
<link rel="stylesheet" type="text/css" href="assets/api.css">
</head>
<body id="yahoo-com">
<div id="doc3" class="yui-t2">
<div id="hd">
<h1>Yahoo! UI Library</h1>
<h3>YAHOO Global&nbsp;</h3>
<p>
<a href="./index.html">Yahoo! UI Library</a>
&gt; <a href="./module_yahoo.html">yahoo</a>
&gt; YAHOO
</p>
</div>
<div id="bd">
<div id="yui-main">
<div class="yui-b">
<h2>
<code>static</code>
Class <b>YAHOO</b>
<span class="extends">
</span>
<span class="extends">
</span>
</code>
</h2>
<!-- class tree goes here -->
<div class="summary description">
The YAHOO global namespace object
</div>
<div class="section method details">
<h3><a name="methodDetails">Methods</a></h3>
<div class="content">
<h4>
<a name="augment">augment</a></h4>
<div class="detail">
<code>
static
void
<strong>augment</strong>
(
r
,
s
,
arguments
)
</code>
<div class="description">
Applies all prototype properties in the supplier to the receiver if the
receiver does not have these properties yet. Optionally, one or more
methods/properties can be specified (as additional parameters). This
option will overwrite the property if receiver has it already.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>r &lt;Function&gt;</code>
the object to receive the augmentation
</dd>
<dd>
<code>s &lt;Function&gt;</code>
the object that supplies the properties to augment
</dd>
<dd>
<code>arguments &lt;String*&gt;</code>
zero or more properties methods to augment the
receiver with. If none specified, everything
in the supplier will be used unless it would
overwrite an existing property in the receiver
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
<h4>
<a name="extend">extend</a></h4>
<div class="detail">
<code>
static
void
<strong>extend</strong>
(
subc
,
superc
,
overrides
)
</code>
<div class="description">
Utility to set up the prototype, constructor and superclass properties to
support an inheritance strategy that can chain constructors and methods.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>subc &lt;Function&gt;</code>
the object to modify
</dd>
<dd>
<code>superc &lt;Function&gt;</code>
the object to inherit
</dd>
<dd>
<code>overrides &lt;String[]&gt;</code>
additional properties/methods to add to the
subclass prototype. These will override the
matching items obtained from the superclass
if present.
</dd>
</dl>
<dl>
<dt>Returns:
<code>
void
</code></dt>
<dd></dd>
</dl>
</div>
</div>
<hr />
<h4>
<a name="log">log</a></h4>
<div class="detail">
<code>
static
Boolean
<strong>log</strong>
(
msg
,
cat
,
src
)
</code>
<div class="description">
Uses YAHOO.widget.Logger to output a log message, if the widget is available.
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>msg &lt;String&gt;</code>
The message to log.
</dd>
<dd>
<code>cat &lt;String&gt;</code>
The log category for the message. Default
categories are "info", "warn", "error", time".
Custom categories can be used as well. (opt)
</dd>
<dd>
<code>src &lt;String&gt;</code>
The source of the the message (opt)
</dd>
</dl>
<dl>
<dt>Returns:
<code>
Boolean
</code></dt>
<dd>True if the log operation was successful.</dd>
</dl>
</div>
</div>
<hr />
<h4>
<a name="namespace">namespace</a></h4>
<div class="detail">
<code>
static
Object
<strong>namespace</strong>
(
arguments
)
</code>
<div class="description">
Returns the namespace specified and creates it if it doesn't exist
<pre>
YAHOO.namespace("property.package");
YAHOO.namespace("YAHOO.property.package");
</pre>
Either of the above would create YAHOO.property, then
YAHOO.property.package
Be careful when naming packages. Reserved words may work in some browsers
and not others. For instance, the following will fail in Safari:
<pre>
YAHOO.namespace("really.long.nested.namespace");
</pre>
This fails because "long" is a future reserved word in ECMAScript
</div>
<div class="description">
<dl>
<dt>Parameters:</dt>
<dd>
<code>arguments &lt;String*&gt;</code>
1-n namespaces to create
</dd>
</dl>
<dl>
<dt>Returns:
<code>
Object
</code></dt>
<dd>A reference to the last namespace object created</dd>
</dl>
</div>
</div>
<hr />
</div>
</div>
</div>
</div>
<div class="yui-b">
<div class="nav">
<div class="module">
<h4>Modules</h4>
<ul class="content">
<li><a href="module_animation.html">animation</a></li>
<li><a href="module_autocomplete.html">autocomplete</a></li>
<li><a href="module_calendar.html">calendar</a></li>
<li><a href="module_connection.html">connection</a></li>
<li><a href="module_container.html">container</a></li>
<li><a href="module_dom.html">dom</a></li>
<li><a href="module_dragdrop.html">dragdrop</a></li>
<li><a href="module_event.html">event</a></li>
<li><a href="module_logger.html">logger</a></li>
<li><a href="module_menu.html">menu</a></li>
<li><a href="module_slider.html">slider</a></li>
<li><a href="module_tabview.html">tabview</a></li>
<li><a href="module_treeview.html">treeview</a></li>
<li><a href="module_yahoo.html">yahoo</a></li>
</ul>
</div>
<div class="module">
<h4>Classes</h4>
<ul class="content">
<li><a href="YAHOO.html">YAHOO</a></li>
</ul>
</div>
<div class="module">
<h4>Files</h4>
<ul class="content">
<li><a href="YAHOO.js.html">YAHOO.js</a></li>
</ul>
</div>
<div class="module">
<h4>Methods</h4>
<ul class="content">
<li><!--<code>void</code>-->
<a href="#augment">augment</a>
</li>
<li><!--<code>void</code>-->
<a href="#extend">extend</a>
</li>
<li><!--<code>Boolean</code>-->
<a href="#log">log</a>
</li>
<li><!--<code>Object</code>-->
<a href="#namespace">namespace</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div id="ft">
<hr />
Copyright &copy; 2006 Yahoo! Inc. All rights reserved.
</div>
</div>
</body>
</html>