Widget-PositionExt.js.html revision fe3d85d0497fb48855f3fd2350bd8f795e82b4e4
<head>
</head>
<body id="yahoo-com">
<div id="doc3" class="yui-t2">
<div id="hd">
<h3>widget-position-ext <span class="subtitle">3.0.0</span></h3>
> Widget-PositionExt.js (source view)
<form onsubmit="return false">
<div id="propertysearch">
Search: <input autocomplete="off" id="searchinput" />
<div id="searchresults">
</div>
</div>
</form>
</div>
<div id="bd">
<div id="yui-main">
<div class="yui-b">
<form action="#" name="yui-classopts-form" method="get" id="yui-classopts-form">
<fieldset>
<legend>Filters</legend>
<span class="classopts"><input type="checkbox" name="show_private" id="show_private" /> <label for="show_private">Show Private</label></span>
<span class="classopts"><input type="checkbox" name="show_protected" id="show_protected" /> <label for="show_protected">Show Protected</label></span>
<span class="classopts"><input type="checkbox" name="show_deprecated" id="show_deprecated" /> <label for="show_deprecated">Show Deprecated</label></span>
</fieldset>
</form>
<div id="srcout">
<style>
#doc3 .classopts { display:none; }
</style>
<div class="highlight"><pre><span class="cm">/**</span>
<span class="cm"> * Provides extended/advanced XY positioning support for Widgets, through an extension.</span>
<span class="cm"> *</span>
<span class="cm"> * It builds on top of the widget-position module, to provide alignmentment and centering support.</span>
<span class="cm"> * Future releases aim to add constrained and fixed positioning support.</span>
<span class="cm"> *</span>
<span class="cm"> * @module widget-position-ext</span>
<span class="cm"> */</span>
<span class="kd">var</span> <span class="nx">L</span> <span class="o">=</span> <span class="nx">Y</span><span class="p">.</span><span class="nx">Lang</span><span class="p">,</span>
<span class="nx">ALIGN</span> <span class="o">=</span> <span class="s2">"align"</span><span class="p">,</span>
<span class="nx">BINDUI</span> <span class="o">=</span> <span class="s2">"bindUI"</span><span class="p">,</span>
<span class="nx">SYNCUI</span> <span class="o">=</span> <span class="s2">"syncUI"</span><span class="p">,</span>
<span class="nx">OFFSET_WIDTH</span> <span class="o">=</span> <span class="s2">"offsetWidth"</span><span class="p">,</span>
<span class="nx">OFFSET_HEIGHT</span> <span class="o">=</span> <span class="s2">"offsetHeight"</span><span class="p">,</span>
<span class="nx">VIEWPORT_REGION</span> <span class="o">=</span> <span class="s2">"viewportRegion"</span><span class="p">,</span>
<span class="nx">REGION</span> <span class="o">=</span> <span class="s2">"region"</span><span class="p">,</span>
<span class="nx">AlignChange</span> <span class="o">=</span> <span class="s2">"alignChange"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Widget extension, which can be used to add extended XY positioning support to the base Widget class,</span>
<span class="cm"> * through the <a href="Base.html#method_build">Base.build</a> method. This extension requires that </span>
<span class="cm"> * the WidgetPosition extension be added to the Widget (before WidgetPositionExt, if part of the same </span>
<span class="cm"> *</span>
<span class="cm"> * @class WidgetPositionExt</span>
<span class="cm"> * @param {Object} User configuration object</span>
<span class="cm"> */</span>
<span class="kd">function</span> <span class="nx">PositionExt</span><span class="p">(</span><span class="nx">config</span><span class="p">)</span> <span class="p">{</span>
<span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="k">this</span><span class="p">.</span><span class="nx">_posNode</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">error</span><span class="p">(</span><span class="s2">"WidgetPosition needs to be added to the Widget, before WidgetPositionExt is added"</span><span class="p">);</span>
<span class="p">}</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">after</span><span class="p">(</span><span class="k">this</span><span class="p">.</span><span class="nx">_syncUIPosExtras</span><span class="p">,</span> <span class="k">this</span><span class="p">,</span> <span class="nx">SYNCUI</span><span class="p">);</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">after</span><span class="p">(</span><span class="k">this</span><span class="p">.</span><span class="nx">_bindUIPosExtras</span><span class="p">,</span> <span class="k">this</span><span class="p">,</span> <span class="nx">BINDUI</span><span class="p">);</span>
<span class="p">}</span>
<span class="cm">/**</span>
<span class="cm"> * Static property used to define the default attribute </span>
<span class="cm"> * configuration introduced by WidgetPositionExt.</span>
<span class="cm"> * </span>
<span class="cm"> * @type Object</span>
<span class="cm"> * @static</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">ATTRS</span> <span class="o">=</span> <span class="p">{</span>
<span class="cm">/**</span>
<span class="cm"> * @attribute align</span>
<span class="cm"> * @type Object</span>
<span class="cm"> * @default null</span>
<span class="cm"> * @desciption The align attribute is used to align a reference point on the widget, with the refernce point on another node, or the viewport. </span>
<span class="cm"> * The object which align expects has the following properties:</span>
<span class="cm"> * <dl></span>
<span class="cm"> * <dt>node</dt></span>
<span class="cm"> * <dd></span>
<span class="cm"> * The node to which the Widget is to be aligned. If set to null, or not provided, the Widget is aligned to the viewport</span>
<span class="cm"> * </dd></span>
<span class="cm"> * <dt>points</dt></span>
<span class="cm"> * <dd></span>
<span class="cm"> * <p></span>
<span class="cm"> * A two element array, defining the two points on the Widget and node/viewport which are to be aligned. The first element is the point on the Widget, and the second element is the point on the node/viewport.</span>
<span class="cm"> * Supported alignment points are defined as static properties on <code>WidgetPositionExt</code>.</span>
<span class="cm"> * </p></span>
<span class="cm"> * <p></span>
<span class="cm"> * e.g. <code>[WidgetPositionExt.TR, WidgetPositionExt.TL]</code> aligns the Top-Right corner of the Widget with the</span>
<span class="cm"> * Top-Left corner of the node/viewport, and <code>[WidgetPositionExt.CC, WidgetPositionExt.TC]</code> aligns the Center of the </span>
<span class="cm"> * </p></span>
<span class="cm"> * </dd></span>
<span class="cm"> * </dl></span>
<span class="cm"> */</span>
<span class="nx">align</span><span class="o">:</span> <span class="p">{</span>
<span class="nx">value</span><span class="o">:</span><span class="kc">null</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * @attribute centered</span>
<span class="cm"> * @type {boolean | node} </span>
<span class="cm"> * @default false</span>
<span class="cm"> * @description A convenience attribute, which can be used as a shortcut for the align attribute.</span>
<span class="cm"> * If set to true, the Widget is centered in the viewport. If set to a node reference or valid selector string,</span>
<span class="cm"> * the Widget will be centered within the node. If set the false, no center positioning is applied.</span>
<span class="cm"> */</span>
<span class="nx">centered</span><span class="o">:</span> <span class="p">{</span>
<span class="nx">setter</span><span class="o">:</span> <span class="s2">"_setAlignCenter"</span><span class="p">,</span>
<span class="nx">lazyAdd</span><span class="o">:</span><span class="kc">false</span><span class="p">,</span>
<span class="nx">value</span><span class="o">:</span><span class="kc">false</span>
<span class="p">}</span>
<span class="p">};</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the top-left corner for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "tl"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TL</span> <span class="o">=</span> <span class="s2">"tl"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the top-right corner for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "tr"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TR</span> <span class="o">=</span> <span class="s2">"tr"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the bottom-left corner for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "bl"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BL</span> <span class="o">=</span> <span class="s2">"bl"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the bottom-right corner for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "br"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BR</span> <span class="o">=</span> <span class="s2">"br"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the top edge-center point for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "tc"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TC</span> <span class="o">=</span> <span class="s2">"tc"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the right edge, center point for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "rc"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">RC</span> <span class="o">=</span> <span class="s2">"rc"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the bottom edge, center point for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "bc"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BC</span> <span class="o">=</span> <span class="s2">"bc"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the left edge, center point for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "lc"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">LC</span> <span class="o">=</span> <span class="s2">"lc"</span><span class="p">;</span>
<span class="cm">/**</span>
<span class="cm"> * Constant used to specify the center of widget/node/viewport for alignment</span>
<span class="cm"> * </span>
<span class="cm"> * @type String</span>
<span class="cm"> * @static</span>
<span class="cm"> * @value "cc"</span>
<span class="cm"> */</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span> <span class="o">=</span> <span class="s2">"cc"</span><span class="p">;</span>
<span class="nx">PositionExt</span><span class="p">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="p">{</span>
<span class="cm">/**</span>
<span class="cm"> * Synchronizes the UI to match the Widgets extended positioning state.</span>
<span class="cm"> * This method in invoked after syncUI is invoked for the Widget class</span>
<span class="cm"> * using YUI's aop infrastructure.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _syncUIPosExtras</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_syncUIPosExtras</span> <span class="o">:</span> <span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
<span class="kd">var</span> <span class="nx">align</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">ALIGN</span><span class="p">);</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">align</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_uiSetAlign</span><span class="p">(</span><span class="nx">align</span><span class="p">.</span><span class="nx">node</span><span class="p">,</span> <span class="nx">align</span><span class="p">.</span><span class="nx">points</span><span class="p">);</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Binds event listeners responsible for updating the UI state in response to </span>
<span class="cm"> * Widget extended positioning related state changes.</span>
<span class="cm"> * <p></span>
<span class="cm"> * This method is invoked after bindUI is invoked for the Widget class</span>
<span class="cm"> * using YUI's aop infrastructure.</span>
<span class="cm"> * </p></span>
<span class="cm"> * @method _bindUIStack</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_bindUIPosExtras</span> <span class="o">:</span> <span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">after</span><span class="p">(</span><span class="nx">AlignChange</span><span class="p">,</span> <span class="k">this</span><span class="p">.</span><span class="nx">_afterAlignChange</span><span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Default setter for center attribute changes. Sets up the appropriate value, and passes </span>
<span class="cm"> * it through the to the align attribute.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _setAlignCenter</span>
<span class="cm"> * @protected</span>
<span class="cm"> * @param {boolean | node} The attribute value being set. </span>
<span class="cm"> * @return {Number} The attribute value being set.</span>
<span class="cm"> */</span>
<span class="nx">_setAlignCenter</span> <span class="o">:</span> <span class="kd">function</span><span class="p">(</span><span class="nx">val</span><span class="p">)</span> <span class="p">{</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">val</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">set</span><span class="p">(</span><span class="nx">ALIGN</span><span class="p">,</span> <span class="p">{</span>
<span class="nx">node</span><span class="o">:</span> <span class="nx">val</span> <span class="o">===</span> <span class="kc">true</span> <span class="o">?</span> <span class="kc">null</span> <span class="o">:</span> <span class="nx">val</span><span class="p">,</span>
<span class="nx">points</span><span class="o">:</span> <span class="p">[</span><span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span><span class="p">,</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span><span class="p">]</span>
<span class="p">});</span>
<span class="p">}</span>
<span class="k">return</span> <span class="nx">val</span><span class="p">;</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Default attribute change listener for the align attribute, responsible</span>
<span class="cm"> * for updating the UI, in response to attribute changes.</span>
<span class="cm"> * </span>
<span class="cm"> * @method _afterAlignChange</span>
<span class="cm"> * @protected</span>
<span class="cm"> * @param {EventFacade} e The event facade for the attribute change</span>
<span class="cm"> */</span>
<span class="nx">_afterAlignChange</span> <span class="o">:</span> <span class="kd">function</span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">e</span><span class="p">.</span><span class="nx">newVal</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_uiSetAlign</span><span class="p">(</span><span class="nx">e</span><span class="p">.</span><span class="nx">newVal</span><span class="p">.</span><span class="nx">node</span><span class="p">,</span> <span class="nx">e</span><span class="p">.</span><span class="nx">newVal</span><span class="p">.</span><span class="nx">points</span><span class="p">);</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Updates the UI to reflect the align value passed in (see the align attribute documentation, for the object stucture expected)</span>
<span class="cm"> * @method _uiSetAlign</span>
<span class="cm"> * @protected</span>
<span class="cm"> * @param {Node | null} The node to align to, or null to indicate the viewport</span>
<span class="cm"> */</span>
<span class="nx">_uiSetAlign</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">node</span><span class="p">,</span> <span class="nx">points</span><span class="p">)</span> <span class="p">{</span>
<span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">L</span><span class="p">.</span><span class="nx">isArray</span><span class="p">(</span><span class="nx">points</span><span class="p">)</span> <span class="o">||</span> <span class="nx">points</span><span class="p">.</span><span class="nx">length</span> <span class="o">!=</span> <span class="mi">2</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">error</span><span class="p">(</span><span class="s2">"align: Invalid Points Arguments"</span><span class="p">);</span>
<span class="k">return</span><span class="p">;</span>
<span class="p">}</span>
<span class="kd">var</span> <span class="nx">nodeRegion</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_getRegion</span><span class="p">(</span><span class="nx">node</span><span class="p">),</span>
<span class="nx">widgetPoint</span><span class="p">,</span>
<span class="nx">nodePoint</span><span class="p">,</span>
<span class="nx">xy</span><span class="p">;</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">nodeRegion</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">widgetPoint</span> <span class="o">=</span> <span class="nx">points</span><span class="p">[</span><span class="mi">0</span><span class="p">];</span>
<span class="nx">nodePoint</span> <span class="o">=</span> <span class="nx">points</span><span class="p">[</span><span class="mi">1</span><span class="p">];</span>
<span class="c1">// TODO: Optimize KWeight - Would lookup table help?</span>
<span class="k">switch</span> <span class="p">(</span><span class="nx">nodePoint</span><span class="p">)</span> <span class="p">{</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TL</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">left</span><span class="p">,</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">top</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TR</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">right</span><span class="p">,</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">top</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BL</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">left</span><span class="p">,</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">bottom</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BR</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">right</span><span class="p">,</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">bottom</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">left</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">width</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">top</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">left</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">width</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">bottom</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">LC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">left</span><span class="p">,</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">top</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">height</span><span class="o">/</span><span class="mi">2</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">RC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">right</span><span class="p">,</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">top</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">height</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">widgetPoint</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">left</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">width</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">top</span> <span class="o">+</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">nodeRegion</span><span class="p">.</span><span class="nx">height</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">widgetPoint</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">default</span><span class="o">:</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"align: Invalid Points Arguments"</span><span class="p">,</span> <span class="s2">"info"</span><span class="p">,</span> <span class="s2">"widget-position-extras"</span><span class="p">);</span>
<span class="k">break</span><span class="p">;</span>
<span class="p">}</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">xy</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_doAlign</span><span class="p">(</span><span class="nx">widgetPoint</span><span class="p">,</span> <span class="nx">xy</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nx">xy</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
<span class="p">}</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Helper method, used to align the given point on the widget, with the XY page co-ordinates provided.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _doAlign</span>
<span class="cm"> * @private</span>
<span class="cm"> * @param {String} widgetPoint Supported point constant (e.g. WidgetPositionExt.TL)</span>
<span class="cm"> * @param {Number} x X page co-ordinate to align to</span>
<span class="cm"> * @param {Number} y Y page co-ordinate to align to</span>
<span class="cm"> */</span>
<span class="nx">_doAlign</span> <span class="o">:</span> <span class="kd">function</span><span class="p">(</span><span class="nx">widgetPoint</span><span class="p">,</span> <span class="nx">x</span><span class="p">,</span> <span class="nx">y</span><span class="p">)</span> <span class="p">{</span>
<span class="kd">var</span> <span class="nx">widgetNode</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_posNode</span><span class="p">,</span>
<span class="nx">xy</span><span class="p">;</span>
<span class="k">switch</span> <span class="p">(</span><span class="nx">widgetPoint</span><span class="p">)</span> <span class="p">{</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TL</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span><span class="p">,</span> <span class="nx">y</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TR</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span> <span class="o">-</span> <span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_WIDTH</span><span class="p">),</span> <span class="nx">y</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BL</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span><span class="p">,</span> <span class="nx">y</span> <span class="o">-</span> <span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_HEIGHT</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BR</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span> <span class="o">-</span> <span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_WIDTH</span><span class="p">),</span> <span class="nx">y</span> <span class="o">-</span> <span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_HEIGHT</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">TC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span> <span class="o">-</span> <span class="p">(</span><span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_WIDTH</span><span class="p">)</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">y</span><span class="p">];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">BC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span> <span class="o">-</span> <span class="p">(</span><span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_WIDTH</span><span class="p">)</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">y</span> <span class="o">-</span> <span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_HEIGHT</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">LC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span><span class="p">,</span> <span class="nx">y</span> <span class="o">-</span> <span class="p">(</span><span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_HEIGHT</span><span class="p">)</span><span class="o">/</span><span class="mi">2</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">RC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[(</span><span class="nx">x</span> <span class="o">-</span> <span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_WIDTH</span><span class="p">)),</span> <span class="nx">y</span> <span class="o">-</span> <span class="p">(</span><span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_HEIGHT</span><span class="p">)</span><span class="o">/</span><span class="mi">2</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">case</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span><span class="o">:</span>
<span class="nx">xy</span> <span class="o">=</span> <span class="p">[</span><span class="nx">x</span> <span class="o">-</span> <span class="p">(</span><span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_WIDTH</span><span class="p">)</span><span class="o">/</span><span class="mi">2</span><span class="p">),</span> <span class="nx">y</span> <span class="o">-</span> <span class="p">(</span><span class="nx">widgetNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">OFFSET_HEIGHT</span><span class="p">)</span><span class="o">/</span><span class="mi">2</span><span class="p">)];</span>
<span class="k">break</span><span class="p">;</span>
<span class="k">default</span><span class="o">:</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"align: Invalid Points Argument"</span><span class="p">,</span> <span class="s2">"info"</span><span class="p">,</span> <span class="s2">"widget-position-extras"</span><span class="p">);</span>
<span class="k">break</span><span class="p">;</span>
<span class="p">}</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">xy</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">move</span><span class="p">(</span><span class="nx">xy</span><span class="p">);</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="nx">_getRegion</span> <span class="o">:</span> <span class="kd">function</span><span class="p">(</span><span class="nx">node</span><span class="p">)</span> <span class="p">{</span>
<span class="kd">var</span> <span class="nx">nodeRegion</span><span class="p">;</span>
<span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">node</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">nodeRegion</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_posNode</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">VIEWPORT_REGION</span><span class="p">);</span>
<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
<span class="nx">node</span> <span class="o">=</span> <span class="nx">Y</span><span class="p">.</span><span class="nx">Node</span><span class="p">.</span><span class="nx">one</span><span class="p">(</span><span class="nx">node</span><span class="p">);</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">node</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">nodeRegion</span> <span class="o">=</span> <span class="nx">node</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">REGION</span><span class="p">);</span>
<span class="p">}</span>
<span class="p">}</span>
<span class="k">return</span> <span class="nx">nodeRegion</span><span class="p">;</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Aligns the Widget to the provided node (or viewport) using the provided</span>
<span class="cm"> * points. The method can be invoked directly, however it will result in </span>
<span class="cm"> * the align attribute being out of sync with current position of the of Widget.</span>
<span class="cm"> * </span>
<span class="cm"> * @method align</span>
<span class="cm"> * @param {Node | String | null} node A reference (or selector string) for the Node which with the Widget is to be aligned.</span>
<span class="cm"> * If null is passed in, the Widget will be aligned with the viewport.</span>
<span class="cm"> * @param {Array[2]} points A two element array, specifying the points on the Widget and node/viewport which need to be aligned. </span>
<span class="cm"> * The first entry is the point on the Widget, and the second entry is the point on the node/viewport which need to align.</span>
<span class="cm"> * Valid point references are defined as static constants on the WidgetPositionExt class. </span>
<span class="cm"> * </span>
<span class="cm"> * e.g. [WidgetPositionExt.TL, WidgetPositionExt.TR] will align the top-left corner of the Widget with the top-right corner of the node/viewport.</span>
<span class="cm"> */</span>
<span class="nx">align</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">node</span><span class="p">,</span> <span class="nx">points</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">set</span><span class="p">(</span><span class="nx">ALIGN</span><span class="p">,</span> <span class="p">{</span><span class="nx">node</span><span class="o">:</span> <span class="nx">node</span><span class="p">,</span> <span class="nx">points</span><span class="o">:</span><span class="nx">points</span><span class="p">});</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Centers the container in the viewport, or if a node is passed in,</span>
<span class="cm"> * the node.</span>
<span class="cm"> *</span>
<span class="cm"> * @method centered</span>
<span class="cm"> * @param {Node | String} node Optional. A node reference or selector string defining the node </span>
<span class="cm"> * inside which the Widget is to be centered. If not passed in, the Widget will be centered in the </span>
<span class="cm"> * viewport.</span>
<span class="cm"> */</span>
<span class="nx">centered</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">node</span><span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">align</span><span class="p">(</span><span class="nx">node</span><span class="p">,</span> <span class="p">[</span><span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span><span class="p">,</span> <span class="nx">PositionExt</span><span class="p">.</span><span class="nx">CC</span><span class="p">]);</span>
<span class="p">}</span>
<span class="p">};</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">WidgetPositionExt</span> <span class="o">=</span> <span class="nx">PositionExt</span><span class="p">;</span>
</pre></div>
</div>
</div>
</div>
<div class="yui-b">
<div class="nav">
<div id="moduleList" class="module">
<h4>Modules</h4>
<ul class="content">
<li class=""><a href="module_classnamemanager.html" title="classnamemanager">classnamemanager</a></li>
<li class=""><a href="module_node-focusmanager.html" title="node-focusmanager">node-focusmanager</a></li>
<li class="selected"><a href="module_widget-position-ext.html" title="widget-position-ext">widget-position-ext</a></li>
</ul>
</div>
<div id="classList" class="module">
<h4>Classes</h4>
<ul class="content">
</ul>
</div>
<div id="fileList" class="module">
<h4>Files</h4>
<ul class="content">
<li class="selected"><a href="Widget-PositionExt.js.html" title="Widget-PositionExt.js">Widget-PositionExt.js</a></li>
</ul>
</div>
</div>
</div>
</div>
<div id="ft">
<hr />
Copyright © 2010 Yahoo! Inc. All rights reserved.
</div>
</div>
<script type="text/javascript">
var ALL_YUI_PROPS = [{"access": "protected", "host": "WidgetPositionExt", "name": "_afterAlignChange", "url": "WidgetPositionExt.html#method__afterAlignChange", "type": "method"}, {"access": "", "host": "WidgetPositionExt", "name": "align", "url": "WidgetPositionExt.html#method_align", "type": "method"}, {"access": "", "host": "WidgetPositionExt", "name": "align", "url": "WidgetPositionExt.html#config_align", "type": "config"}, {"access": "", "host": "WidgetPositionExt", "name": "alignChange", "url": "WidgetPositionExt.html#event_alignChange", "type": "event"}, {"access": "protected", "host": "WidgetPositionExt", "name": "_bindUIStack", "url": "WidgetPositionExt.html#method__bindUIStack", "type": "method"}, {"access": "", "host": "WidgetPositionExt", "name": "centered", "url": "WidgetPositionExt.html#method_centered", "type": "method"}, {"access": "", "host": "WidgetPositionExt", "name": "centered", "url": "WidgetPositionExt.html#config_centered", "type": "config"}, {"access": "", "host": "WidgetPositionExt", "name": "centeredChange", "url": "WidgetPositionExt.html#event_centeredChange", "type": "event"}, {"access": "private", "host": "WidgetPositionExt", "name": "_doAlign", "url": "WidgetPositionExt.html#method__doAlign", "type": "method"}, {"access": "protected", "host": "WidgetPositionExt", "name": "_setAlignCenter", "url": "WidgetPositionExt.html#method__setAlignCenter", "type": "method"}, {"access": "protected", "host": "WidgetPositionExt", "name": "_syncUIPosExtras", "url": "WidgetPositionExt.html#method__syncUIPosExtras", "type": "method"}, {"access": "protected", "host": "WidgetPositionExt", "name": "_uiSetAlign", "url": "WidgetPositionExt.html#method__uiSetAlign", "type": "method"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.ATTRS", "url": "WidgetPositionExt.html#property_WidgetPositionExt.ATTRS", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.BC", "url": "WidgetPositionExt.html#property_WidgetPositionExt.BC", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.BL", "url": "WidgetPositionExt.html#property_WidgetPositionExt.BL", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.BR", "url": "WidgetPositionExt.html#property_WidgetPositionExt.BR", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.CC", "url": "WidgetPositionExt.html#property_WidgetPositionExt.CC", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.LC", "url": "WidgetPositionExt.html#property_WidgetPositionExt.LC", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.RC", "url": "WidgetPositionExt.html#property_WidgetPositionExt.RC", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.TC", "url": "WidgetPositionExt.html#property_WidgetPositionExt.TC", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.TL", "url": "WidgetPositionExt.html#property_WidgetPositionExt.TL", "type": "property"}, {"access": "", "host": "WidgetPositionExt", "name": "WidgetPositionExt.TR", "url": "WidgetPositionExt.html#property_WidgetPositionExt.TR", "type": "property"}];
</script>
</body>
</html>