1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
---|
2 | <html> |
---|
3 | <head> |
---|
4 | <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
---|
5 | <title>Combo Boxes</title> |
---|
6 | <link rel="stylesheet" type="text/css" href="../../resources/css/ext-all.css" /> |
---|
7 | <link rel="stylesheet" type="text/css" href="../../resources/css/xtheme-gray.css" /> |
---|
8 | |
---|
9 | <!-- GC --> |
---|
10 | <!-- LIBS --> |
---|
11 | <script type="text/javascript" src="../../adapter/ext/ext-base.js"></script> |
---|
12 | <!-- ENDLIBS --> |
---|
13 | |
---|
14 | <script type="text/javascript" src="../../ext-all.js"></script> |
---|
15 | |
---|
16 | <script type="text/javascript" src="states.js"></script> |
---|
17 | <script type="text/javascript" src="combos.js"></script> |
---|
18 | <link rel="stylesheet" type="text/css" href="combos.css" /> |
---|
19 | |
---|
20 | <!-- Common Styles for the examples --> |
---|
21 | <link rel="stylesheet" type="text/css" href="../shared/examples.css" /> |
---|
22 | <style type="text/css"> |
---|
23 | p { width:650px; } |
---|
24 | </style> |
---|
25 | </head> |
---|
26 | <body> |
---|
27 | <script type="text/javascript" src="../shared/examples.js"></script><!-- EXAMPLES --> |
---|
28 | <h1>Combo Boxes</h1> |
---|
29 | <p>The js is not minified so it is readable. See <a href="combos.js">combos.js</a>.</p> |
---|
30 | |
---|
31 | <p> |
---|
32 | <b>Data Sources</b><br /> |
---|
33 | The combo box can use any type of Ext.data.Store as its data source. |
---|
34 | This means your data can be XML, JSON, arrays or any other supported format. It can be loaded using |
---|
35 | Ajax, via script tags or locally. This combo uses local data from a JS array:</p> |
---|
36 | <div> |
---|
37 | <input type="text" id="local-states" size="20"/> |
---|
38 | </div> |
---|
39 | <div id="state-combo-code-panel" style="margin-top:10px"> |
---|
40 | <pre id="state-combo-code" class="code"><code>// simple array store |
---|
41 | var store = new Ext.data.ArrayStore({ |
---|
42 | fields: ['abbr', 'state'], |
---|
43 | data : exampleData |
---|
44 | }); |
---|
45 | var combo = new Ext.form.ComboBox({ |
---|
46 | store: store, |
---|
47 | displayField:'state', |
---|
48 | typeAhead: true, |
---|
49 | mode: 'local', |
---|
50 | triggerAction: 'all', |
---|
51 | emptyText:'Select a state...', |
---|
52 | selectOnFocus:true, |
---|
53 | applyTo: 'local-states' |
---|
54 | }); |
---|
55 | </code></pre></div> |
---|
56 | <br /> |
---|
57 | |
---|
58 | <p> |
---|
59 | The combo below uses the same data, but also illustrates how to use an optional |
---|
60 | custom template to create custom UI renditions for list items. In this case, |
---|
61 | each item has a popup QuickTip which displays the state's nickname when hovered over. |
---|
62 | </p> |
---|
63 | <div> |
---|
64 | <input type="text" id="local-states-with-qtip" size="20"/> |
---|
65 | </div> |
---|
66 | <div id="state-combo-qtip-code-panel" style="margin-top:10px"> |
---|
67 | <pre id="state-combo-qtip-code" class="code"><code>// simple array store |
---|
68 | var store = new Ext.data.ArrayStore({ |
---|
69 | fields: ['abbr', 'state', 'nick'], |
---|
70 | data : exampleData |
---|
71 | }); |
---|
72 | var comboWithTooltip = new Ext.form.ComboBox({ |
---|
73 | tpl: '<tpl for="."><div ext:qtip="{state}. {nick}" class="x-combo-list-item">{state}</div></tpl>', |
---|
74 | store: store, |
---|
75 | displayField:'state', |
---|
76 | typeAhead: true, |
---|
77 | mode: 'local', |
---|
78 | triggerAction: 'all', |
---|
79 | emptyText:'Select a state...', |
---|
80 | selectOnFocus:true, |
---|
81 | applyTo: 'local-states-with-qtip' |
---|
82 | }); |
---|
83 | </code></pre></div> |
---|
84 | <br /> |
---|
85 | |
---|
86 | <p> |
---|
87 | The combo box can also use plain array data directly as its data source, wrapping the array internally |
---|
88 | with a ArrayStore as needed. You can pass a 1-dimensional or multi-dimensional array as the store config:</p> |
---|
89 | <div> |
---|
90 | <input type="text" id="array-states" size="20"/> |
---|
91 | </div> |
---|
92 | <div id="array-combo-code-panel" style="margin-top:10px"> |
---|
93 | <pre id="array-combo-code" class="code"><code>var comboFromArray = new Ext.form.ComboBox({ |
---|
94 | store: exampleData, //direct array data |
---|
95 | typeAhead: true, |
---|
96 | triggerAction: 'all', |
---|
97 | emptyText:'Select a state...', |
---|
98 | selectOnFocus:true, |
---|
99 | applyTo: 'array-states' |
---|
100 | }); |
---|
101 | </code></pre></div> |
---|
102 | <br /> |
---|
103 | |
---|
104 | <p> |
---|
105 | <b>Unobtrusive</b><br /> |
---|
106 | The combo box can very easily be used to convert existing select elements into auto-completing, filtering combos. |
---|
107 | </p> |
---|
108 | <div> |
---|
109 | Transformed select:<br/> <select name="state" id="state"> |
---|
110 | <option value="AL">Alabama</option> |
---|
111 | <option value="AK">Alaska</option> |
---|
112 | <option value="AZ">Arizona</option> |
---|
113 | <option value="AR">Arkansas</option> |
---|
114 | <option value="CA">California</option> |
---|
115 | <option value="CO">Colorado</option> |
---|
116 | <option value="CT">Connecticut</option> |
---|
117 | <option value="DE">Delaware</option> |
---|
118 | <option value="FL">Florida</option> |
---|
119 | <option value="GA">Georgia</option> |
---|
120 | <option value="HI">Hawaii</option> |
---|
121 | <option value="ID">Idaho</option> |
---|
122 | <option value="IL">Illinois</option> |
---|
123 | <option value="IN">Indiana</option> |
---|
124 | <option value="IA">Iowa</option> |
---|
125 | <option value="KS">Kansas</option> |
---|
126 | <option value="KY">Kentucky</option> |
---|
127 | <option value="LA">Louisiana</option> |
---|
128 | <option value="ME">Maine</option> |
---|
129 | <option value="MD">Maryland</option> |
---|
130 | <option value="MA">Massachusetts</option> |
---|
131 | <option value="MI">Michigan</option> |
---|
132 | <option value="MN">Minnesota</option> |
---|
133 | <option value="MS">Mississippi</option> |
---|
134 | <option value="MO">Missouri</option> |
---|
135 | <option value="MT">Montana</option> |
---|
136 | <option value="NE">Nebraska</option> |
---|
137 | <option value="NV">Nevada</option> |
---|
138 | <option value="NH">New Hampshire</option> |
---|
139 | <option value="NJ">New Jersey</option> |
---|
140 | <option value="NM">New Mexico</option> |
---|
141 | <option value="NY">New York</option> |
---|
142 | <option value="NC">North Carolina</option> |
---|
143 | <option value="ND">North Dakota</option> |
---|
144 | <option value="OH" selected>Ohio</option> |
---|
145 | <option value="OK">Oklahoma</option> |
---|
146 | <option value="OR">Oregon</option> |
---|
147 | <option value="PA">Pennsylvania</option> |
---|
148 | <option value="RI">Rhode Island</option> |
---|
149 | <option value="SC">South Carolina</option> |
---|
150 | <option value="SD">South Dakota</option> |
---|
151 | <option value="TN">Tennessee</option> |
---|
152 | <option value="TX">Texas</option> |
---|
153 | <option value="UT">Utah</option> |
---|
154 | <option value="VT">Vermont</option> |
---|
155 | <option value="VA">Virginia</option> |
---|
156 | <option value="WA">Washington</option> |
---|
157 | <option value="WV">West Virginia</option> |
---|
158 | <option value="WI">Wisconsin</option> |
---|
159 | <option value="WY">Wyoming</option> |
---|
160 | </select> |
---|
161 | </div><br /> |
---|
162 | <p> |
---|
163 | Originally looked like:<br/> <select name="state-orig"> |
---|
164 | <option value="AL">Alabama</option> |
---|
165 | <option value="AK">Alaska</option> |
---|
166 | <option value="AZ">Arizona</option> |
---|
167 | <option value="AR">Arkansas</option> |
---|
168 | <option value="CA">California</option> |
---|
169 | <option value="CO">Colorado</option> |
---|
170 | <option value="CT">Connecticut</option> |
---|
171 | <option value="DE">Delaware</option> |
---|
172 | <option value="FL">Florida</option> |
---|
173 | <option value="GA">Georgia</option> |
---|
174 | <option value="HI">Hawaii</option> |
---|
175 | <option value="ID">Idaho</option> |
---|
176 | <option value="IL">Illinois</option> |
---|
177 | <option value="IN">Indiana</option> |
---|
178 | <option value="IA">Iowa</option> |
---|
179 | <option value="KS">Kansas</option> |
---|
180 | <option value="KY">Kentucky</option> |
---|
181 | <option value="LA">Louisiana</option> |
---|
182 | <option value="ME">Maine</option> |
---|
183 | <option value="MD">Maryland</option> |
---|
184 | <option value="MA">Massachusetts</option> |
---|
185 | <option value="MI">Michigan</option> |
---|
186 | <option value="MN">Minnesota</option> |
---|
187 | <option value="MS">Mississippi</option> |
---|
188 | <option value="MO">Missouri</option> |
---|
189 | <option value="MT">Montana</option> |
---|
190 | <option value="NE">Nebraska</option> |
---|
191 | <option value="NV">Nevada</option> |
---|
192 | <option value="NH">New Hampshire</option> |
---|
193 | <option value="NJ">New Jersey</option> |
---|
194 | <option value="NM">New Mexico</option> |
---|
195 | <option value="NY">New York</option> |
---|
196 | <option value="NC">North Carolina</option> |
---|
197 | <option value="ND">North Dakota</option> |
---|
198 | <option value="OH" selected>Ohio</option> |
---|
199 | <option value="OK">Oklahoma</option> |
---|
200 | <option value="OR">Oregon</option> |
---|
201 | <option value="PA">Pennsylvania</option> |
---|
202 | <option value="RI">Rhode Island</option> |
---|
203 | <option value="SC">South Carolina</option> |
---|
204 | <option value="SD">South Dakota</option> |
---|
205 | <option value="TN">Tennessee</option> |
---|
206 | <option value="TX">Texas</option> |
---|
207 | <option value="UT">Utah</option> |
---|
208 | <option value="VT">Vermont</option> |
---|
209 | <option value="VA">Virginia</option> |
---|
210 | <option value="WA">Washington</option> |
---|
211 | <option value="WV">West Virginia</option> |
---|
212 | <option value="WI">Wisconsin</option> |
---|
213 | <option value="WY">Wyoming</option> |
---|
214 | </select> |
---|
215 | </p> |
---|
216 | <div id="transformed-combo-code-panel" style="margin-top:10px"> |
---|
217 | <pre id="transformed-combo-code" class="code"><code>var converted = new Ext.form.ComboBox({ |
---|
218 | typeAhead: true, |
---|
219 | triggerAction: 'all', |
---|
220 | transform:'state', |
---|
221 | width:135, |
---|
222 | forceSelection:true |
---|
223 | }); |
---|
224 | </code></pre></div> |
---|
225 | <br /> |
---|
226 | <p> |
---|
227 | <b>Grid Editor</b><br /> |
---|
228 | <a href="../grid/edit-grid.html">Click here</a> to see the combo as a grid editor. |
---|
229 | </p> |
---|
230 | <br /> |
---|
231 | <p> |
---|
232 | <b>Templates and Ajax</b><br /> |
---|
233 | <a href="forum-search.html">Click here</a> for a more advanced example. |
---|
234 | </p> |
---|
235 | <br /><br /><br /><br /> |
---|
236 | </body> |
---|
237 | </html> |
---|