dm-is-select 0.0.9 → 1.2.0

data/docs/css/panel.css

@@ -0,0 +1,384 @@
+/* Panel (begin) */
+    .panel
+    {
+        position: absolute;
+        width: 100%;
+        height: 100%;
+        top: 0;
+        left: 0;
+        background: #FFF;
+        z-index: 2;
+        font-family: "Helvetica Neue", "Arial", sans-serif;
+        //zoom: 1;
+    }
+    
+    .panel_tree .results, 
+    .panel_results .tree 
+    {
+        display: none;
+    }
+    
+    /* Header with search box (begin) */
+        .panel .header
+        {
+            width: 100%;
+            height: 29px;
+            border-bottom: 1px solid #666;
+            position: relative;
+            left: 0; top: 0;
+            background: #e8e8e8;
+        }
+
+        .panel .header div
+        {
+            margin: 0 7px;
+        }
+        .panel .header table
+        {
+            height: 29px;
+            width: 100%;
+        }
+
+        .panel .header table td
+        {
+            vertical-align: middle;
+            text-align: middle;
+        }
+
+        .panel .header label
+        {
+            position: absolute;
+            font-size: 12px;
+            line-height: 29px;
+            margin-left: 3px;
+            color: #999;
+            cursor: text;
+        }
+
+        .panel .header table input
+        {
+            width: 100%;
+            box-sizing: border-box;
+            -moz-box-sizing: border-box;
+            -webkit-box-sizing: border-box;
+            display: inline-block;
+            -webkit-appearance: searchfield;
+            height: 22px;
+            //height: auto;
+        }
+        
+    /* Header with search box (end) */
+    
+        
+    /* Results (begin) */
+        .panel .result
+        {
+            position: absolute;
+            top: 30px;
+            bottom: 0;
+            left: 0;
+            width: 100%;
+            //height: expression((this.parentNode.offsetHeight - 31));
+            overflow-y: scroll;
+            overflow-x: hidden;
+            -overflow-y: hidden;
+            background: #EDF3FE url(../i/results_bg.png);
+            z-index: 2;
+            //zoom:1;
+        }
+
+        .panel .result ul
+        {
+            font-size: 0.8em;
+            width: 100%;
+            background: #EDF3FE url(../i/results_bg.png);
+            //zoom:1;
+        }
+
+        .panel .result ul li
+        {
+            height: 46px;
+            -height: 50px;
+            //display: inline;
+            //width: 100%;
+            //zoom: 1;
+            overflow: hidden;
+            padding: 4px 10px 0 10px;
+            cursor: pointer;
+        }
+
+        .panel .result ul li h1
+        {
+            font-size: 13px;
+            font-weight: normal;
+            color: #333;
+            margin-bottom: 2px;
+            white-space: nowrap;
+        }
+
+        .panel .result ul li p
+        {
+            font-size: 11px;
+            color: #333;
+            margin-bottom: 2px;
+            white-space: nowrap;
+        }
+
+        .panel .result ul li h1 i,
+        .panel .result ul li p.snippet
+        {
+            color: #999;
+        }
+
+        .panel .result ul li b
+        {
+            color: #000;
+        }
+
+        .panel .result ul li.current
+        {
+            background: #3875D7;
+        }
+
+        .panel .result ul li.current h1,
+        .panel .result ul li.current p
+        {
+            color: #DDD;
+        }
+
+        .panel .result ul li.current h1 i,
+        .panel .result ul li.current p.snippet
+        {
+            color: #AAA;
+        }
+
+        .panel .result ul li.current b
+        {
+            color: #FFF;
+        }
+
+
+        .panel .result ul li:hover,
+        .panel .result ul li.selected
+        {
+            background: #d0d0d0;
+        }
+
+        .panel .result ul li.current:hover
+        {
+            background: #2965C0;
+        }      
+        
+        .panel .result ul li .badge
+        {
+            margin-right: 0.4em;
+            margin-left: -0.2em;
+            padding: 0 0.2em;
+            color: #000;
+            border-radius: 3px;
+        }
+        
+        .panel .result ul li .badge_1
+        {
+            background: #ACDBF4;
+        }
+        
+        .panel .result ul li.current .badge_1
+        {
+            background: #97BFD7;
+        }
+        
+        .panel .result ul li .badge_2
+        {
+            background: #ACF3C3;
+        }
+        
+        .panel .result ul li.current .badge_2
+        {
+            background: #98D7AC;
+        }
+        
+        .panel .result ul li .badge_3
+        {
+            background: #E0F3AC;
+        }
+        
+        .panel .result ul li.current .badge_3
+        {
+            background: #C4D798;
+        }
+        
+        .panel .result ul li .badge_4
+        {
+            background: #D7CA98;
+        }
+        
+        .panel .result ul li.current .badge_4
+        {
+            background: #A6B0AC;
+        }
+        
+        .panel .result ul li .badge_5
+        {
+            background: #F3C8AC;
+        }
+        
+        .panel .result ul li.current .badge_5
+        {
+            background: #D7B198;
+        }
+        
+        .panel .result ul li .badge_6
+        {
+            background: #F3ACC3;
+        }
+        
+        .panel .result ul li.current .badge_6
+        {
+            background: #D798AB;
+        }
+        
+    /* Results (end) */
+    
+    /* Tree (begin) */ /**/
+        .panel .tree 
+        {
+            position: absolute;
+            top: 30px;
+            bottom: 0;
+            left: 0;
+            width: 100%;
+            //zoom: 1;
+            //height: expression((this.parentNode.offsetHeight - 31));
+            overflow-y: scroll;
+            overflow-x: hidden;
+            -overflow-y: hidden;
+            background: #EDF3FE url(../i/tree_bg.png);
+            z-index: 30;
+        }
+        
+        .panel .tree ul
+        {
+            background: #EDF3FE url(../i/tree_bg.png);
+        }          
+        
+        .panel .tree li
+        {
+            cursor: pointer;
+            overflow: hidden;
+            //height: 23px;
+            //display: inline;
+            //zoom: 1;
+            //width: 100%;
+        }
+        
+        
+        .panel .tree li .content
+        {
+            padding-left: 18px;
+            padding-top: 5px;
+            height: 18px;
+            overflow: hidden;
+            position: relative;
+        }
+        
+        .panel .tree li .icon
+        {
+            width: 10px;
+            height: 9px;
+            background: url(../i/arrows.png);
+            background-position: 0 -9px;
+            position: absolute;
+            left: 1px;
+            top: 8px;
+            cursor: default;
+        }
+        
+        .panel .tree li.closed .icon
+        {
+            background-position: 0 0;
+        }
+        
+        .panel .tree ul li h1
+        {
+            font-size: 13px;
+            font-weight: normal;
+            color: #000;
+            margin-bottom: 2px;
+            white-space: nowrap;
+        }
+
+        .panel .tree ul li p
+        {
+            font-size: 11px;
+            color: #666;
+            margin-bottom: 2px;
+            white-space: nowrap;
+        }
+        
+        .panel .tree ul li h1 i
+        {
+            color: #999;
+            font-style: normal;
+        }
+        
+        .panel .tree ul li.empty
+        {
+            cursor: text;
+        }   
+        
+        .panel .tree ul li.empty h1,
+        .panel .tree ul li.empty p
+        {
+            color: #666;
+            font-style: italic;
+        }
+        
+        .panel .tree ul li.current
+        {
+            background: #3875D7;
+        }
+        
+        .panel .tree ul li.current .icon
+        {
+            background-position: -10px -9px;
+        }
+        
+        .panel .tree ul li.current.closed .icon
+        {
+            background-position: -10px 0;
+        }
+
+        .panel .tree ul li.current h1
+        {
+            color: #FFF;
+        }
+
+        .panel .tree ul li.current p
+        {
+            color: #CCC;
+        }
+
+        .panel .tree ul li.current.empty h1,
+        .panel .tree ul li.current.empty p
+        {
+            color: #999;
+        }
+        
+        .panel .tree ul li:hover
+        {
+            background: #d0d0d0;
+        }
+
+        .panel .tree ul li.current:hover
+        {
+            background: #2965C0;
+        }
+        
+        .panel .tree .stopper
+        {
+            display: none;
+        }
+    /* Tree (end) */ /**/
+    
+/* Panel (end) */

data/docs/css/reset.css

@@ -0,0 +1,48 @@
+/* http://meyerweb.com/eric/tools/css/reset/ */
+/* v1.0 | 20080212 */
+
+html, body, div, span, applet, object, iframe,
+h1, h2, h3, h4, h5, h6, p, blockquote, pre,
+a, abbr, acronym, address, big, cite, code,
+del, dfn, em, font, img, ins, kbd, q, s, samp,
+small, strike, strong, sub, sup, tt, var,
+b, u, i, center,
+dl, dt, dd, ol, ul, li,
+fieldset, form, label, legend,
+table, caption, tbody, tfoot, thead, tr, th, td {
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0;
+	font-size: 100%;
+	vertical-align: baseline;
+	background: transparent;
+}
+body {
+	line-height: 1;
+}
+ol, ul {
+	list-style: none;
+}
+blockquote, q {
+	quotes: none;
+}
+blockquote:before, blockquote:after,
+q:before, q:after {
+	content: '';
+	content: none;
+}
+
+/* remember to highlight inserts somehow! */
+ins {
+	text-decoration: none;
+}
+del {
+	text-decoration: line-through;
+}
+
+/* tables still need 'cellspacing="0"' in the markup */
+table {
+	border-collapse: collapse;
+	border-spacing: 0;
+}

data/docs/files/README_rdoc.html

@@ -0,0 +1,272 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+    <title>README.rdoc</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <link rel="stylesheet" href="../css/reset.css" type="text/css" media="screen" />
+<link rel="stylesheet" href="../css/main.css" type="text/css" media="screen" />
+<link rel="stylesheet" href="../css/github.css" type="text/css" media="screen" />
+<script src="../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
+<script src="../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
+<script src="../js/main.js" type="text/javascript" charset="utf-8"></script>
+<script src="../js/highlight.pack.js" type="text/javascript" charset="utf-8"></script>
+
+</head>
+
+<body>     
+    <div class="banner">
+        
+        <h1>
+            README.rdoc
+        </h1>
+        <ul class="files">
+            <li>README.rdoc</li>
+            <li>Last modified: 2013-03-11 01:48:40 +0800</li>
+        </ul>
+    </div>
+
+    <div id="bodyContent">
+        <div id="content">
+  
+    <div class="description">
+      
+<h1 id="label-dm-is-select">dm-is-select</h1>
+
+<p>A <a href="../classes/DataMapper.html">DataMapper</a> plugin that makes
+getting the <code>&lt;select&gt;</code> options from a Model easier.</p>
+
+<h2 id="label-Installation">Installation</h2>
+
+<pre>$  gem install dm-is-select</pre>
+
+<p>Or add the gem to your Gemfile, and then run <code>bundle install</code>.</p>
+
+<pre>gem 'dm-is-select', 'CURRENT_VERSION_NUMBER'</pre>
+
+<h3 id="label-Dependencies">Dependencies</h3>
+
+<p>The plugin depends upon the following:</p>
+<ul><li>
+<p>dm-mysql-adapter  OR  dm-sqlite3-adapter ( &gt;= 1.2.0)</p>
+</li><li>
+<p>data_mapper ( &gt;= 1.2.0)</p>
+</li><li>
+<p>dm-is-tree ( &gt;= 1.2.0)</p>
+</li><li>
+<p>activesupport (&gt;= 3.2.7)  -  methods =&gt; Hash#except  and  Hash#slice</p>
+</li></ul>
+
+<h2 id="label-Getting+Started">Getting Started</h2>
+
+<p>Let’s say you got a basic Category Model.</p>
+
+<pre class="ruby"><span class="ruby-keyword">class</span> <span class="ruby-constant">Category</span>
+  <span class="ruby-identifier">include</span> <span class="ruby-constant">DataMapper</span><span class="ruby-operator">::</span><span class="ruby-constant">Resource</span>
+  <span class="ruby-identifier">property</span> :<span class="ruby-identifier">id</span>, <span class="ruby-constant">Serial</span>
+  <span class="ruby-identifier">property</span> :<span class="ruby-identifier">name</span>, <span class="ruby-constant">String</span>
+
+  <span class="ruby-identifier">is</span> :<span class="ruby-identifier">select</span>, :<span class="ruby-identifier">name</span>
+
+<span class="ruby-keyword">end</span>
+</pre>
+
+<p>Through that simple declaration you get the following class method ..</p>
+
+<pre>Category.items_for_select_menu</pre>
+
+<p>…which returns an Array with the Model items in a structured way, ready for
+use.</p>
+
+<pre>[
+  [nil, &quot;Select Category&quot;], 
+  [&quot;nil&quot;, &quot;  ------  &quot;], 
+  [1, &quot;Category 1&quot;], 
+  [2, &quot;Category 2&quot;], 
+  [3, &quot;Category 3&quot;], 
+  [4, &quot;Category 4&quot;], 
+  [5, &quot;Category 5&quot;]
+]</pre>
+
+<p>Great, but you don’t want the prompt to say “Select Category”, but</p>
+
+<pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>( :<span class="ruby-identifier">prompt</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;Choose Whatever&quot;</span> )
+</pre>
+
+<p>…which returns the Array with the prompt changed</p>
+
+<pre>[
+  [nil, &quot;Choose Whatever&quot;], 
+  [&quot;nil&quot;, &quot;  ------  &quot;], 
+  [1, &quot;Category 1&quot;], 
+  ...&lt;snip&gt;...
+]</pre>
+
+<p>OK, but you don’t like the divider node (2nd in output above). That’s fine,
+you remove it like this:</p>
+
+<pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>( :<span class="ruby-identifier">divider</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span> )
+</pre>
+
+<p>…which returns the Array with the divider removed</p>
+
+<pre>[
+  [nil, &quot;Select Category&quot;], 
+  [1, &quot;Category 1&quot;], 
+  ...&lt;snip&gt;...
+]</pre>
+
+<p>Hmm, fine, but I don’t want either a prompt or a divider, you say. That’s
+fine too.</p>
+
+<pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>( :<span class="ruby-identifier">prompt</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span> )
+</pre>
+
+<p>…which returns the Array with the prompt and divider removed</p>
+
+<pre>[
+  [1, &quot;Category 1&quot;], 
+  [1, &quot;Category 2&quot;], 
+  ...&lt;snip&gt;...
+]</pre>
+
+<p>OK, that’s smooth, but my Category model is a tree with parents, children
+and so on. This won’t work with that.</p>
+
+<p>Sure, no problem, just do this when you declare the Model:</p>
+
+<pre class="ruby"><span class="ruby-identifier">is</span> :<span class="ruby-identifier">select</span>, :<span class="ruby-identifier">name</span>, :<span class="ruby-identifier">is_tree</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">true</span>
+</pre>
+
+<p>Then you can just use this</p>
+
+<pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>( :<span class="ruby-identifier">prompt</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;Choose Parent&quot;</span> )
+</pre>
+
+<p>…and you get this nicely formatted <code>&lt;select&gt;</code> options
+array</p>
+
+<pre>[
+  [nil, &quot;Choose Parent&quot;], 
+  [&quot;nil&quot;, &quot;  ------  &quot;], 
+  [0, &quot;Top Level Category&quot;],
+  [&quot;nil&quot;, &quot;  ------  &quot;], 
+  [1, &quot;Parent-1&quot;], 
+  [2, &quot;-- Parent-1-Child&quot;], 
+  [3, &quot;-- -- Parent-1-Child-GrandChild&quot;],
+  [4, &quot;Parent-2&quot;], 
+  [5, &quot;-- Parent-2-Child&quot;], 
+  [6, &quot;-- -- Parent-2-Child-GrandChild&quot;]
+]</pre>
+
+<p><strong>NB!</strong> It only supports 3 levels at this point in time, as I
+think that's enough in most use cases,  but IF not, fix the code and let me
+know and I'll add it.</p>
+
+<p>Cool, but that “Top Level Category” node is a bit ugly, but easily fixed.</p>
+
+<pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>( :<span class="ruby-identifier">root_text</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;1st Parent (root)&quot;</span> )
+</pre>
+
+<p>…gives you:</p>
+
+<pre>[
+  ...&lt;snip&gt;...
+  [&quot;nil&quot;, &quot;  ------  &quot;], 
+  [0, &quot;1st Parent (root)&quot;],
+  [&quot;nil&quot;, &quot;  ------  &quot;], 
+  ...&lt;snip&gt;...
+]</pre>
+
+<p>You can even remove it all together by doing this:</p>
+
+<pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>( :<span class="ruby-identifier">show_root</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span> )
+</pre>
+
+<p>Obviously all the config options from above works with Tree models as well.</p>
+
+<h2 id="label-Last+Few+Words">Last Few Words</h2>
+
+<p>OK, I admit it, not the most impressive DM plugin there is, but hey, it
+sure helps keeping your model/views cleaner.</p>
+
+<h2 id="label-RTFM+">RTFM </h2>
+
+<p>For a better understanding of this gem/plugin, make sure you study the
+‘<code>dm-is-select/spec/dm-is-select_spec.rb</code>’ file.</p>
+
+<h2 id="label-Errors+%2F+Bugs">Errors / Bugs</h2>
+
+<p>If something is not behaving intuitively, it is a bug, and should be
+reported. Report it here: <a
+href="http://github.com/kematzy/dm-is-select/issues">github.com/kematzy/dm-is-select/issues</a></p>
+
+<h2 id="label-Contributing+to+dm-is-select">Contributing to dm-is-select</h2>
+<ul><li>
+<p>Check out the latest master to make sure the feature hasn’t been
+implemented or the bug hasn’t been fixed yet.</p>
+</li><li>
+<p>Check out the issue tracker to make sure someone already hasn’t requested
+it and/or contributed it.</p>
+</li><li>
+<p>Fork the project.</p>
+</li><li>
+<p>Start a feature/bugfix branch.</p>
+</li><li>
+<p>Commit and push until you are happy with your contribution.</p>
+</li><li>
+<p>Make sure to add tests for it. This is important so I don’t break it in a
+future version unintentionally.</p>
+</li><li>
+<p>Please try not to mess with the Rakefile, version, or history. If you want
+to have your own version, or is otherwise necessary, that is fine, but
+please isolate to its own commit so I can cherry-pick around it.</p>
+</li></ul>
+
+<h2 id="label-Copyright">Copyright</h2>
+
+<p>Copyright © 2009 - 2013 Kematzy.</p>
+
+<h2 id="label-Licence">Licence</h2>
+
+<p>Released under the MIT license.</p>
+
+    </div>
+  
+
+
+  
+
+
+  
+  
+
+
+  
+
+
+  
+
+  
+
+
+
+  
+
+    
+
+    
+
+    
+
+
+    
+
+
+    <!-- Methods -->
+              </div>
+
+    </div>
+  </body>
+</html>