Version bump to 1.0.1

README.md

@@ -34,13 +34,13 @@ Quinn was developed by [~antw][antw] as part of Quintel Intelligence's
 Downloads
 ---------
 
-[Everything (1.0.0)][tarball]
+[Everything (1.0.1)][tarball]
 :   Tarball containing JS, CSS, and images
 
-[Development Version (1.0.0)][development-js]
-:   30.9kb, JS only, Uncompressed with comments
+[Development Version (1.0.1)][development-js]
+:   31.8kb, JS only, Uncompressed with comments
 
-[Production Version (1.0.0)][production-js]
+[Production Version (1.0.1)][production-js]
 :   2.6kb, JS only, Minified and Gzipped
 
 Table of Contents
@@ -339,7 +339,7 @@ all it takes. In some cases, you may need to alter the CSS. For example:
 History
 -------
 
-#### Git HEAD
+#### 1.0.1 _May 10th, 2012_
 
 * Added a `strict` option which prevents the initial value being snapped
   to the `step` value.
@@ -525,7 +525,7 @@ and Internet Explorer are not yet complete.
 [easing]:         http://gsgd.co.uk/sandbox/jquery/easing
 [style-change]:   https://github.com/antw/quinn/commit/ea29f2f
 
-[tarball]:        https://github.com/antw/quinn/tarball/v1.0.0
+[tarball]:        https://github.com/antw/quinn/tarball/v1.0.1
 [development-js]: http://antw.github.com/quinn/jquery.quinn.js
 [production-js]:  http://antw.github.com/quinn/jquery.quinn.min.js
 

docs/jquery.quinn.html

@@ -120,7 +120,7 @@ <h2>Quinn</h2>
         <span class="k">this</span><span class="p">.</span><span class="nx">previousValue</span>  <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
         <span class="k">this</span><span class="p">.</span><span class="nx">drawTo</span>         <span class="o">=</span> <span class="nx">drawToOpts</span><span class="p">(</span><span class="nx">opts</span><span class="p">.</span><span class="nx">drawTo</span><span class="p">,</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">min</span><span class="p">,</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">max</span><span class="p">);</span>
 
-        <span class="k">this</span><span class="p">.</span><span class="nx">model</span>          <span class="o">=</span> <span class="k">new</span> <span class="nx">Model</span><span class="p">(</span><span class="k">this</span><span class="p">);</span>
+        <span class="k">this</span><span class="p">.</span><span class="nx">model</span>          <span class="o">=</span> <span class="k">new</span> <span class="nx">Model</span><span class="p">(</span><span class="k">this</span><span class="p">,</span> <span class="k">this</span><span class="p">.</span><span class="nx">options</span><span class="p">.</span><span class="nx">strict</span><span class="p">);</span>
         <span class="k">this</span><span class="p">.</span><span class="nx">renderer</span>       <span class="o">=</span> <span class="k">new</span> <span class="k">this</span><span class="p">.</span><span class="nx">options</span><span class="p">.</span><span class="nx">renderer</span><span class="p">(</span><span class="k">this</span><span class="p">);</span>
 
         <span class="k">this</span><span class="p">.</span><span class="nx">wrapperWidth</span>   <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
@@ -161,7 +161,7 @@ <h2>Quinn</h2>
         <p>The current Quinn version.</p>
       </td>
       <td class=code>
-        <div class='highlight'><pre>    <span class="nx">Quinn</span><span class="p">.</span><span class="nx">VERSION</span> <span class="o">=</span> <span class="s1">&#39;1.0.0&#39;</span><span class="p">;</span></pre></div>
+        <div class='highlight'><pre>    <span class="nx">Quinn</span><span class="p">.</span><span class="nx">VERSION</span> <span class="o">=</span> <span class="s1">&#39;1.0.1&#39;</span><span class="p">;</span></pre></div>
       </td>
     </tr>
     <tr id='section-Event_Handling'>
@@ -859,7 +859,7 @@ <h2>Model</h2>
 (within the <code>range</code> bounds, one of the <code>only</code> values, etc).</p>
       </td>
       <td class=code>
-        <div class='highlight'><pre>    <span class="kd">function</span> <span class="nx">Model</span> <span class="p">(</span><span class="nx">quinn</span><span class="p">)</span> <span class="p">{</span>
+        <div class='highlight'><pre>    <span class="kd">function</span> <span class="nx">Model</span> <span class="p">(</span><span class="nx">quinn</span><span class="p">,</span> <span class="nx">initiallyStrict</span><span class="p">)</span> <span class="p">{</span>
         <span class="kd">var</span> <span class="nx">opts</span><span class="p">,</span> <span class="nx">initialValue</span><span class="p">,</span> <span class="nx">length</span><span class="p">,</span> <span class="nx">i</span><span class="p">;</span>
 
         <span class="k">this</span><span class="p">.</span><span class="nx">options</span> <span class="o">=</span> <span class="nx">opts</span> <span class="o">=</span> <span class="nx">quinn</span><span class="p">.</span><span class="nx">options</span><span class="p">;</span>
@@ -908,7 +908,7 @@ <h2>Model</h2>
             <span class="k">this</span><span class="p">.</span><span class="nx">values</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
         <span class="p">}</span>
 
-        <span class="k">this</span><span class="p">.</span><span class="nx">setValue</span><span class="p">(</span><span class="nx">initialValue</span><span class="p">);</span>
+        <span class="k">this</span><span class="p">.</span><span class="nx">setValue</span><span class="p">(</span><span class="nx">initialValue</span><span class="p">,</span> <span class="nx">initiallyStrict</span><span class="p">);</span>
     <span class="p">}</span></pre></div>
       </td>
     </tr>
@@ -931,7 +931,7 @@ <h2>Model</h2>
 the value you set resulted in no changes.</p>
       </td>
       <td class=code>
-        <div class='highlight'><pre>    <span class="nx">Model</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">setValue</span> <span class="o">=</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">newValue</span><span class="p">)</span> <span class="p">{</span>
+        <div class='highlight'><pre>    <span class="nx">Model</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">setValue</span> <span class="o">=</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">newValue</span><span class="p">,</span> <span class="nx">strict</span><span class="p">)</span> <span class="p">{</span>
         <span class="kd">var</span> <span class="nx">originalValue</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">values</span><span class="p">,</span> <span class="nx">length</span><span class="p">,</span> <span class="nx">i</span><span class="p">;</span>
 
         <span class="k">if</span> <span class="p">(</span><span class="o">!</span> <span class="nx">_</span><span class="p">.</span><span class="nx">isArray</span><span class="p">(</span><span class="nx">newValue</span><span class="p">))</span> <span class="p">{</span>
@@ -951,7 +951,7 @@ <h2>Model</h2>
         <span class="p">}</span>
 
         <span class="k">for</span> <span class="p">(</span><span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">length</span> <span class="o">=</span> <span class="nx">newValue</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
-            <span class="nx">newValue</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">sanitizeValue</span><span class="p">(</span><span class="nx">newValue</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span>
+            <span class="nx">newValue</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">sanitizeValue</span><span class="p">(</span><span class="nx">newValue</span><span class="p">[</span><span class="nx">i</span><span class="p">],</span> <span class="nx">strict</span><span class="p">);</span>
         <span class="p">}</span>
 
         <span class="k">if</span> <span class="p">(</span><span class="nx">_</span><span class="p">.</span><span class="nx">isEqual</span><span class="p">(</span><span class="nx">newValue</span><span class="p">,</span> <span class="nx">originalValue</span><span class="p">))</span> <span class="p">{</span>
@@ -1024,8 +1024,10 @@ <h3>sanitizeValue</h3>
 it is within the selectable minima and maxima.</p>
       </td>
       <td class=code>
-        <div class='highlight'><pre>    <span class="nx">Model</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">sanitizeValue</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">roundToStep</span><span class="p">(</span><span class="nx">value</span><span class="p">);</span>
+        <div class='highlight'><pre>    <span class="nx">Model</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">sanitizeValue</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="nx">strict</span><span class="p">)</span> <span class="p">{</span>
+        <span class="k">if</span> <span class="p">(</span><span class="nx">strict</span> <span class="o">!==</span> <span class="kc">false</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">roundToStep</span><span class="p">(</span><span class="nx">value</span><span class="p">);</span>
+        <span class="p">}</span>
 
         <span class="k">if</span> <span class="p">(</span><span class="nx">value</span> <span class="o">&gt;</span> <span class="k">this</span><span class="p">.</span><span class="nx">maximum</span><span class="p">)</span> <span class="p">{</span>
             <span class="k">return</span> <span class="k">this</span><span class="p">.</span><span class="nx">maximum</span><span class="p">;</span>
@@ -1456,17 +1458,39 @@ <h3>Options</h3>
         <div class="pilwrap">
           <a class="pilcrow" href="#section-68">&#182;</a>
         </div>
+        <p>Snaps the initial value to fit with the given &ldquo;step&rdquo; value. For
+example, given a step of 0.1 and an initial value of 1.05, the
+value will be changes to fit the step, and rounded to 1.1.</p>
+
+<p>Notes:</p>
+
+<ul>
+<li><p>Even with <code>strict</code> disabled, initial values which are outside
+the given <code>min</code> and <code>max</code> will still be changed to fit within
+the permitted range.</p></li>
+<li><p>The <code>strict</code> setting affects the <em>initial value only</em>.</p></li>
+</ul>
+      </td>
+      <td class=code>
+        <div class='highlight'><pre>        <span class="nx">strict</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span></pre></div>
+      </td>
+    </tr>
+    <tr id='section-69'>
+      <td class=docs>
+        <div class="pilwrap">
+          <a class="pilcrow" href="#section-69">&#182;</a>
+        </div>
         <p>Restrics the values which may be chosen to those listed in the
 <code>only</code> array.</p>
       </td>
       <td class=code>
         <div class='highlight'><pre>        <span class="nx">only</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-69'>
+    <tr id='section-70'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-69">&#182;</a>
+          <a class="pilcrow" href="#section-70">&#182;</a>
         </div>
         <p>Disables the slider when initialized so that a user may not change
 it&rsquo;s value.</p>
@@ -1475,10 +1499,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">disable</span><span class="o">:</span> <span class="kc">false</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-70'>
+    <tr id='section-71'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-70">&#182;</a>
+          <a class="pilcrow" href="#section-71">&#182;</a>
         </div>
         <p>By default, Quinn fades the opacity of the slider to 50% when
 disabled, however this may not work perfectly with older Internet
@@ -1489,10 +1513,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">disabledOpacity</span><span class="o">:</span> <span class="mf">0.5</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-71'>
+    <tr id='section-72'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-71">&#182;</a>
+          <a class="pilcrow" href="#section-72">&#182;</a>
         </div>
         <p>If using Quinn on an element which isn&rsquo;t attached to the DOM, the
 library won&rsquo;t be able to determine it&rsquo;s width; supply it as a
@@ -1502,10 +1526,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">width</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-72'>
+    <tr id='section-73'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-72">&#182;</a>
+          <a class="pilcrow" href="#section-73">&#182;</a>
         </div>
         <p>If using Quinn on an element which isn&rsquo;t attached to the DOM, the
 library won&rsquo;t be able to determine the width of the handle; suppl
@@ -1515,10 +1539,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">handleWidth</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-73'>
+    <tr id='section-74'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-73">&#182;</a>
+          <a class="pilcrow" href="#section-74">&#182;</a>
         </div>
         <p>A callback which is run when changing the slider value. Additional
 callbacks may be added with Quinn::on(&lsquo;drag&rsquo;).</p>
@@ -1531,10 +1555,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">drag</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-74'>
+    <tr id='section-75'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-74">&#182;</a>
+          <a class="pilcrow" href="#section-75">&#182;</a>
         </div>
         <p>Run after the user has finished making a change.</p>
 
@@ -1546,10 +1570,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">change</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-75'>
+    <tr id='section-76'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-75">&#182;</a>
+          <a class="pilcrow" href="#section-76">&#182;</a>
         </div>
         <p>Run once after the slider has been constructed.</p>
 
@@ -1561,10 +1585,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">setup</span><span class="o">:</span> <span class="kc">null</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-76'>
+    <tr id='section-77'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-76">&#182;</a>
+          <a class="pilcrow" href="#section-77">&#182;</a>
         </div>
         <p>An optional class which is used to render the Quinn DOM elements
 and redraw them when the slider value is changed. This should be
@@ -1579,10 +1603,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">renderer</span><span class="o">:</span> <span class="nx">Quinn</span><span class="p">.</span><span class="nx">Renderer</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-77'>
+    <tr id='section-78'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-77">&#182;</a>
+          <a class="pilcrow" href="#section-78">&#182;</a>
         </div>
         <p>When using animations (such as clicking on the bar), how long
 should the duration be? Any jQuery effect duration value is
@@ -1592,10 +1616,10 @@ <h3>Options</h3>
         <div class='highlight'><pre>        <span class="nx">effectSpeed</span><span class="o">:</span> <span class="s1">&#39;fast&#39;</span><span class="p">,</span></pre></div>
       </td>
     </tr>
-    <tr id='section-78'>
+    <tr id='section-79'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-78">&#182;</a>
+          <a class="pilcrow" href="#section-79">&#182;</a>
         </div>
         <p>Set to false to disable all animation on the slider.</p>
       </td>
@@ -1604,21 +1628,21 @@ <h3>Options</h3>
     <span class="p">};</span></pre></div>
       </td>
     </tr>
-    <tr id='section-79'>
+    <tr id='section-80'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-79">&#182;</a>
+          <a class="pilcrow" href="#section-80">&#182;</a>
         </div>
         <hr />
       </td>
       <td class=code>
         <div class='highlight'><pre></pre></div>
       </td>
     </tr>
-    <tr id='section-80'>
+    <tr id='section-81'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-80">&#182;</a>
+          <a class="pilcrow" href="#section-81">&#182;</a>
         </div>
         <p>The jQuery helper function. Permits $(&hellip;).quinn();</p>
       </td>
@@ -1628,10 +1652,10 @@ <h3>Options</h3>
     <span class="p">};</span></pre></div>
       </td>
     </tr>
-    <tr id='section-81'>
+    <tr id='section-82'>
       <td class=docs>
         <div class="pilwrap">
-          <a class="pilcrow" href="#section-81">&#182;</a>
+          <a class="pilcrow" href="#section-82">&#182;</a>
         </div>
         <p>Expose Quinn to the world on $.Quinn.</p>