dm-is-select 0.0.9 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (45) hide show
  1. data/.gitignore +36 -12
  2. data/Gemfile +23 -0
  3. data/Guardfile +13 -0
  4. data/{LICENSE → LICENSE.txt} +1 -1
  5. data/README.rdoc +32 -7
  6. data/Rakefile +33 -69
  7. data/VERSION +1 -1
  8. data/dm-is-select.gemspec +94 -44
  9. data/docs/apple-touch-icon.png +0 -0
  10. data/docs/classes/DataMapper.html +81 -0
  11. data/docs/classes/DataMapper/Is.html +81 -0
  12. data/docs/classes/DataMapper/Is/Select.html +205 -0
  13. data/docs/classes/DataMapper/Is/Select/ClassMethods.html +258 -0
  14. data/docs/created.rid +4 -0
  15. data/docs/css/github.css +129 -0
  16. data/docs/css/main.css +333 -0
  17. data/docs/css/panel.css +384 -0
  18. data/docs/css/reset.css +48 -0
  19. data/docs/favicon.ico +0 -0
  20. data/docs/files/README_rdoc.html +272 -0
  21. data/docs/files/lib/dm-is-select_rb.html +88 -0
  22. data/docs/files/lib/is/select_rb.html +94 -0
  23. data/docs/i/arrows.png +0 -0
  24. data/docs/i/results_bg.png +0 -0
  25. data/docs/i/tree_bg.png +0 -0
  26. data/docs/index.html +13 -0
  27. data/docs/js/highlight.pack.js +1 -0
  28. data/docs/js/jquery-1.3.2.min.js +19 -0
  29. data/docs/js/jquery-effect.js +593 -0
  30. data/docs/js/main.js +24 -0
  31. data/docs/js/navigation.js +142 -0
  32. data/docs/js/search_index.js +1 -0
  33. data/docs/js/searchdoc.js +449 -0
  34. data/docs/js/searcher.js +228 -0
  35. data/docs/panel/index.html +73 -0
  36. data/docs/panel/links.html +12 -0
  37. data/docs/panel/tree.js +1 -0
  38. data/lib/dm-is-select.rb +5 -11
  39. data/lib/{dm-is-select/is → is}/select.rb +12 -10
  40. data/spec/{integration/select_spec.rb → dm-is-select_spec.rb} +25 -13
  41. data/spec/spec_helper.rb +10 -8
  42. metadata +278 -94
  43. data/History.rdoc +0 -24
  44. data/TODO +0 -0
  45. data/lib/dm-is-select/is/version.rb +0 -7
data/docs/apple-touch-icon.png ADDED
Binary file
data/docs/classes/DataMapper.html ADDED
@@ -0,0 +1,81 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <title>DataMapper</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
8
+ <link rel="stylesheet" href="../css/reset.css" type="text/css" media="screen" />
9
+ <link rel="stylesheet" href="../css/main.css" type="text/css" media="screen" />
10
+ <link rel="stylesheet" href="../css/github.css" type="text/css" media="screen" />
11
+ <script src="../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
12
+ <script src="../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
13
+ <script src="../js/main.js" type="text/javascript" charset="utf-8"></script>
14
+ <script src="../js/highlight.pack.js" type="text/javascript" charset="utf-8"></script>
15
+
16
+ </head>
17
+
18
+ <body>
19
+ <div class="banner">
20
+
21
+ <h1>
22
+ <span class="type">Module</span>
23
+ DataMapper
24
+
25
+ </h1>
26
+ <ul class="files">
27
+
28
+ <li><a href="../files/lib/is/select_rb.html">lib/is/select.rb</a></li>
29
+
30
+ </ul>
31
+ </div>
32
+ <div id="bodyContent">
33
+ <div id="content">
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+ <!-- Namespace -->
46
+ <div class="sectiontitle">Namespace</div>
47
+ <ul>
48
+
49
+ <li>
50
+ <span class="type">MODULE</span>
51
+ <a href="DataMapper/Is.html">DataMapper::Is</a>
52
+ </li>
53
+
54
+ </ul>
55
+
56
+
57
+
58
+
59
+
60
+
61
+
62
+
63
+
64
+
65
+
66
+
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <!-- Methods -->
77
+ </div>
78
+
79
+ </div>
80
+ </body>
81
+ </html>
data/docs/classes/DataMapper/Is.html ADDED
@@ -0,0 +1,81 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <title>DataMapper::Is</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
8
+ <link rel="stylesheet" href="../../css/reset.css" type="text/css" media="screen" />
9
+ <link rel="stylesheet" href="../../css/main.css" type="text/css" media="screen" />
10
+ <link rel="stylesheet" href="../../css/github.css" type="text/css" media="screen" />
11
+ <script src="../../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
12
+ <script src="../../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
13
+ <script src="../../js/main.js" type="text/javascript" charset="utf-8"></script>
14
+ <script src="../../js/highlight.pack.js" type="text/javascript" charset="utf-8"></script>
15
+
16
+ </head>
17
+
18
+ <body>
19
+ <div class="banner">
20
+
21
+ <h1>
22
+ <span class="type">Module</span>
23
+ DataMapper::Is
24
+
25
+ </h1>
26
+ <ul class="files">
27
+
28
+ <li><a href="../../files/lib/is/select_rb.html">lib/is/select.rb</a></li>
29
+
30
+ </ul>
31
+ </div>
32
+ <div id="bodyContent">
33
+ <div id="content">
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+ <!-- Namespace -->
46
+ <div class="sectiontitle">Namespace</div>
47
+ <ul>
48
+
49
+ <li>
50
+ <span class="type">MODULE</span>
51
+ <a href="Is/Select.html">DataMapper::Is::Select</a>
52
+ </li>
53
+
54
+ </ul>
55
+
56
+
57
+
58
+
59
+
60
+
61
+
62
+
63
+
64
+
65
+
66
+
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <!-- Methods -->
77
+ </div>
78
+
79
+ </div>
80
+ </body>
81
+ </html>
data/docs/classes/DataMapper/Is/Select.html ADDED
@@ -0,0 +1,205 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <title>DataMapper::Is::Select</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
8
+ <link rel="stylesheet" href="../../../css/reset.css" type="text/css" media="screen" />
9
+ <link rel="stylesheet" href="../../../css/main.css" type="text/css" media="screen" />
10
+ <link rel="stylesheet" href="../../../css/github.css" type="text/css" media="screen" />
11
+ <script src="../../../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
12
+ <script src="../../../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
13
+ <script src="../../../js/main.js" type="text/javascript" charset="utf-8"></script>
14
+ <script src="../../../js/highlight.pack.js" type="text/javascript" charset="utf-8"></script>
15
+
16
+ </head>
17
+
18
+ <body>
19
+ <div class="banner">
20
+
21
+ <h1>
22
+ <span class="type">Module</span>
23
+ DataMapper::Is::Select
24
+
25
+ </h1>
26
+ <ul class="files">
27
+
28
+ <li><a href="../../../files/lib/is/select_rb.html">lib/is/select.rb</a></li>
29
+
30
+ </ul>
31
+ </div>
32
+ <div id="bodyContent">
33
+ <div id="content">
34
+
35
+ <div class="description">
36
+
37
+ <h1 id="label-dm-is-select">dm-is-select</h1>
38
+
39
+ <p>A <a href="../../DataMapper.html">DataMapper</a> plugin that makes getting
40
+ the <code>&lt;select&gt;</code> options from a Model easier.</p>
41
+
42
+ </div>
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+
51
+
52
+
53
+
54
+ <!-- Namespace -->
55
+ <div class="sectiontitle">Namespace</div>
56
+ <ul>
57
+
58
+ <li>
59
+ <span class="type">MODULE</span>
60
+ <a href="Select/ClassMethods.html">DataMapper::Is::Select::ClassMethods</a>
61
+ </li>
62
+
63
+ </ul>
64
+
65
+
66
+
67
+
68
+ <!-- Method ref -->
69
+ <div class="sectiontitle">Methods</div>
70
+ <dl class="methods">
71
+
72
+ <dt>I</dt>
73
+ <dd>
74
+ <ul>
75
+
76
+
77
+ <li>
78
+ <a href="#method-i-is_select">is_select</a>
79
+ </li>
80
+
81
+ </ul>
82
+ </dd>
83
+
84
+ </dl>
85
+
86
+
87
+
88
+
89
+
90
+
91
+
92
+
93
+
94
+
95
+
96
+
97
+
98
+ <!-- Section constants -->
99
+ <div class="sectiontitle">Constants</div>
100
+ <table border='0' cellpadding='5'>
101
+
102
+ <tr valign='top'>
103
+ <td class="attr-name">VERSION</td>
104
+ <td>=</td>
105
+ <td class="attr-value">IO.read(&quot;#{File.dirname(__FILE__)}/../../VERSION&quot;).chomp</td>
106
+ </tr>
107
+
108
+ <tr valign='top'>
109
+ <td>&nbsp;</td>
110
+ <td colspan="2" class="attr-desc"></td>
111
+ </tr>
112
+
113
+
114
+ </table>
115
+
116
+
117
+
118
+
119
+
120
+
121
+ <!-- Methods -->
122
+
123
+ <div class="sectiontitle">Instance Public methods</div>
124
+
125
+ <div class="method">
126
+ <div class="title method-title" id="method-i-is_select">
127
+
128
+ <b>is_select</b>(select_field = :name, options = {})
129
+
130
+ <a href="../../../classes/DataMapper/Is/Select.html#method-i-is_select" name="method-i-is_select" class="permalink">Link</a>
131
+ </div>
132
+
133
+
134
+ <div class="description">
135
+ <p>Defines the field to use for the select menu</p>
136
+
137
+ <h4 id="method-i-is_select-label-Params+">Params </h4>
138
+ <ul><li>
139
+ <p>:field_name =&gt; the name of the field values shown in select</p>
140
+ </li><li>
141
+ <p>:options</p>
142
+ <ul><li>
143
+ <p>:is_tree =&gt; whether if the current Model is an is :tree model.
144
+ (Defaults to false)</p>
145
+ </li></ul>
146
+ </li></ul>
147
+
148
+ <h4 id="method-i-is_select-label-Examples">Examples</h4>
149
+
150
+ <pre class="ruby"><span class="ruby-identifier">is</span> :<span class="ruby-identifier">select</span>, :<span class="ruby-identifier">name</span>
151
+ =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">creates</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;</span><span class="ruby-identifier">select</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span> <span class="ruby-identifier">array</span> <span class="ruby-identifier">on</span> <span class="ruby-identifier">the</span> :<span class="ruby-identifier">name</span> <span class="ruby-identifier">attribute</span> <span class="ruby-identifier">of</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">model</span>
152
+
153
+ <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>
154
+ =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">creates</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;</span><span class="ruby-identifier">select</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span> <span class="ruby-identifier">array</span> <span class="ruby-identifier">with</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">results</span> <span class="ruby-identifier">ordered</span> <span class="ruby-keyword">in</span> <span class="ruby-identifier">hierarchical</span> <span class="ruby-identifier">order</span>
155
+ <span class="ruby-identifier">parent</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">child</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">grandchild</span> <span class="ruby-keyword">for</span> <span class="ruby-identifier">each</span> <span class="ruby-identifier">parent</span>
156
+
157
+ <span class="ruby-identifier">is</span> :<span class="ruby-identifier">select</span>, :<span class="ruby-identifier">name</span>, :<span class="ruby-identifier">value_field</span> =<span class="ruby-operator">&gt;</span> :<span class="ruby-identifier">code</span>
158
+ =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">creates</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;</span><span class="ruby-identifier">select</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span> <span class="ruby-identifier">array</span> <span class="ruby-identifier">with</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">results</span> <span class="ruby-identifier">ordered</span> <span class="ruby-keyword">in</span> <span class="ruby-identifier">hierarchical</span> <span class="ruby-identifier">order</span>
159
+ <span class="ruby-identifier">parent</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">child</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">grandchild</span> <span class="ruby-keyword">for</span> <span class="ruby-identifier">each</span> <span class="ruby-identifier">parent</span>
160
+ </pre>
161
+
162
+ <p>@api public</p>
163
+ </div>
164
+
165
+
166
+
167
+
168
+
169
+
170
+ <div class="sourcecode">
171
+
172
+ <p class="source-link">
173
+ Source:
174
+ <a href="javascript:toggleSource('method-i-is_select_source')" id="l_method-i-is_select_source">show</a>
175
+
176
+ </p>
177
+ <div id="method-i-is_select_source" class="dyn-source">
178
+ <pre><span class="ruby-comment"># File lib/is/select.rb, line 39</span>
179
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword ruby-title">is_select</span>(<span class="ruby-identifier">select_field</span> = <span class="ruby-value">:name</span>, <span class="ruby-identifier">options</span> = {})
180
+ <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;The :select_field, must be an existing attribute in the Model. Got [ #{select_field.inspect} ]&quot;</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">properties</span>.<span class="ruby-identifier">any?</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">select_field</span>.<span class="ruby-identifier">to_sym</span> }
181
+
182
+ <span class="ruby-ivar">@select_options</span> = {
183
+ <span class="ruby-value">:value_field</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;id&quot;</span>,
184
+ <span class="ruby-comment"># add specical features if we are working with Tree Model</span>
185
+ <span class="ruby-value">:is_tree</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span>
186
+ }.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">options</span>)
187
+
188
+ <span class="ruby-ivar">@select_field</span> = <span class="ruby-identifier">select_field</span>
189
+ <span class="ruby-ivar">@value_field</span> = <span class="ruby-ivar">@select_options</span>[<span class="ruby-value">:value_field</span>]
190
+
191
+
192
+ <span class="ruby-comment"># Add class &amp; Instance methods</span>
193
+ <span class="ruby-identifier">extend</span> <span class="ruby-constant">DataMapper</span><span class="ruby-operator">::</span><span class="ruby-constant">Is</span><span class="ruby-operator">::</span><span class="ruby-constant">Select</span><span class="ruby-operator">::</span><span class="ruby-constant">ClassMethods</span>
194
+ <span class="ruby-comment"># include DataMapper::Is::Select::InstanceMethods</span>
195
+
196
+ <span class="ruby-keyword">end</span></pre>
197
+ </div>
198
+ </div>
199
+
200
+ </div>
201
+ </div>
202
+
203
+ </div>
204
+ </body>
205
+ </html>
data/docs/classes/DataMapper/Is/Select/ClassMethods.html ADDED
@@ -0,0 +1,258 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <title>DataMapper::Is::Select::ClassMethods</title>
7
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
8
+ <link rel="stylesheet" href="../../../../css/reset.css" type="text/css" media="screen" />
9
+ <link rel="stylesheet" href="../../../../css/main.css" type="text/css" media="screen" />
10
+ <link rel="stylesheet" href="../../../../css/github.css" type="text/css" media="screen" />
11
+ <script src="../../../../js/jquery-1.3.2.min.js" type="text/javascript" charset="utf-8"></script>
12
+ <script src="../../../../js/jquery-effect.js" type="text/javascript" charset="utf-8"></script>
13
+ <script src="../../../../js/main.js" type="text/javascript" charset="utf-8"></script>
14
+ <script src="../../../../js/highlight.pack.js" type="text/javascript" charset="utf-8"></script>
15
+
16
+ </head>
17
+
18
+ <body>
19
+ <div class="banner">
20
+
21
+ <h1>
22
+ <span class="type">Module</span>
23
+ DataMapper::Is::Select::ClassMethods
24
+
25
+ </h1>
26
+ <ul class="files">
27
+
28
+ <li><a href="../../../../files/lib/is/select_rb.html">lib/is/select.rb</a></li>
29
+
30
+ </ul>
31
+ </div>
32
+ <div id="bodyContent">
33
+ <div id="content">
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+ <!-- Method ref -->
49
+ <div class="sectiontitle">Methods</div>
50
+ <dl class="methods">
51
+
52
+ <dt>I</dt>
53
+ <dd>
54
+ <ul>
55
+
56
+
57
+ <li>
58
+ <a href="#method-i-items_for_select_menu">items_for_select_menu</a>
59
+ </li>
60
+
61
+ </ul>
62
+ </dd>
63
+
64
+ </dl>
65
+
66
+
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+
77
+
78
+
79
+
80
+
81
+ <!-- Section attributes -->
82
+ <div class="sectiontitle">Attributes</div>
83
+ <table border='0' cellpadding='5'>
84
+
85
+ <tr valign='top'>
86
+ <td class='attr-rw'>
87
+ [R]
88
+ </td>
89
+ <td class='attr-name'>select_field</td>
90
+ <td class='attr-desc'></td>
91
+ </tr>
92
+
93
+ <tr valign='top'>
94
+ <td class='attr-rw'>
95
+ [R]
96
+ </td>
97
+ <td class='attr-name'>select_options</td>
98
+ <td class='attr-desc'></td>
99
+ </tr>
100
+
101
+ <tr valign='top'>
102
+ <td class='attr-rw'>
103
+ [R]
104
+ </td>
105
+ <td class='attr-name'>value_field</td>
106
+ <td class='attr-desc'></td>
107
+ </tr>
108
+
109
+ </table>
110
+
111
+
112
+
113
+ <!-- Methods -->
114
+
115
+ <div class="sectiontitle">Instance Public methods</div>
116
+
117
+ <div class="method">
118
+ <div class="title method-title" id="method-i-items_for_select_menu">
119
+
120
+ <b>items_for_select_menu</b>(options = {})
121
+
122
+ <a href="../../../../classes/DataMapper/Is/Select/ClassMethods.html#method-i-items_for_select_menu" name="method-i-items_for_select_menu" class="permalink">Link</a>
123
+ </div>
124
+
125
+
126
+ <div class="description">
127
+ <p>Provides the Model content in a ready to use <code>&lt;select&gt;</code>
128
+ options array</p>
129
+
130
+ <h4 id="method-i-items_for_select_menu-label-Params">Params</h4>
131
+ <ul><li>
132
+ <p>:options</p>
133
+ <ul><li>
134
+ <p>:prompt [String/Boolean] =&gt; The text shown on the
135
+ <code>&lt;select&gt;</code> field in the browser. (Defaults to “<a
136
+ href="../Select.html">Select</a> NameOfYourModel”)</p>
137
+ </li><li>
138
+ <p>:divider [Boolean] =&gt; Whether to add a divider/separator between the
139
+ prompt and the main options. (Defaults to <code>true</code>)</p>
140
+ </li><li>
141
+ <p>:order [Array] =&gt; A normal DM order declaration. (Defaults to [:name]
142
+ or the name of the <a
143
+ href="ClassMethods.html#attribute-i-select_field">#select_field</a>
144
+ declared)</p>
145
+ </li><li>
146
+ <p>:show_root [Boolean] =&gt; Whether to add the Top Level Parent in the
147
+ choices. (Defaults to <code>true</code>)</p>
148
+ </li><li>
149
+ <p>:root_text [String] =&gt; The text to show as the Parent item in select
150
+ list. (Defaults to “Top Level NameOfYourModel”)</p>
151
+ </li></ul>
152
+ </li></ul>
153
+
154
+ <h4 id="method-i-items_for_select_menu-label-Examples">Examples</h4>
155
+
156
+ <pre class="ruby"><span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>
157
+ =<span class="ruby-operator">&gt;</span> [ [<span class="ruby-keyword">nil</span>, <span class="ruby-string">'Select Category'</span>], [<span class="ruby-keyword">nil</span>, <span class="ruby-string">'---'</span>], [<span class="ruby-value">1</span>, <span class="ruby-string">'Category 1'</span>] ,<span class="ruby-operator">...</span>.]
158
+
159
+ <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;Custom Prompt&quot;</span>)
160
+ =<span class="ruby-operator">&gt;</span> [ [<span class="ruby-keyword">nil</span>, <span class="ruby-string">'Custom Prompt'</span>],<span class="ruby-operator">...</span>]
161
+
162
+ <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>)
163
+ =<span class="ruby-operator">&gt;</span> [ [<span class="ruby-value">1</span>, <span class="ruby-string">'Category 1'</span>] ,<span class="ruby-operator">...</span>]
164
+
165
+ <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> )
166
+ =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">array</span> <span class="ruby-identifier">without</span> <span class="ruby-identifier">the</span> [<span class="ruby-keyword">nil</span>, <span class="ruby-string">'---'</span>] <span class="ruby-identifier">node</span>
167
+
168
+ <span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>(:<span class="ruby-identifier">order</span> =<span class="ruby-operator">&gt;</span> [ :<span class="ruby-identifier">id</span>.<span class="ruby-identifier">desc</span> ] )
169
+ =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">array</span> <span class="ruby-identifier">with</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">order</span> <span class="ruby-identifier">reversed</span>. (<span class="ruby-constant">Prompts</span> &amp; <span class="ruby-identifier">divider</span> <span class="ruby-identifier">always</span> <span class="ruby-identifier">comes</span> <span class="ruby-identifier">first</span>)
170
+
171
+ <span class="ruby-constant">Category</span>.<span class="ruby-identifier">items_for_select_menu</span>(:<span class="ruby-identifier">publish_status</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;on&quot;</span>, :<span class="ruby-identifier">order</span> =<span class="ruby-operator">&gt;</span> [ :<span class="ruby-identifier">id</span>.<span class="ruby-identifier">desc</span> ] )
172
+ =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">returns</span> <span class="ruby-identifier">only</span> <span class="ruby-identifier">those</span> <span class="ruby-identifier">items</span> <span class="ruby-identifier">that</span> <span class="ruby-identifier">matches</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">query</span> <span class="ruby-identifier">params</span> <span class="ruby-keyword">or</span> <span class="ruby-identifier">just</span> <span class="ruby-identifier">an</span> <span class="ruby-identifier">empty</span> <span class="ruby-constant">Select</span> <span class="ruby-constant">Menu</span>
173
+ </pre>
174
+
175
+ <p>If your model is a Tree:</p>
176
+
177
+ <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;Custom Root Text&quot;</span>) <span class="ruby-comment"># sets the text for the Top Level (root) Parent</span>
178
+ =<span class="ruby-operator">&gt;</span> [ <span class="ruby-operator">...</span>, [<span class="ruby-value">0</span>, <span class="ruby-string">'Custom Root Text'</span>],<span class="ruby-operator">...</span>]
179
+
180
+ <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>) <span class="ruby-comment"># removes the Top Level (root) Parent from the</span>
181
+ </pre>
182
+
183
+ <p>@api public</p>
184
+ </div>
185
+
186
+
187
+
188
+
189
+
190
+
191
+ <div class="sourcecode">
192
+
193
+ <p class="source-link">
194
+ Source:
195
+ <a href="javascript:toggleSource('method-i-items_for_select_menu_source')" id="l_method-i-items_for_select_menu_source">show</a>
196
+
197
+ </p>
198
+ <div id="method-i-items_for_select_menu_source" class="dyn-source">
199
+ <pre><span class="ruby-comment"># File lib/is/select.rb, line 102</span>
200
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword ruby-title">items_for_select_menu</span>(<span class="ruby-identifier">options</span> = {})
201
+ <span class="ruby-comment"># clean out the various parts</span>
202
+ <span class="ruby-identifier">html_options</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">:prompt</span>, <span class="ruby-value">:divider</span>, <span class="ruby-value">:show_root</span>, <span class="ruby-value">:root_text</span>)
203
+ <span class="ruby-identifier">sql_options</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">except</span>(<span class="ruby-value">:prompt</span>, <span class="ruby-value">:divider</span>, <span class="ruby-value">:show_root</span>, <span class="ruby-value">:root_text</span>)
204
+
205
+ <span class="ruby-comment"># defaults</span>
206
+ <span class="ruby-identifier">html_options</span> = {
207
+ <span class="ruby-value">:prompt</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-node">&quot;Select #{self.name}&quot;</span>,
208
+ <span class="ruby-value">:divider</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">true</span>,
209
+ <span class="ruby-value">:show_root</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">true</span>,
210
+ <span class="ruby-value">:root_text</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-node">&quot;Top Level #{self.name}&quot;</span>,
211
+ }.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">html_options</span>)
212
+
213
+ <span class="ruby-identifier">sql_options</span> = {
214
+ <span class="ruby-value">:order</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-keyword">self</span>.<span class="ruby-identifier">select_field</span>.<span class="ruby-identifier">to_sym</span>],
215
+ }.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">sql_options</span>)
216
+
217
+ <span class="ruby-identifier">mi</span> = <span class="ruby-keyword">self</span>.<span class="ruby-identifier">select_options</span>[<span class="ruby-value">:is_tree</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">all</span>({ <span class="ruby-value">:parent_id</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">nil</span> }.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">sql_options</span>) ) <span class="ruby-operator">:</span> <span class="ruby-identifier">all</span>(<span class="ruby-identifier">sql_options</span>)
218
+
219
+ <span class="ruby-identifier">res</span> = []
220
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">html_options</span>[<span class="ruby-value">:prompt</span>]
221
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-keyword">nil</span>, <span class="ruby-identifier">html_options</span>[<span class="ruby-value">:prompt</span>]]
222
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-string">'nil'</span>, <span class="ruby-string">&quot; ------ &quot;</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">html_options</span>[<span class="ruby-value">:divider</span>]
223
+ <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">select_options</span>[<span class="ruby-value">:is_tree</span>]
224
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">html_options</span>[<span class="ruby-value">:show_root</span>]
225
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-number">0</span>, <span class="ruby-identifier">html_options</span>[<span class="ruby-value">:root_text</span>]]
226
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-string">'nil'</span>,<span class="ruby-string">&quot; ------ &quot;</span>] <span class="ruby-keyword">if</span> <span class="ruby-identifier">html_options</span>[<span class="ruby-value">:divider</span>]
227
+ <span class="ruby-keyword">end</span>
228
+ <span class="ruby-keyword">end</span>
229
+ <span class="ruby-keyword">end</span>
230
+
231
+ <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">select_options</span>[<span class="ruby-value">:is_tree</span>]
232
+ <span class="ruby-identifier">mi</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
233
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-identifier">x</span>.<span class="ruby-identifier">send</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">value_field</span>), <span class="ruby-identifier">x</span>.<span class="ruby-identifier">send</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">select_field</span>)]
234
+ <span class="ruby-keyword">unless</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">blank?</span>
235
+ <span class="ruby-identifier">x</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span><span class="ruby-operator">|</span>
236
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-identifier">child</span>.<span class="ruby-identifier">send</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">value_field</span>), <span class="ruby-node">&quot;-- #{child.send(self.select_field)}&quot;</span>]
237
+ <span class="ruby-identifier">child</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">grand_child</span><span class="ruby-operator">|</span>
238
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [ <span class="ruby-identifier">grand_child</span>.<span class="ruby-identifier">send</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">value_field</span>), <span class="ruby-node">&quot;-- -- #{grand_child.send(self.select_field)}&quot;</span>]
239
+ <span class="ruby-keyword">end</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">child</span>.<span class="ruby-identifier">children</span>.<span class="ruby-identifier">blank?</span>
240
+ <span class="ruby-keyword">end</span>
241
+ <span class="ruby-keyword">end</span>
242
+ <span class="ruby-keyword">end</span>
243
+ <span class="ruby-keyword">else</span>
244
+ <span class="ruby-identifier">mi</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
245
+ <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-identifier">x</span>.<span class="ruby-identifier">send</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">value_field</span>), <span class="ruby-identifier">x</span>.<span class="ruby-identifier">send</span>(<span class="ruby-keyword">self</span>.<span class="ruby-identifier">select_field</span>)]
246
+ <span class="ruby-keyword">end</span>
247
+ <span class="ruby-keyword">end</span>
248
+ <span class="ruby-identifier">res</span>
249
+ <span class="ruby-keyword">end</span></pre>
250
+ </div>
251
+ </div>
252
+
253
+ </div>
254
+ </div>
255
+
256
+ </div>
257
+ </body>
258
+ </html>