int-value-range.js.html revision c58ecf8c959e4bb2e73781236586cbea38a2d1c6
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html xmlns:yui="http://yuilibrary.com/rdf/1.0/yui.rdf#">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<title>API: slider int-value-range.js (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" />
<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">
<h1><a href="http://developer.yahoo.com/yui/" title="Yahoo! UI Library">Yahoo! UI Library</a></h1>
<h3>slider&nbsp; <span class="subtitle">3.0.0</span></h3>
<a href="/index.html" title="Yahoo! UI Library">Yahoo! UI Library</a>
&gt; <a href="/module_slider.html" title="slider">slider</a>
&gt; int-value-range.js (source view)
<form onsubmit="return false">
<div id="propertysearch">
Search: <input autocomplete="off" id="searchinput" />
<div id="searchresults">
&nbsp;
</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="c1">// Constants for compression or performance</span>
<span class="kd">var</span> <span class="nx">MIN</span> <span class="o">=</span> <span class="s1">&#39;min&#39;</span><span class="p">,</span>
<span class="nx">MAX</span> <span class="o">=</span> <span class="s1">&#39;max&#39;</span><span class="p">,</span>
<span class="nx">VALUE</span> <span class="o">=</span> <span class="s1">&#39;value&#39;</span><span class="p">,</span>
<span class="nx">round</span> <span class="o">=</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">round</span><span class="p">;</span>
<span class="kd">function</span> <span class="nx">IntValueRange</span><span class="p">()</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_initIntValueRange</span><span class="p">();</span>
<span class="p">}</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">IntValueRange</span> <span class="o">=</span> <span class="nx">Y</span><span class="p">.</span><span class="nx">mix</span><span class="p">(</span> <span class="nx">IntValueRange</span><span class="p">,</span> <span class="p">{</span>
<span class="c1">// Prototype properties and methods that will be added onto host class</span>
<span class="nx">prototype</span><span class="o">:</span> <span class="p">{</span>
<span class="cm">/**</span>
<span class="cm"> * Cached X or Y offset for the constraining element to avoid extraneous</span>
<span class="cm"> * &lt;code&gt;getXY()&lt;/code&gt; calls during run time calculation.</span>
<span class="cm"> *</span>
<span class="cm"> * @property _offsetXY</span>
<span class="cm"> * @type { Number }</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_offsetXY</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span>
<span class="cm">/**</span>
<span class="cm"> * Factor used to translate value -&amp;gt; position -&amp;gt; value.</span>
<span class="cm"> *</span>
<span class="cm"> * @property _factor</span>
<span class="cm"> * @type { Number }</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_factor</span><span class="o">:</span> <span class="mi">1</span><span class="p">,</span>
<span class="cm">/**</span>
<span class="cm"> * Attach event listeners to keep the UI in sync with the min/max/value</span>
<span class="cm"> * attributes and thumb position.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _initIntValueRange</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_initIntValueRange</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">_key</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span> <span class="o">||</span> <span class="p">{};</span>
<span class="nx">Y</span><span class="p">.</span><span class="nx">mix</span><span class="p">(</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span><span class="p">,</span> <span class="p">(</span> <span class="k">this</span><span class="p">.</span><span class="nx">axis</span> <span class="o">===</span> <span class="s1">&#39;y&#39;</span> <span class="p">)</span> <span class="o">?</span>
<span class="p">{</span>
<span class="nx">minEdge</span> <span class="o">:</span> <span class="s1">&#39;top&#39;</span><span class="p">,</span>
<span class="nx">maxEdge</span> <span class="o">:</span> <span class="s1">&#39;bottom&#39;</span><span class="p">,</span>
<span class="nx">xyIndex</span> <span class="o">:</span> <span class="mi">1</span>
<span class="p">}</span> <span class="o">:</span>
<span class="p">{</span>
<span class="nx">minEdge</span> <span class="o">:</span> <span class="s1">&#39;left&#39;</span><span class="p">,</span>
<span class="nx">maxEdge</span> <span class="o">:</span> <span class="s1">&#39;right&#39;</span><span class="p">,</span>
<span class="nx">xyIndex</span> <span class="o">:</span> <span class="mi">0</span>
<span class="p">}</span> <span class="p">);</span>
<span class="p">},</span>
<span class="nx">_bindValueLogic</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="p">{</span>
<span class="nx">minChange</span> <span class="o">:</span> <span class="k">this</span><span class="p">.</span><span class="nx">_afterMinChange</span><span class="p">,</span>
<span class="nx">maxChange</span> <span class="o">:</span> <span class="k">this</span><span class="p">.</span><span class="nx">_afterMaxChange</span><span class="p">,</span>
<span class="nx">valueChange</span><span class="o">:</span> <span class="k">this</span><span class="p">.</span><span class="nx">_afterValueChange</span>
<span class="p">}</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Cache rail offsets and dims for faster value translation and move</span>
<span class="cm"> * thumb to appropriate position if necessary.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _syncThumbPosition</span>
<span class="cm"> */</span>
<span class="nx">_syncThumbPosition</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">_cacheRailOffset</span><span class="p">();</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_calculateFactor</span><span class="p">();</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_setPosition</span><span class="p">(</span> <span class="k">this</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span> <span class="nx">VALUE</span> <span class="p">)</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Captures the current top left of the rail to avoid excessive DOM</span>
<span class="cm"> * lookups at run time.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _cacheRailOffset</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_cacheRailOffset</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">region</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_dd</span><span class="p">.</span><span class="nx">con</span><span class="p">.</span><span class="nx">getRegion</span><span class="p">();</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_offsetXY</span> <span class="o">=</span> <span class="nx">region</span><span class="p">[</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span><span class="p">.</span><span class="nx">minEdge</span> <span class="p">];</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Calculates and caches</span>
<span class="cm"> * (range between max and min) / (rail width or height)</span>
<span class="cm"> * for fast runtime calculation of position -&amp;gt; value.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _calculateFactor</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_calculateFactor</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">region</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_dd</span><span class="p">.</span><span class="nx">con</span><span class="p">.</span><span class="nx">getRegion</span><span class="p">(</span> <span class="kc">true</span> <span class="p">);</span>
<span class="c1">// e.g. ( max - min ) / ( constrain.right - constrain.left )</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_factor</span> <span class="o">=</span>
<span class="p">(</span> <span class="k">this</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span> <span class="nx">MAX</span> <span class="p">)</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">MIN</span> <span class="p">)</span> <span class="p">)</span> <span class="o">/</span>
<span class="p">(</span> <span class="nx">region</span><span class="p">[</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span><span class="p">.</span><span class="nx">maxEdge</span> <span class="p">]</span> <span class="o">-</span> <span class="nx">region</span><span class="p">[</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span><span class="p">.</span><span class="nx">minEdge</span> <span class="p">]</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Dispatch the new position of the thumb into the value setting</span>
<span class="cm"> * operations.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _defThumbMoveFn</span>
<span class="cm"> * @param e { EventFacade } The host&#39;s thumbMove event</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_defThumbMoveFn</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="kd">var</span> <span class="nx">previous</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">VALUE</span> <span class="p">),</span>
<span class="nx">position</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_dd</span><span class="p">.</span><span class="nx">actXY</span><span class="p">[</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span><span class="p">.</span><span class="nx">xyIndex</span> <span class="p">],</span>
<span class="nx">value</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_offsetToValue</span><span class="p">(</span> <span class="nx">position</span> <span class="p">);</span>
<span class="c1">// Can&#39;t just do this.set( VALUE, this._offsetToValue( value ) )</span>
<span class="k">if</span> <span class="p">(</span> <span class="nx">previous</span> <span class="o">!==</span> <span class="nx">value</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">VALUE</span><span class="p">,</span> <span class="nx">value</span><span class="p">,</span> <span class="p">{</span> <span class="nx">ddEvent</span><span class="o">:</span> <span class="nx">e</span><span class="p">.</span><span class="nx">ddEvent</span> <span class="p">}</span> <span class="p">);</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * &lt;p&gt;Converts a pixel position into a value. Calculates current</span>
<span class="cm"> * position minus xy offsets of the constraining element multiplied by the</span>
<span class="cm"> * ratio of &lt;code&gt;(max - min) / (constraining dim)&lt;/code&gt;.&lt;/p&gt;</span>
<span class="cm"> *</span>
<span class="cm"> * &lt;p&gt;Override this if you want to use a different value mapping</span>
<span class="cm"> * algorithm.&lt;/p&gt;</span>
<span class="cm"> *</span>
<span class="cm"> * @method _offsetToValue</span>
<span class="cm"> * @param { Number } X or Y pixel position</span>
<span class="cm"> * @return { mixed } Value corresponding to the provided pixel position</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_offsetToValue</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">xy</span> <span class="p">)</span> <span class="p">{</span>
<span class="nx">xy</span> <span class="o">-=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_offsetXY</span><span class="p">;</span>
<span class="kd">var</span> <span class="nx">value</span> <span class="o">=</span> <span class="nx">round</span><span class="p">(</span> <span class="nx">xy</span> <span class="o">*</span> <span class="k">this</span><span class="p">.</span><span class="nx">_factor</span> <span class="p">)</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">MIN</span> <span class="p">);</span>
<span class="k">return</span> <span class="k">this</span><span class="p">.</span><span class="nx">_nearestValue</span><span class="p">(</span> <span class="nx">value</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Converts a value into a positional pixel value for use in positioning</span>
<span class="cm"> * the DD element according to the reverse of the</span>
<span class="cm"> * &lt;code&gt;_offsetToValue( xy )&lt;/code&gt; operation.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _valueToOffset</span>
<span class="cm"> * @param val { Number } The value to map to pixel X or Y position</span>
<span class="cm"> * @return { Array } &lt;code&gt;[ &lt;em&gt;X&lt;/em&gt;px, &lt;em&gt;Y&lt;/em&gt;px ] positional values</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_valueToOffset</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">{</span>
<span class="nx">value</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">MIN</span> <span class="p">);</span>
<span class="k">return</span> <span class="nx">round</span><span class="p">(</span> <span class="nx">value</span> <span class="o">/</span> <span class="k">this</span><span class="p">.</span><span class="nx">_factor</span> <span class="p">)</span> <span class="o">+</span> <span class="k">this</span><span class="p">.</span><span class="nx">_offsetXY</span><span class="p">;</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Update position according to new min value. If the new min results</span>
<span class="cm"> * in the current value being out of range, the value is set to the</span>
<span class="cm"> * closer of min or max.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _afterMinChange</span>
<span class="cm"> * @param e { EventFacade } The &lt;code&gt;min&lt;/code&gt; attribute change event.</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_afterMinChange</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">this</span><span class="p">.</span><span class="nx">_verifyValue</span><span class="p">();</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_syncThumbPosition</span><span class="p">();</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Update position according to new max value. If the new max results</span>
<span class="cm"> * in the current value being out of range, the value is set to the</span>
<span class="cm"> * closer of min or max.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _afterMaxChange</span>
<span class="cm"> * @param e { EventFacade } The &lt;code&gt;max&lt;/code&gt; attribute change event.</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_afterMaxChange</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">this</span><span class="p">.</span><span class="nx">_verifyValue</span><span class="p">();</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_syncThumbPosition</span><span class="p">();</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Verifies that the current value is within the min - max range. If</span>
<span class="cm"> * not, value is set to either min or max, depending on which is</span>
<span class="cm"> * closer.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _verifyValue</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_verifyValue</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">value</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">VALUE</span> <span class="p">),</span>
<span class="nx">nearest</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_nearestValue</span><span class="p">(</span> <span class="nx">value</span> <span class="p">);</span>
<span class="k">if</span> <span class="p">(</span> <span class="nx">value</span> <span class="o">!==</span> <span class="nx">nearest</span> <span class="p">)</span> <span class="p">{</span>
<span class="c1">// @TODO Can/should valueChange, minChange, etc be queued</span>
<span class="c1">// events? To make dd.set( &#39;min&#39;, n ); execute after minChange</span>
<span class="c1">// subscribers before on/after valueChange subscribers.</span>
<span class="k">this</span><span class="p">.</span><span class="nx">set</span><span class="p">(</span> <span class="nx">VALUE</span><span class="p">,</span> <span class="nx">nearest</span> <span class="p">);</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Propagate change to the thumb position unless the change originated</span>
<span class="cm"> * from the thumbMove event.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _afterValueChange</span>
<span class="cm"> * @param e { EventFacade } The &lt;code&gt;valueChange&lt;/code&gt; event.</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_afterValueChange</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="o">!</span><span class="nx">e</span><span class="p">.</span><span class="nx">ddEvent</span> <span class="p">)</span> <span class="p">{</span>
<span class="k">this</span><span class="p">.</span><span class="nx">_setPosition</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="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Positions the thumb in accordance with the translated value.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _setPosition</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_setPosition</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">{</span>
<span class="kd">var</span> <span class="nx">thumb</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_dd</span><span class="p">;</span>
<span class="c1">// Drag element hasn&#39;t been setup yet</span>
<span class="k">if</span> <span class="p">(</span> <span class="o">!</span><span class="nx">thumb</span><span class="p">.</span><span class="nx">deltaXY</span> <span class="p">)</span> <span class="p">{</span>
<span class="nx">thumb</span><span class="p">.</span><span class="nx">actXY</span> <span class="o">=</span> <span class="nx">thumb</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span> <span class="s1">&#39;dragNode&#39;</span> <span class="p">).</span><span class="nx">getXY</span><span class="p">();</span>
<span class="nx">thumb</span><span class="p">.</span><span class="nx">_setStartPosition</span><span class="p">(</span> <span class="nx">thumb</span><span class="p">.</span><span class="nx">actXY</span> <span class="p">);</span>
<span class="p">}</span>
<span class="nx">thumb</span><span class="p">.</span><span class="nx">actXY</span><span class="p">[</span> <span class="k">this</span><span class="p">.</span><span class="nx">_key</span><span class="p">.</span><span class="nx">xyIndex</span> <span class="p">]</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">_valueToOffset</span><span class="p">(</span> <span class="nx">value</span> <span class="p">);</span>
<span class="nx">thumb</span><span class="p">.</span><span class="nx">_moveNode</span><span class="p">();</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Validates new values assigned to &lt;code&gt;min&lt;/code&gt; attribute. Numbers</span>
<span class="cm"> * are acceptable. Override this to enforce different rules.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _validateNewMin</span>
<span class="cm"> * @param value { mixed } Value assigned to &lt;code&gt;min&lt;/code&gt; attribute.</span>
<span class="cm"> * @return { Boolean } True for numbers. False otherwise.</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_validateNewMin</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">{</span>
<span class="k">return</span> <span class="nx">Y</span><span class="p">.</span><span class="nx">Lang</span><span class="p">.</span><span class="nx">isNumber</span><span class="p">(</span> <span class="nx">value</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Validates new values assigned to &lt;code&gt;max&lt;/code&gt; attribute. Numbers</span>
<span class="cm"> * are acceptable. Override this to enforce different rules.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _validateNewMax</span>
<span class="cm"> * @param value { mixed } Value assigned to &lt;code&gt;max&lt;/code&gt; attribute.</span>
<span class="cm"> * @return { Boolean } True for numbers. False otherwise.</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_validateNewMax</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">{</span>
<span class="k">return</span> <span class="nx">Y</span><span class="p">.</span><span class="nx">Lang</span><span class="p">.</span><span class="nx">isNumber</span><span class="p">(</span> <span class="nx">value</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Validates new values assigned to &lt;code&gt;value&lt;/code&gt; attribute.</span>
<span class="cm"> * Numbers between the configured &lt;code&gt;min&lt;/code&gt; and &lt;code&gt;max&lt;/code&gt;</span>
<span class="cm"> * are acceptable.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _validateNewValue</span>
<span class="cm"> * @param value { mixed } Value assigned to &lt;code&gt;value&lt;/code&gt; attribute</span>
<span class="cm"> * @return { Boolean } True if value is a number between the configured</span>
<span class="cm"> * &lt;code&gt;min&lt;/code&gt; and &lt;code&gt;max&lt;/code&gt;.</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_validateNewValue</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">{</span>
<span class="k">return</span> <span class="p">(</span> <span class="nx">value</span> <span class="o">===</span> <span class="k">this</span><span class="p">.</span><span class="nx">_nearestValue</span><span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">);</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Returns the nearest valid value to the value input. If the provided</span>
<span class="cm"> * value is outside the min - max range, accounting for min &gt; max</span>
<span class="cm"> * scenarios, the nearest of either min or max is returned. Otherwise,</span>
<span class="cm"> * the provided value is returned.</span>
<span class="cm"> *</span>
<span class="cm"> * @method _nearestValue</span>
<span class="cm"> * @param value { mixed } Value to test against current min - max range</span>
<span class="cm"> * @return { Number } Current min, max, or value if within range</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">_nearestValue</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span> <span class="nx">value</span> <span class="p">)</span> <span class="p">{</span>
<span class="kd">var</span> <span class="nx">min</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">MIN</span> <span class="p">),</span>
<span class="nx">max</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">MAX</span> <span class="p">),</span>
<span class="nx">tmp</span><span class="p">;</span>
<span class="c1">// Account for reverse value range (min &gt; max)</span>
<span class="nx">tmp</span> <span class="o">=</span> <span class="p">(</span> <span class="nx">max</span> <span class="o">&gt;</span> <span class="nx">min</span> <span class="p">)</span> <span class="o">?</span> <span class="nx">max</span> <span class="o">:</span> <span class="nx">min</span><span class="p">;</span>
<span class="nx">min</span> <span class="o">=</span> <span class="p">(</span> <span class="nx">max</span> <span class="o">&gt;</span> <span class="nx">min</span> <span class="p">)</span> <span class="o">?</span> <span class="nx">min</span> <span class="o">:</span> <span class="nx">max</span><span class="p">;</span>
<span class="nx">max</span> <span class="o">=</span> <span class="nx">tmp</span><span class="p">;</span>
<span class="k">return</span> <span class="p">(</span> <span class="nx">value</span> <span class="o">&lt;</span> <span class="nx">min</span> <span class="p">)</span> <span class="o">?</span>
<span class="nx">min</span> <span class="o">:</span>
<span class="p">(</span> <span class="nx">value</span> <span class="o">&gt;</span> <span class="nx">max</span> <span class="p">)</span> <span class="o">?</span>
<span class="nx">max</span> <span class="o">:</span>
<span class="nx">value</span><span class="p">;</span>
<span class="p">}</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * Attributes that will be added onto host class.</span>
<span class="cm"> *</span>
<span class="cm"> * @property ATTRS</span>
<span class="cm"> * @type {Object}</span>
<span class="cm"> * @static</span>
<span class="cm"> * @protected</span>
<span class="cm"> */</span>
<span class="nx">ATTRS</span><span class="o">:</span> <span class="p">{</span>
<span class="cm">/**</span>
<span class="cm"> * The value associated with the farthest top, left position of the</span>
<span class="cm"> * rail. Can be greater than the configured &lt;code&gt;max&lt;/code&gt; if you</span>
<span class="cm"> * want values to increase from right-to-left or bottom-to-top.</span>
<span class="cm"> *</span>
<span class="cm"> * @attribute min</span>
<span class="cm"> * @type { Number }</span>
<span class="cm"> * @default 0</span>
<span class="cm"> */</span>
<span class="nx">min</span><span class="o">:</span> <span class="p">{</span>
<span class="nx">value</span> <span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
<span class="nx">validator</span><span class="o">:</span> <span class="s1">&#39;_validateNewMin&#39;</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * The value associated with the farthest bottom, right position of</span>
<span class="cm"> * the rail. Can be less than the configured &lt;code&gt;min&lt;/code&gt; if</span>
<span class="cm"> * you want values to increase from right-to-left or bottom-to-top.</span>
<span class="cm"> *</span>
<span class="cm"> * @attribute max</span>
<span class="cm"> * @type { Number }</span>
<span class="cm"> * @default 100</span>
<span class="cm"> */</span>
<span class="nx">max</span><span class="o">:</span> <span class="p">{</span>
<span class="nx">value</span> <span class="o">:</span> <span class="mi">100</span><span class="p">,</span>
<span class="nx">validator</span><span class="o">:</span> <span class="s1">&#39;_validateNewMax&#39;</span>
<span class="p">},</span>
<span class="cm">/**</span>
<span class="cm"> * The value associated with the thumb&#39;s current position on the</span>
<span class="cm"> * rail. Defaults to the value inferred from the thumb&#39;s current</span>
<span class="cm"> * position. Specifying value in the constructor will move the</span>
<span class="cm"> * thumb to the position that corresponds to the supplied value.</span>
<span class="cm"> *</span>
<span class="cm"> * @attribute value</span>
<span class="cm"> * @type { Number }</span>
<span class="cm"> * @default (inferred from current thumb position)</span>
<span class="cm"> */</span>
<span class="nx">value</span><span class="o">:</span> <span class="p">{</span>
<span class="nx">value</span> <span class="o">:</span> <span class="mi">0</span><span class="p">,</span>
<span class="nx">validator</span><span class="o">:</span> <span class="s1">&#39;_validateNewValue&#39;</span>
<span class="p">}</span>
<span class="p">}</span>
<span class="p">},</span> <span class="kc">true</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_align-plugin.html" title="align-plugin">align-plugin</a></li>
<li class=""><a href="module_anim.html" title="anim">anim</a></li>
<li class=""><a href="module_async-queue.html" title="async-queue">async-queue</a></li>
<li class=""><a href="module_attribute.html" title="attribute">attribute</a></li>
<li class=""><a href="module_base.html" title="base">base</a></li>
<li class=""><a href="module_cache.html" title="cache">cache</a></li>
<li class=""><a href="module_classnamemanager.html" title="classnamemanager">classnamemanager</a></li>
<li class=""><a href="module_collection.html" title="collection">collection</a></li>
<li class=""><a href="module_console.html" title="console">console</a></li>
<li class=""><a href="module_console-filters.html" title="console-filters">console-filters</a></li>
<li class=""><a href="module_cookie.html" title="cookie">cookie</a></li>
<li class=""><a href="module_dataschema.html" title="dataschema">dataschema</a></li>
<li class=""><a href="module_datasource.html" title="datasource">datasource</a></li>
<li class=""><a href="module_datatype.html" title="datatype">datatype</a></li>
<li class=""><a href="module_dd.html" title="dd">dd</a></li>
<li class=""><a href="module_dom.html" title="dom">dom</a></li>
<li class=""><a href="module_dump.html" title="dump">dump</a></li>
<li class=""><a href="module_event.html" title="event">event</a></li>
<li class=""><a href="module_event-custom.html" title="event-custom">event-custom</a></li>
<li class=""><a href="module_event-simulate.html" title="event-simulate">event-simulate</a></li>
<li class=""><a href="module_history.html" title="history">history</a></li>
<li class=""><a href="module_imageloader.html" title="imageloader">imageloader</a></li>
<li class=""><a href="module_io.html" title="io">io</a></li>
<li class=""><a href="module_json.html" title="json">json</a></li>
<li class=""><a href="module_loader.html" title="loader">loader</a></li>
<li class=""><a href="module_node.html" title="node">node</a></li>
<li class=""><a href="module_node-focusmanager.html" title="node-focusmanager">node-focusmanager</a></li>
<li class=""><a href="module_node-menunav.html" title="node-menunav">node-menunav</a></li>
<li class=""><a href="module_oop.html" title="oop">oop</a></li>
<li class=""><a href="module_overlay.html" title="overlay">overlay</a></li>
<li class=""><a href="module_plugin.html" title="plugin">plugin</a></li>
<li class=""><a href="module_pluginhost.html" title="pluginhost">pluginhost</a></li>
<li class=""><a href="module_profiler.html" title="profiler">profiler</a></li>
<li class=""><a href="module_queue-promote.html" title="queue-promote">queue-promote</a></li>
<li class=""><a href="module_shim-plugin.html" title="shim-plugin">shim-plugin</a></li>
<li class="selected"><a href="module_slider.html" title="slider">slider</a></li>
<li class=""><a href="module_sortable.html" title="sortable">sortable</a></li>
<li class=""><a href="module_stylesheet.html" title="stylesheet">stylesheet</a></li>
<li class=""><a href="module_substitute.html" title="substitute">substitute</a></li>
<li class=""><a href="module_test.html" title="test">test</a></li>
<li class=""><a href="module_widget.html" title="widget">widget</a></li>
<li class=""><a href="module_widget-child.html" title="widget-child">widget-child</a></li>
<li class=""><a href="module_widget-locale.html" title="widget-locale">widget-locale</a></li>
<li class=""><a href="module_widget-parent.html" title="widget-parent">widget-parent</a></li>
<li class=""><a href="module_widget-position-align.html" title="widget-position-align">widget-position-align</a></li>
<li class=""><a href="module_widget-position-constrain.html" title="widget-position-constrain">widget-position-constrain</a></li>
<li class=""><a href="module_widget-stack.html" title="widget-stack">widget-stack</a></li>
<li class=""><a href="module_widget-stdmod.html" title="widget-stdmod">widget-stdmod</a></li>
<li class=""><a href="module_yui.html" title="yui">yui</a></li>
</ul>
</div>
<div id="classList" class="module">
<h4>Classes</h4>
<ul class="content">
<li class=""><a href="Slider.html" title="Slider">Slider</a></li>
</ul>
</div>
<div id="fileList" class="module">
<h4>Files</h4>
<ul class="content">
<li class=""><a href="clickable-rail.js.html" title="clickable-rail.js">clickable-rail.js</a></li>
<li class="selected"><a href="int-value-range.js.html" title="int-value-range.js">int-value-range.js</a></li>
<li class=""><a href="slider-base.js.html" title="slider-base.js">slider-base.js</a></li>
<li class=""><a href="slider.js.html" title="slider.js">slider.js</a></li>
</ul>
</div>
</div>
</div>
</div>
<div id="ft">
<hr />
Copyright &copy; 2010 Yahoo! Inc. All rights reserved.
</div>
</div>
<script type="text/javascript">
var ALL_YUI_PROPS = [{"access": "", "host": "Slider", "name": "axis", "url": "Slider.html#config_axis", "type": "config"}, {"access": "", "host": "Slider", "name": "axisChange", "url": "Slider.html#event_axisChange", "type": "event"}, {"access": "protected", "host": "Slider", "name": "bindUI", "url": "Slider.html#method_bindUI", "type": "method"}, {"access": "protected", "host": "Slider", "name": "initializer", "url": "Slider.html#method_initializer", "type": "method"}, {"access": "", "host": "Slider", "name": "length", "url": "Slider.html#config_length", "type": "config"}, {"access": "", "host": "Slider", "name": "lengthChange", "url": "Slider.html#event_lengthChange", "type": "event"}, {"access": "protected", "host": "Slider", "name": "renderUI", "url": "Slider.html#method_renderUI", "type": "method"}, {"access": "protected", "host": "Slider", "name": "_setAxis", "url": "Slider.html#method__setAxis", "type": "method"}, {"access": "", "host": "Slider", "name": "slideEnd", "url": "Slider.html#event_slideEnd", "type": "event"}, {"access": "protected", "host": "Slider", "name": "Slider.ATTRS", "url": "Slider.html#property_Slider.ATTRS", "type": "property"}, {"access": "protected", "host": "Slider", "name": "Slider.NAME", "url": "Slider.html#property_Slider.NAME", "type": "property"}, {"access": "", "host": "Slider", "name": "slideStart", "url": "Slider.html#event_slideStart", "type": "event"}, {"access": "", "host": "Slider", "name": "syncUI", "url": "Slider.html#method_syncUI", "type": "method"}, {"access": "", "host": "Slider", "name": "thumbMove", "url": "Slider.html#event_thumbMove", "type": "event"}, {"access": "", "host": "Slider", "name": "thumbUrl", "url": "Slider.html#config_thumbUrl", "type": "config"}, {"access": "", "host": "Slider", "name": "thumbUrlChange", "url": "Slider.html#event_thumbUrlChange", "type": "event"}];
</script>
</body>
</html>