/ext-4.1.0_b3/docs/extjs/examples/form/combos.html
HTML | 276 lines | 245 code | 27 blank | 4 comment | 0 complexity | e44975fdc0096623c99e0dd8c04117a1 MD5 | raw file
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
7 <!-- ExtJS -->
8 <link rel="stylesheet" type="text/css" href="../../resources/css/ext-all.css" />
9 <script type="text/javascript" src="../../ext-all.js"></script>
10
11 <!-- Shared -->
12 <link rel="stylesheet" type="text/css" href="../shared/example.css" />
13
14 <!-- GC -->
15
16
17 <!-- Example -->
18 <script type="text/javascript" src="combos.js"></script>
19 <style type="text/css">
20 .example {
21 width: 600px;
22 border: 1px solid #CCC;
23 padding: 0 10px;
24 margin: 0 0 10px;
25 }
26 .x-fieldset {
27 margin-top: 20px;
28 }
29 #transformCombo label {
30 display: block;
31 margin: 1em 0 2px;
32 }
33 </style>
34
35</head>
36<body>
37
38<h1>Combo Boxes</h1>
39<p>The js is not minified so it is readable. See <a href="combos.js">combos.js</a>.</p>
40
41<div class="example">
42 <h2>Data Sources</h2>
43 <p>The combo box can use any type of Ext.data.Store as its data source.
44 This means your data can be XML, JSON, arrays or any other supported format. It can be loaded using
45 Ajax, via script tags or locally. This combo uses local data from a JS array:</p>
46
47 <div id="simpleCombo"></div>
48
49 <pre class="code x-hide-display" id="simpleComboCode">// Define the model for a State
50Ext.regModel('State', {
51 fields: [
52 {type: 'string', name: 'abbr'},
53 {type: 'string', name: 'name'},
54 {type: 'string', name: 'slogan'}
55 ]
56});
57
58// The data store holding the states
59var store = Ext.create('Ext.data.Store', {
60 model: 'State',
61 data: states
62});
63
64// Simple ComboBox using the data store
65var simpleCombo = Ext.create('Ext.form.field.ComboBox', {
66 fieldLabel: 'Select a single state',
67 renderTo: 'simpleCombo',
68 displayField: 'name',
69 width: 500,
70 labelWidth: 130,
71 store: store,
72 queryMode: 'local',
73 typeAhead: true
74});</pre>
75</div>
76
77<div class="example">
78 <h2>Custom Item Templates</h2>
79 <p>The combo below uses the same data, but also illustrates how to use an optional
80 custom template to create custom UI renditions for list items by overriding the getInnerTpl method. In this case
81 each item shows the state's abbreviation, and has a QuickTip which displays the state's nickname when hovered over.</p>
82
83 <div id="customTplCombo"></div>
84
85 <pre class="code x-hide-display" id="customTplComboCode">// Define the model for a State
86Ext.regModel('State', {
87 fields: [
88 {type: 'string', name: 'abbr'},
89 {type: 'string', name: 'name'},
90 {type: 'string', name: 'slogan'}
91 ]
92});
93
94// The data store holding the states
95var store = Ext.create('Ext.data.Store', {
96 model: 'State',
97 data: states
98});
99
100// ComboBox with a custom item template
101var customTplCombo = Ext.create('Ext.form.field.ComboBox', {
102 fieldLabel: 'Select a single state',
103 renderTo: 'customTplCombo',
104 displayField: 'name',
105 width: 500,
106 labelWidth: 130,
107 store: store,
108 queryMode: 'local',
109 listConfig: {
110 getInnerTpl: function() {
111 return '<div data-qtip="{name}. {slogan}">{name} ({abbr})</div>';
112 }
113 }
114});</pre>
115</div>
116
117<div class="example">
118 <h2>Multiple Selection</h2>
119 <p>The combo below uses the same data once again, but allows selecting multiple values.</p>
120
121 <div id="multiSelectCombo"></div>
122
123 <pre class="code x-hide-display" id="multiSelectComboCode">// Define the model for a State
124Ext.regModel('State', {
125 fields: [
126 {type: 'string', name: 'abbr'},
127 {type: 'string', name: 'name'},
128 {type: 'string', name: 'slogan'}
129 ]
130});
131
132// The data store holding the states
133var store = Ext.create('Ext.data.Store', {
134 model: 'State',
135 data: states
136});
137
138// ComboBox with multiple selection enabled
139var multiCombo = Ext.create('Ext.form.field.ComboBox', {
140 fieldLabel: 'Select multiple states',
141 renderTo: 'multiSelectCombo',
142 multiSelect: true,
143 displayField: 'name',
144 width: 500,
145 labelWidth: 130,
146 store: store,
147 queryMode: 'local'
148});</pre>
149</div>
150
151<div class="example">
152 <h2>Transformation</h2>
153 <p>ComboBoxes can also be created from existing HTML <code><select></code> elements on the page by
154 specifying the <code>transform</code> config. This allows creation of rich ComboBox fields with autocompletion
155 and list filtering, in an unobtrusive way.</p>
156
157 <div id="transformCombo">
158 <label for="stateSelect">Transformed select:</label>
159 <select name="state" id="stateSelect">
160 <option value="AL">Alabama</option>
161 <option value="AK">Alaska</option>
162 <option value="AZ">Arizona</option>
163 <option value="AR">Arkansas</option>
164 <option value="CA">California</option>
165 <option value="CO">Colorado</option>
166 <option value="CT">Connecticut</option>
167 <option value="DE">Delaware</option>
168 <option value="FL">Florida</option>
169 <option value="GA">Georgia</option>
170 <option value="HI">Hawaii</option>
171 <option value="ID">Idaho</option>
172 <option value="IL">Illinois</option>
173 <option value="IN">Indiana</option>
174 <option value="IA">Iowa</option>
175 <option value="KS">Kansas</option>
176 <option value="KY">Kentucky</option>
177 <option value="LA">Louisiana</option>
178 <option value="ME">Maine</option>
179 <option value="MD">Maryland</option>
180 <option value="MA">Massachusetts</option>
181 <option value="MI">Michigan</option>
182 <option value="MN">Minnesota</option>
183 <option value="MS">Mississippi</option>
184 <option value="MO">Missouri</option>
185 <option value="MT">Montana</option>
186 <option value="NE">Nebraska</option>
187 <option value="NV">Nevada</option>
188 <option value="NH">New Hampshire</option>
189 <option value="NJ">New Jersey</option>
190 <option value="NM">New Mexico</option>
191 <option value="NY">New York</option>
192 <option value="NC">North Carolina</option>
193 <option value="ND">North Dakota</option>
194 <option value="OH" selected>Ohio</option>
195 <option value="OK">Oklahoma</option>
196 <option value="OR">Oregon</option>
197 <option value="PA">Pennsylvania</option>
198 <option value="RI">Rhode Island</option>
199 <option value="SC">South Carolina</option>
200 <option value="SD">South Dakota</option>
201 <option value="TN">Tennessee</option>
202 <option value="TX">Texas</option>
203 <option value="UT">Utah</option>
204 <option value="VT">Vermont</option>
205 <option value="VA">Virginia</option>
206 <option value="WA">Washington</option>
207 <option value="WV">West Virginia</option>
208 <option value="WI">Wisconsin</option>
209 <option value="WY">Wyoming</option>
210 </select>
211
212 <label for="stateSelectOrig">Originally looked like:</label>
213 <select name="state-orig" id="stateSelectOrig">
214 <option value="AL">Alabama</option>
215 <option value="AK">Alaska</option>
216 <option value="AZ">Arizona</option>
217 <option value="AR">Arkansas</option>
218 <option value="CA">California</option>
219 <option value="CO">Colorado</option>
220 <option value="CT">Connecticut</option>
221 <option value="DE">Delaware</option>
222 <option value="FL">Florida</option>
223 <option value="GA">Georgia</option>
224 <option value="HI">Hawaii</option>
225 <option value="ID">Idaho</option>
226 <option value="IL">Illinois</option>
227 <option value="IN">Indiana</option>
228 <option value="IA">Iowa</option>
229 <option value="KS">Kansas</option>
230 <option value="KY">Kentucky</option>
231 <option value="LA">Louisiana</option>
232 <option value="ME">Maine</option>
233 <option value="MD">Maryland</option>
234 <option value="MA">Massachusetts</option>
235 <option value="MI">Michigan</option>
236 <option value="MN">Minnesota</option>
237 <option value="MS">Mississippi</option>
238 <option value="MO">Missouri</option>
239 <option value="MT">Montana</option>
240 <option value="NE">Nebraska</option>
241 <option value="NV">Nevada</option>
242 <option value="NH">New Hampshire</option>
243 <option value="NJ">New Jersey</option>
244 <option value="NM">New Mexico</option>
245 <option value="NY">New York</option>
246 <option value="NC">North Carolina</option>
247 <option value="ND">North Dakota</option>
248 <option value="OH" selected>Ohio</option>
249 <option value="OK">Oklahoma</option>
250 <option value="OR">Oregon</option>
251 <option value="PA">Pennsylvania</option>
252 <option value="RI">Rhode Island</option>
253 <option value="SC">South Carolina</option>
254 <option value="SD">South Dakota</option>
255 <option value="TN">Tennessee</option>
256 <option value="TX">Texas</option>
257 <option value="UT">Utah</option>
258 <option value="VT">Vermont</option>
259 <option value="VA">Virginia</option>
260 <option value="WA">Washington</option>
261 <option value="WV">West Virginia</option>
262 <option value="WI">Wisconsin</option>
263 <option value="WY">Wyoming</option>
264 </select>
265 </div>
266
267 <pre class="code x-hide-display" id="transformComboCode">var transformed = Ext.create('Ext.form.field.ComboBox', {
268 typeAhead: true,
269 transform: 'stateSelect',
270 width: 135,
271 forceSelection: true
272});</pre>
273</div>
274
275</body>
276</html>