|
525
|
1 |
<!DOCTYPE html> |
|
|
2 |
<html lang="en"> |
|
|
3 |
<head> |
|
|
4 |
<meta charset="utf-8"> |
|
|
5 |
<title>Example: Attribute Event Based Speed Dating</title> |
|
|
6 |
<link rel="stylesheet" href="http://fonts.googleapis.com/css?family=PT+Sans:400,700,400italic,700italic"> |
|
|
7 |
<link rel="stylesheet" href="../../build/cssgrids/cssgrids-min.css"> |
|
|
8 |
<link rel="stylesheet" href="../assets/css/main.css"> |
|
|
9 |
<link rel="stylesheet" href="../assets/vendor/prettify/prettify-min.css"> |
|
|
10 |
<link rel="shortcut icon" type="image/png" href="../assets/favicon.png"> |
|
|
11 |
<script src="../../build/yui/yui-min.js"></script> |
|
|
12 |
|
|
|
13 |
</head> |
|
|
14 |
<body> |
|
|
15 |
<!-- |
|
|
16 |
<a href="https://github.com/yui/yui3"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub"></a> |
|
|
17 |
--> |
|
|
18 |
<div id="doc"> |
|
|
19 |
<div id="hd"> |
|
|
20 |
<h1><img src="http://yuilibrary.com/img/yui-logo.png"></h1> |
|
|
21 |
</div> |
|
|
22 |
|
|
|
23 |
|
|
|
24 |
<h1>Example: Attribute Event Based Speed Dating</h1> |
|
|
25 |
<div class="yui3-g"> |
|
|
26 |
<div class="yui3-u-3-4"> |
|
|
27 |
<div id="main"> |
|
|
28 |
<div class="content"><style type="text/css" scoped> |
|
|
29 |
#speeddate h1 { |
|
|
30 |
font-size: 108%; |
|
|
31 |
color:#000; |
|
|
32 |
margin-bottom:2em; |
|
|
33 |
} |
|
|
34 |
|
|
|
35 |
#john { |
|
|
36 |
margin-bottom:10px; |
|
|
37 |
} |
|
|
38 |
|
|
|
39 |
.interests.disabled, .reconsider.disabled { |
|
|
40 |
color:#888; |
|
|
41 |
} |
|
|
42 |
|
|
|
43 |
#john .interest { |
|
|
44 |
margin-left:5px; |
|
|
45 |
} |
|
|
46 |
|
|
|
47 |
.sd-nametag { |
|
|
48 |
border:1px solid #000; |
|
|
49 |
text-align:center; |
|
|
50 |
width:25em; |
|
|
51 |
margin:20px; |
|
|
52 |
|
|
|
53 |
background-color:#00f; |
|
|
54 |
|
|
|
55 |
border-radius: 10px; |
|
|
56 |
-webkit-border-radius: 10px; |
|
|
57 |
-moz-border-radius: 10px; |
|
|
58 |
|
|
|
59 |
box-shadow: 3px 3px 3px #888; |
|
|
60 |
-moz-box-shadow: 3px 3px 3px #888; |
|
|
61 |
-webkit-box-shadow: 3px 3px 3px #888; |
|
|
62 |
} |
|
|
63 |
|
|
|
64 |
.sd-nametag .sd-hd, |
|
|
65 |
.sd-nametag .sd-ft { |
|
|
66 |
padding:5px; |
|
|
67 |
text-align:center; |
|
|
68 |
font-size:108%; |
|
|
69 |
font-weight:900; |
|
|
70 |
color:#fff; |
|
|
71 |
} |
|
|
72 |
|
|
|
73 |
.sd-nametag .sd-hd { |
|
|
74 |
border-top-right-radius: 10px; |
|
|
75 |
border-top-left-radius: 10px; |
|
|
76 |
-moz-border-radius-topright: 10px; |
|
|
77 |
-moz-border-radius-topleft: 10px; |
|
|
78 |
-webkit-border-top-right-radius: 10px; |
|
|
79 |
-webkit-border-top-left-radius: 10px; |
|
|
80 |
} |
|
|
81 |
|
|
|
82 |
.sd-nametag .sd-ft { |
|
|
83 |
border-bottom-right-radius: 10px; |
|
|
84 |
border-bottom-left-radius: 10px; |
|
|
85 |
-moz-border-radius-bottomright: 10px; |
|
|
86 |
-moz-border-radius-bottomleft: 10px; |
|
|
87 |
-webkit-border-bottom-right-radius: 10px; |
|
|
88 |
-webkit-border-bottom-left-radius: 10px; |
|
|
89 |
} |
|
|
90 |
|
|
|
91 |
.sd-nametag .sd-bd { |
|
|
92 |
background-color:#fff; |
|
|
93 |
padding:0.5em; |
|
|
94 |
} |
|
|
95 |
|
|
|
96 |
.sd-nametag .sd-bd .sd-name, |
|
|
97 |
.sd-nametag .sd-bd .sd-personality, |
|
|
98 |
.sd-nametag .sd-bd .sd-interests { |
|
|
99 |
font-size:108%; |
|
|
100 |
font-weight:900; |
|
|
101 |
font-family:monospace; |
|
|
102 |
text-decoration:underline; |
|
|
103 |
color:#00a; |
|
|
104 |
} |
|
|
105 |
</style> |
|
|
106 |
|
|
|
107 |
<div class="intro"> |
|
|
108 |
<p>Attribute change events are one of the key benefits of using attributes to maintain state for your objects, instead of regular object properties.</p> |
|
|
109 |
<p>This example refactors the basic <a href="attribute-basic-speeddate.html">"Attribute Based Speed Dating" example</a> to shows how you can listen for attribute change events to tie together your object's internal logic (such as updating the visual presentation of the object), and also to communicate with other objects.</p> |
|
|
110 |
</div> |
|
|
111 |
|
|
|
112 |
<div class="example"> |
|
|
113 |
<div id="speeddate"> |
|
|
114 |
|
|
|
115 |
<h1>Communicating With Attribute Events On Speed Dates</h1> |
|
|
116 |
|
|
|
117 |
<div id="john"> |
|
|
118 |
<button type="button" class="hi">Hi, I'm John</button> |
|
|
119 |
|
|
|
120 |
<span class="interests disabled"> |
|
|
121 |
I enjoy: |
|
|
122 |
<label><input type="checkbox" id="sunsets" class="interest" value="Sunsets" disabled="disabled"> Sunsets</label> |
|
|
123 |
<label><input type="checkbox" id="specs" class="interest" value="Reading Specifications" disabled="disabled"> Reading Specifications</label> |
|
|
124 |
<label><input type="checkbox" id="whales" class="interest" value="Saving Whales" disabled="disabled"> Saving Whales</label> |
|
|
125 |
<label><input type="checkbox" id="knitting" class="interest" value="Knitting" disabled="disabled"> Knitting</label> |
|
|
126 |
</span> |
|
|
127 |
<div class="shirt"></div> |
|
|
128 |
</div> |
|
|
129 |
|
|
|
130 |
<div id="jane"> |
|
|
131 |
<button type="button" class="hi" disabled="disabled">Hey, I'm Jane</button> |
|
|
132 |
<button type="button" class="movingOn" disabled="disabled">I'm Moving On...</button> <span class="reconsider disabled">(unless he likes whales, and avoids knitting <em class="message"></em>)</span> |
|
|
133 |
<div class="shirt"></div> |
|
|
134 |
</div> |
|
|
135 |
</div> |
|
|
136 |
|
|
|
137 |
<script type="text/javascript"> |
|
|
138 |
|
|
|
139 |
// Get a new instance of YUI and |
|
|
140 |
// load it with the required set of modules |
|
|
141 |
|
|
|
142 |
YUI().use("collection", "event", "node", "attribute", function(Y) { |
|
|
143 |
|
|
|
144 |
// Setup custom class which we want to add managed attribute support to |
|
|
145 |
|
|
|
146 |
function SpeedDater(cfg) { |
|
|
147 |
// When constructed, setup the initial attributes for the instance, by calling the addAttrs method. |
|
|
148 |
var attrs = { |
|
|
149 |
name : { |
|
|
150 |
writeOnce:true |
|
|
151 |
}, |
|
|
152 |
|
|
|
153 |
personality : { |
|
|
154 |
value:50 |
|
|
155 |
}, |
|
|
156 |
|
|
|
157 |
available : { |
|
|
158 |
value:true |
|
|
159 |
}, |
|
|
160 |
|
|
|
161 |
interests : { |
|
|
162 |
value : [] |
|
|
163 |
} |
|
|
164 |
}; |
|
|
165 |
|
|
|
166 |
this.addAttrs(attrs, cfg); |
|
|
167 |
} |
|
|
168 |
|
|
|
169 |
// The HTML template representing the SpeedDater name tag. |
|
|
170 |
SpeedDater.NAMETAG = '<div class="sd-nametag"> \ |
|
|
171 |
<div class="sd-hd">Hello!</div> \ |
|
|
172 |
<div class="sd-bd"> \ |
|
|
173 |
<p>I\'m <span class="sd-name">{name}</span> and my PersonalityQuotientIndex is <span class="sd-personality">{personality}</span></p> \ |
|
|
174 |
<p>I enjoy <span class="sd-interests">{interests}</span>.</p> \ |
|
|
175 |
</div> \ |
|
|
176 |
<div class="sd-ft sd-availability">{available}</div> \ |
|
|
177 |
</div>'; |
|
|
178 |
|
|
|
179 |
// Method used to render the visual representation of a SpeedDater object's state (in this case as a name tag) |
|
|
180 |
SpeedDater.prototype.applyNameTag = function(where) { |
|
|
181 |
|
|
|
182 |
var tokens = { |
|
|
183 |
name: this.get("name"), |
|
|
184 |
available: (this.get("available")) ? "" : "Sorry, moving on", |
|
|
185 |
personality: this.get("personality"), |
|
|
186 |
interests: (this.get("interests").length == 0) ? "absolutely nothing" : this.get("interests").join(", ") |
|
|
187 |
}; |
|
|
188 |
|
|
|
189 |
this.nameTag = Y.Node.create(Y.Lang.sub(SpeedDater.NAMETAG, tokens)); |
|
|
190 |
Y.one(where).appendChild(this.nameTag); |
|
|
191 |
|
|
|
192 |
this.listenForChanges(); |
|
|
193 |
}; |
|
|
194 |
|
|
|
195 |
// Method used to attach attribute change event listeners, so that the SpeedDater instance |
|
|
196 |
// will react to changes in attribute state, and update what's rendered on the page |
|
|
197 |
SpeedDater.prototype.listenForChanges = function() { |
|
|
198 |
|
|
|
199 |
// Sync up the UI for "available", after the value of the "available" attribute has changed: |
|
|
200 |
this.after("availableChange", function(e) { |
|
|
201 |
var taken = (e.newVal) ? "" : "Oh, is that the time?"; |
|
|
202 |
this.nameTag.one(".sd-availability").set("innerHTML", taken); |
|
|
203 |
}); |
|
|
204 |
|
|
|
205 |
// Sync up the UI for "name", after the value of the "name" attribute has changed: |
|
|
206 |
this.after("nameChange", function(e) { |
|
|
207 |
var name = e.newVal; |
|
|
208 |
this.nameTag.one(".sd-name").set("innerHTML", name); |
|
|
209 |
}); |
|
|
210 |
|
|
|
211 |
// Sync up the UI for "personality", after the value of the "personality" attribute has changed: |
|
|
212 |
this.after("personalityChange", function(e) { |
|
|
213 |
var personality = e.newVal; |
|
|
214 |
|
|
|
215 |
var personalityEl = this.nameTag.one(".sd-personality"); |
|
|
216 |
personalityEl.set("innerHTML", personality); |
|
|
217 |
|
|
|
218 |
if (personality > 90) { |
|
|
219 |
personalityEl.addClass("sd-max"); |
|
|
220 |
} |
|
|
221 |
}); |
|
|
222 |
|
|
|
223 |
// Sync up the UI for "interests", after the value of the "interests" attribute has changed: |
|
|
224 |
this.after("interestsChange", function(e) { |
|
|
225 |
var interests = (e.newVal.length == 0) ? "absolutely nothing" : this.get("interests").join(", "); |
|
|
226 |
this.nameTag.one(".sd-interests").set("innerHTML", interests); |
|
|
227 |
}); |
|
|
228 |
}; |
|
|
229 |
|
|
|
230 |
// Augment custom class with Attribute |
|
|
231 |
Y.augment(SpeedDater, Y.Attribute); |
|
|
232 |
|
|
|
233 |
var john, jane; |
|
|
234 |
|
|
|
235 |
Y.on("click", function() { |
|
|
236 |
|
|
|
237 |
if (!john) { |
|
|
238 |
|
|
|
239 |
john = new SpeedDater({ |
|
|
240 |
name: "John", |
|
|
241 |
personality: 78 |
|
|
242 |
}); |
|
|
243 |
john.applyNameTag("#john .shirt"); |
|
|
244 |
|
|
|
245 |
Y.one("#jane .hi").set("disabled", false); |
|
|
246 |
} |
|
|
247 |
|
|
|
248 |
}, "#john .hi"); |
|
|
249 |
|
|
|
250 |
Y.on("click", function() { |
|
|
251 |
|
|
|
252 |
if (!jane) { |
|
|
253 |
|
|
|
254 |
jane = new SpeedDater({ |
|
|
255 |
name: "Jane", |
|
|
256 |
personality: 82, |
|
|
257 |
interests: ["Popcorn", "Saving Whales"] |
|
|
258 |
}); |
|
|
259 |
jane.applyNameTag("#jane .shirt"); |
|
|
260 |
|
|
|
261 |
// Update Jane's interests state, after John's interests state changes... |
|
|
262 |
john.after("interestsChange", function(e) { |
|
|
263 |
|
|
|
264 |
var janesInterests = jane.get("interests"), |
|
|
265 |
johnsInterests = e.newVal, |
|
|
266 |
|
|
|
267 |
readingSpecs = "Reading Specifications"; |
|
|
268 |
|
|
|
269 |
// If it turns out that John enjoys reading specs, then Jane can admit it too... |
|
|
270 |
if (Y.Array.indexOf(johnsInterests, readingSpecs) !== -1) { |
|
|
271 |
if(Y.Array.indexOf(janesInterests, readingSpecs) == -1) { |
|
|
272 |
janesInterests.push(readingSpecs); |
|
|
273 |
} |
|
|
274 |
} else { |
|
|
275 |
janesInterests = Y.Array.reject(janesInterests, function(item){return (item == readingSpecs);}); |
|
|
276 |
} |
|
|
277 |
|
|
|
278 |
jane.set("interests", janesInterests); |
|
|
279 |
jane.set("available", true); |
|
|
280 |
|
|
|
281 |
setMessage(""); |
|
|
282 |
}); |
|
|
283 |
|
|
|
284 |
// We can also listen before an attribute changes its value, and decide if we want to |
|
|
285 |
// allow the state change to occur or not. Invoking e.preventDefault() stops the state from |
|
|
286 |
// being updated. |
|
|
287 |
|
|
|
288 |
// In this case, Jane can change her mind about making herself unavailable, if John likes |
|
|
289 |
// saving whales, as long as he doesn't dig knitting too. |
|
|
290 |
|
|
|
291 |
jane.on("availableChange", function(e) { |
|
|
292 |
var johnsInterests = john.get("interests"); |
|
|
293 |
var janeAvailable = e.newVal; |
|
|
294 |
if (janeAvailable === false && Y.Array.indexOf(johnsInterests, "Saving Whales") !== -1 && Y.Array.indexOf(johnsInterests, "Knitting") == -1 ) { |
|
|
295 |
// Reconsider.. |
|
|
296 |
e.preventDefault(); |
|
|
297 |
|
|
|
298 |
setMessage("... which he does"); |
|
|
299 |
}; |
|
|
300 |
}); |
|
|
301 |
|
|
|
302 |
enableExampleUI(); |
|
|
303 |
} |
|
|
304 |
|
|
|
305 |
}, "#jane .hi"); |
|
|
306 |
|
|
|
307 |
Y.on("click", function() { |
|
|
308 |
jane.set("available", false); |
|
|
309 |
}, "#jane .movingOn"); |
|
|
310 |
|
|
|
311 |
// A delegate DOM event listener which will update John's interests, based on the checkbox state, whenever |
|
|
312 |
// a checkbox is clicked. (Using click for IE, due to it's weirdness with requiring a blur before firing change) |
|
|
313 |
Y.delegate("click", function() { |
|
|
314 |
var interests = []; |
|
|
315 |
|
|
|
316 |
Y.Node.all("#john input[type=checkbox].interest").each(function(checkbox) { |
|
|
317 |
if (checkbox.get("checked")) { |
|
|
318 |
interests.push(checkbox.get("value")); |
|
|
319 |
} |
|
|
320 |
}); |
|
|
321 |
john.set("interests", interests); |
|
|
322 |
|
|
|
323 |
}, "#john", "input[type=checkbox].interest"); |
|
|
324 |
|
|
|
325 |
|
|
|
326 |
// Example helpers... |
|
|
327 |
function enableExampleUI() { |
|
|
328 |
Y.all("#jane button").set("disabled", false); |
|
|
329 |
Y.all("#john button").set("disabled", false); |
|
|
330 |
Y.all("#john input").set("disabled", false); |
|
|
331 |
Y.one("#john .interests").removeClass("disabled"); |
|
|
332 |
Y.one("#jane .reconsider").removeClass("disabled"); |
|
|
333 |
} |
|
|
334 |
|
|
|
335 |
function setMessage(msg) { |
|
|
336 |
Y.one("#jane .message").set("innerHTML", msg); |
|
|
337 |
} |
|
|
338 |
|
|
|
339 |
}); |
|
|
340 |
</script> |
|
|
341 |
|
|
|
342 |
</div> |
|
|
343 |
|
|
|
344 |
<h2>Listening For Attribute Change Events</h2> |
|
|
345 |
|
|
|
346 |
<p>In this example, we'll look at how you can setup listeners for attribute change events, and work with the event payload which the listeners receive, |
|
|
347 |
using the <code>SpeedDater</code> class, introduced in the <a href="attribute-basic-speeddate.html">"Attribute Based Speed Dating" example</a>.</p> |
|
|
348 |
|
|
|
349 |
<p>We'll create two SpeedDater instances, <code>jane</code> and <code>john</code>, and use the attribute events they generate both internally (within the class code), to wire up UI refreshes, |
|
|
350 |
and externally, to have <code>jane</code> react to changes in the <code>john</code>'s state.</p> |
|
|
351 |
|
|
|
352 |
<h3>Setting Up The SpeedDater Class With Attribute</h3> |
|
|
353 |
|
|
|
354 |
<p>We start by setting up the same basic class we created for the <a href="attribute-basic-speeddate.html">"Attribute Based Speed Dating" example</a>, with an additional attribute, <code>interests</code>, using the code below:</p> |
|
|
355 |
|
|
|
356 |
<pre class="code prettyprint">// Setup custom class which we want to add managed attribute support to |
|
|
357 |
function SpeedDater(cfg) { |
|
|
358 |
// When constructed, setup the initial attributes for the instance, |
|
|
359 |
// by calling the addAttrs method. |
|
|
360 |
var attrs = { |
|
|
361 |
name : { |
|
|
362 |
writeOnce:true |
|
|
363 |
}, |
|
|
364 |
|
|
|
365 |
personality : { |
|
|
366 |
value:50 |
|
|
367 |
}, |
|
|
368 |
|
|
|
369 |
available : { |
|
|
370 |
value:true |
|
|
371 |
}, |
|
|
372 |
|
|
|
373 |
interests : { |
|
|
374 |
value : [] |
|
|
375 |
} |
|
|
376 |
}; |
|
|
377 |
|
|
|
378 |
this.addAttrs(attrs, cfg); |
|
|
379 |
} |
|
|
380 |
|
|
|
381 |
// Augment custom class with Attribute |
|
|
382 |
Y.augment(SpeedDater, Y.Attribute);</pre> |
|
|
383 |
|
|
|
384 |
|
|
|
385 |
<p>We then create two instances of SpeedDaters, <code>jane</code> and <code>john</code>:</p> |
|
|
386 |
|
|
|
387 |
<pre class="code prettyprint">// Create a john instance... |
|
|
388 |
john = new SpeedDater({ |
|
|
389 |
name: "John", |
|
|
390 |
personality: 78 |
|
|
391 |
}); |
|
|
392 |
// ... and render to the page |
|
|
393 |
john.applyNameTag("#john .shirt"); |
|
|
394 |
|
|
|
395 |
// Create a jane instance... |
|
|
396 |
jane = new SpeedDater({ |
|
|
397 |
name: "Jane", |
|
|
398 |
personality: 82, |
|
|
399 |
interests: ["Popcorn", "Saving Whales"] |
|
|
400 |
}); |
|
|
401 |
jane.applyNameTag("#jane .shirt");</pre> |
|
|
402 |
|
|
|
403 |
|
|
|
404 |
<h3>Registering Event Listeners</h3> |
|
|
405 |
|
|
|
406 |
<p>For this event based example, we no longer have an <code>updateNameTag()</code> method which the user is responsible for calling when they want to refresh the name tag rendered on the page, as we did in the basic example. |
|
|
407 |
Instead the <code>SpeedDater</code> class sets up some internal attribute change event listeners in its <code>listenForChanges()</code> method, which will refresh the UI for a particular attribute, each time its value is modified:</p> |
|
|
408 |
|
|
|
409 |
<pre class="code prettyprint">// Method used to attach attribute change event listeners, so that |
|
|
410 |
// the SpeedDater instance will react to changes in attribute state, |
|
|
411 |
// and update what's rendered on the page |
|
|
412 |
SpeedDater.prototype.listenForChanges = function() { |
|
|
413 |
|
|
|
414 |
// Sync up the UI for "available", after the value of the "available" |
|
|
415 |
// attribute has changed: |
|
|
416 |
this.after("availableChange", function(e) { |
|
|
417 |
var taken = (e.newVal) ? "" : "Oh, is that the time?"; |
|
|
418 |
this.nameTag.one(".sd-availability").set("innerHTML", taken); |
|
|
419 |
}); |
|
|
420 |
|
|
|
421 |
// Sync up the UI for "name", after the value of the "name" |
|
|
422 |
// attribute has changed: |
|
|
423 |
this.after("nameChange", function(e) { |
|
|
424 |
var name = e.newVal; |
|
|
425 |
this.nameTag.one(".sd-name").set("innerHTML", name); |
|
|
426 |
}); |
|
|
427 |
|
|
|
428 |
// Sync up the UI for "personality", after the value of the "personality" |
|
|
429 |
// attribute has changed: |
|
|
430 |
this.after("personalityChange", function(e) { |
|
|
431 |
var personality = e.newVal; |
|
|
432 |
|
|
|
433 |
var personalityEl = this.nameTag.one(".sd-personality"); |
|
|
434 |
personalityEl.set("innerHTML", personality); |
|
|
435 |
|
|
|
436 |
if (personality > 90) { |
|
|
437 |
personalityEl.addClass("sd-max"); |
|
|
438 |
} |
|
|
439 |
}); |
|
|
440 |
|
|
|
441 |
// Sync up the UI for "interests", after the value of the "interests" |
|
|
442 |
// attribute has changed: |
|
|
443 |
this.after("interestsChange", function(e) { |
|
|
444 |
var interests = (e.newVal.length == 0) ? |
|
|
445 |
"absolutely nothing" : this.get("interests").join(", "); |
|
|
446 |
this.nameTag.one(".sd-interests").set("innerHTML", interests); |
|
|
447 |
}); |
|
|
448 |
};</pre> |
|
|
449 |
|
|
|
450 |
|
|
|
451 |
<p> |
|
|
452 |
As seen in the above code, the event type for attribute change events is created by concatenating the attribute name with <code>"Change"</code> (e.g. <code>"availableChange"</code>). Whenever an attribute value is changed through Attribute's <code>set()</code> method, both <em>"on"</em> and <em>"after"</em> subscribers are notified. |
|
|
453 |
</p> |
|
|
454 |
<p> |
|
|
455 |
In the code snippet above, all the subscribers are listening for the <em>"after"</em> moment using the <code>after()</code> subscription method, since they're only interested in being notified after the value has actually changed. |
|
|
456 |
However, as we'll see below, the example also shows you how to use an <em>"on"</em> listener, to prevent the attribute state change from occuring under certain conditions. |
|
|
457 |
</p> |
|
|
458 |
|
|
|
459 |
<h3>On vs. After</h3> |
|
|
460 |
|
|
|
461 |
<p>A single attribute change event has two moments which can be subscribed to, depending on what the subscriber wants to do when notified.</p> |
|
|
462 |
|
|
|
463 |
<p><strong>on :</strong> Subscribers to the <em>"on"</em> moment, will be notified <em>before</em> any actual state change has occurred. This provides the opportunity to prevent the state change from occurring, |
|
|
464 |
using the <code>preventDefault()</code> method of the event facade object passed to the subscriber. If you use <code>get()</code> to retrieve the value of the attribute in an <em>"on"</em> subscriber, you will receive the current, unchanged value. |
|
|
465 |
However the event facade provides access to the value which the attribute is being set to, through it's <code>newVal</code> property.</p> |
|
|
466 |
|
|
|
467 |
<p><strong>after :</strong> Subscribers to the <em>"after"</em> moment, will be notified <em>after</em> the attribute's state has been updated. |
|
|
468 |
This provides the opportunity to update state in other parts of your application, in response to a change in the attribute's state.</p> |
|
|
469 |
|
|
|
470 |
<p>Based on the definition above, <code>after</code> listeners are not invoked if state change is prevented; for example, due to one of the <em>"on"</em> listeners calling <code>preventDefault()</code> on the event object passed to the subscriber.</p> |
|
|
471 |
|
|
|
472 |
<h3>Having Jane React To John</h3> |
|
|
473 |
|
|
|
474 |
<p>Aside from the internal listeners set up by the class, in this example <code>jane</code> also sets up two more subscribers. The first is a subscriber, which allows <code>jane</code> to "reconsider" changing the state of her <code>available</code> attribute, |
|
|
475 |
under certain conditions. Since she may want to prevent the <code>available</code> attribute from being modified in this case, we use Attribute's <code>on()</code> method to listen for the <em>"on"</em> moment, so that the default behavior can be prevented:</p> |
|
|
476 |
|
|
|
477 |
<pre class="code prettyprint">// We can also listen before an attribute changes its value, and |
|
|
478 |
// decide if we want to allow the state change to occur or not. |
|
|
479 |
|
|
|
480 |
// Invoking e.preventDefault() stops the state from being updated. |
|
|
481 |
|
|
|
482 |
// In this case, Jane can change her mind about making herself |
|
|
483 |
// unavailable, if John likes saving whales, as long as he doesn't |
|
|
484 |
// dig knitting too. |
|
|
485 |
|
|
|
486 |
jane.on("availableChange", function(e) { |
|
|
487 |
var johnsInterests = john.get("interests"); |
|
|
488 |
var janeAvailable = e.newVal; |
|
|
489 |
|
|
|
490 |
if (janeAvailable === false && Y.Array.indexOf(johnsInterests, "Saving Whales") !== -1 |
|
|
491 |
&& Y.Array.indexOf(johnsInterests, "Knitting") == -1 ) { |
|
|
492 |
// Reconsider.. |
|
|
493 |
e.preventDefault(); |
|
|
494 |
}; |
|
|
495 |
});</pre> |
|
|
496 |
|
|
|
497 |
|
|
|
498 |
<p>We also set up an <em>"after"</em> listener on the <code>john</code> instance, which allows <code>jane</code> to update her interests, so she can admit to enjoying "Reading Specifications", if <code>john</code> admits it first:</p> |
|
|
499 |
|
|
|
500 |
<pre class="code prettyprint">// Consider updating Jane's interests state, after John's interests |
|
|
501 |
// state changes... |
|
|
502 |
john.after("interestsChange", function(e) { |
|
|
503 |
|
|
|
504 |
var janesInterests = jane.get("interests"), |
|
|
505 |
|
|
|
506 |
// Get john's new interests from the attribute change event... |
|
|
507 |
johnsInterests = e.newVal, |
|
|
508 |
|
|
|
509 |
readingSpecs = "Reading Specifications"; |
|
|
510 |
|
|
|
511 |
// If it turns out that John enjoys reading specs, then Jane can admit it too... |
|
|
512 |
if (Y.Array.indexOf(johnsInterests, readingSpecs) !== -1) { |
|
|
513 |
if(Y.Array.indexOf(janesInterests, readingSpecs) == -1) { |
|
|
514 |
janesInterests.push(readingSpecs); |
|
|
515 |
} |
|
|
516 |
} else { |
|
|
517 |
// Otherwise, we use Y.Array.reject, provided by the "collection" module, |
|
|
518 |
// to remove "Reading Specifications" from jane's interests.. |
|
|
519 |
janesInterests = Y.Array.reject(janesInterests, |
|
|
520 |
function(item){return (item == readingSpecs);}); |
|
|
521 |
} |
|
|
522 |
|
|
|
523 |
jane.set("interests", janesInterests); |
|
|
524 |
jane.set("available", true); |
|
|
525 |
|
|
|
526 |
... |
|
|
527 |
});</pre> |
|
|
528 |
|
|
|
529 |
|
|
|
530 |
<h3>Event Facade</h3> |
|
|
531 |
|
|
|
532 |
<p>The event object (an instance of <a href="http://yuilibrary.com/yui/docs/api/EventFacade.html">EventFacade</a>) passed to attribute change event subscribers, has the following interesting properties and methods related to attribute management:</p> |
|
|
533 |
|
|
|
534 |
<dl> |
|
|
535 |
<dt>newVal</dt> |
|
|
536 |
<dd>The value which the attribute will be set to (in the case of <em>"on"</em> subscribers), or has been set to (in the case of <em>"after"</em> subscribers</dd> |
|
|
537 |
<dt>prevVal</dt> |
|
|
538 |
<dd>The value which the attribute is currently set to (in the case of <em>"on"</em> subscribers), or was previously set to (in the case of <em>"after"</em> subscribers</dd> |
|
|
539 |
<dt>attrName</dt> |
|
|
540 |
<dd>The name of the attribute which is being set</dd> |
|
|
541 |
<dt>subAttrName</dt> |
|
|
542 |
<dd>Attribute also allows you to set nested properties of attributes which have values which are objects through the |
|
|
543 |
<code>set</code> method (e.g. <code>o1.set("x.y.z")</code>). This property will contain the path to the property which was changed.</dd> |
|
|
544 |
<dt>preventDefault()<dt> |
|
|
545 |
<dd>This method can be called in an <em>"on"</em> subscriber to prevent the attribute's value from being updated (the default behavior). Calling this method in an <em>"after"</em> listener has no impact, since the default behavior has already been invoked.</dd> |
|
|
546 |
<dt>stopImmediatePropagation()</dt> |
|
|
547 |
<dd>This method can be called in <em>"on"</em> or <em>"after"</em> subscribers, and will prevent the rest of the subscriber stack from |
|
|
548 |
being invoked, but will not prevent the attribute's value from being updated.</dd> |
|
|
549 |
</dl> |
|
|
550 |
|
|
|
551 |
<h2>Complete Example Source</h2> |
|
|
552 |
|
|
|
553 |
<pre class="code prettyprint"><div id="speeddate"> |
|
|
554 |
|
|
|
555 |
<h1>Communicating With Attribute Events On Speed Dates</h1> |
|
|
556 |
|
|
|
557 |
<div id="john"> |
|
|
558 |
<button type="button" class="hi">Hi, I'm John</button> |
|
|
559 |
|
|
|
560 |
<span class="interests disabled"> |
|
|
561 |
I enjoy: |
|
|
562 |
<label><input type="checkbox" id="sunsets" class="interest" value="Sunsets" disabled="disabled"> Sunsets</label> |
|
|
563 |
<label><input type="checkbox" id="specs" class="interest" value="Reading Specifications" disabled="disabled"> Reading Specifications</label> |
|
|
564 |
<label><input type="checkbox" id="whales" class="interest" value="Saving Whales" disabled="disabled"> Saving Whales</label> |
|
|
565 |
<label><input type="checkbox" id="knitting" class="interest" value="Knitting" disabled="disabled"> Knitting</label> |
|
|
566 |
</span> |
|
|
567 |
<div class="shirt"></div> |
|
|
568 |
</div> |
|
|
569 |
|
|
|
570 |
<div id="jane"> |
|
|
571 |
<button type="button" class="hi" disabled="disabled">Hey, I'm Jane</button> |
|
|
572 |
<button type="button" class="movingOn" disabled="disabled">I'm Moving On...</button> <span class="reconsider disabled">(unless he likes whales, and avoids knitting <em class="message"></em>)</span> |
|
|
573 |
<div class="shirt"></div> |
|
|
574 |
</div> |
|
|
575 |
</div> |
|
|
576 |
|
|
|
577 |
<script type="text/javascript"> |
|
|
578 |
|
|
|
579 |
// Get a new instance of YUI and |
|
|
580 |
// load it with the required set of modules |
|
|
581 |
|
|
|
582 |
YUI().use("collection", "event", "node", "attribute", function(Y) { |
|
|
583 |
|
|
|
584 |
// Setup custom class which we want to add managed attribute support to |
|
|
585 |
|
|
|
586 |
function SpeedDater(cfg) { |
|
|
587 |
// When constructed, setup the initial attributes for the instance, by calling the addAttrs method. |
|
|
588 |
var attrs = { |
|
|
589 |
name : { |
|
|
590 |
writeOnce:true |
|
|
591 |
}, |
|
|
592 |
|
|
|
593 |
personality : { |
|
|
594 |
value:50 |
|
|
595 |
}, |
|
|
596 |
|
|
|
597 |
available : { |
|
|
598 |
value:true |
|
|
599 |
}, |
|
|
600 |
|
|
|
601 |
interests : { |
|
|
602 |
value : [] |
|
|
603 |
} |
|
|
604 |
}; |
|
|
605 |
|
|
|
606 |
this.addAttrs(attrs, cfg); |
|
|
607 |
} |
|
|
608 |
|
|
|
609 |
// The HTML template representing the SpeedDater name tag. |
|
|
610 |
SpeedDater.NAMETAG = '<div class="sd-nametag"> \ |
|
|
611 |
<div class="sd-hd">Hello!</div> \ |
|
|
612 |
<div class="sd-bd"> \ |
|
|
613 |
<p>I\'m <span class="sd-name">{name}</span> and my PersonalityQuotientIndex is <span class="sd-personality">{personality}</span></p> \ |
|
|
614 |
<p>I enjoy <span class="sd-interests">{interests}</span>.</p> \ |
|
|
615 |
</div> \ |
|
|
616 |
<div class="sd-ft sd-availability">{available}</div> \ |
|
|
617 |
</div>'; |
|
|
618 |
|
|
|
619 |
// Method used to render the visual representation of a SpeedDater object's state (in this case as a name tag) |
|
|
620 |
SpeedDater.prototype.applyNameTag = function(where) { |
|
|
621 |
|
|
|
622 |
var tokens = { |
|
|
623 |
name: this.get("name"), |
|
|
624 |
available: (this.get("available")) ? "" : "Sorry, moving on", |
|
|
625 |
personality: this.get("personality"), |
|
|
626 |
interests: (this.get("interests").length == 0) ? "absolutely nothing" : this.get("interests").join(", ") |
|
|
627 |
}; |
|
|
628 |
|
|
|
629 |
this.nameTag = Y.Node.create(Y.Lang.sub(SpeedDater.NAMETAG, tokens)); |
|
|
630 |
Y.one(where).appendChild(this.nameTag); |
|
|
631 |
|
|
|
632 |
this.listenForChanges(); |
|
|
633 |
}; |
|
|
634 |
|
|
|
635 |
// Method used to attach attribute change event listeners, so that the SpeedDater instance |
|
|
636 |
// will react to changes in attribute state, and update what's rendered on the page |
|
|
637 |
SpeedDater.prototype.listenForChanges = function() { |
|
|
638 |
|
|
|
639 |
// Sync up the UI for "available", after the value of the "available" attribute has changed: |
|
|
640 |
this.after("availableChange", function(e) { |
|
|
641 |
var taken = (e.newVal) ? "" : "Oh, is that the time?"; |
|
|
642 |
this.nameTag.one(".sd-availability").set("innerHTML", taken); |
|
|
643 |
}); |
|
|
644 |
|
|
|
645 |
// Sync up the UI for "name", after the value of the "name" attribute has changed: |
|
|
646 |
this.after("nameChange", function(e) { |
|
|
647 |
var name = e.newVal; |
|
|
648 |
this.nameTag.one(".sd-name").set("innerHTML", name); |
|
|
649 |
}); |
|
|
650 |
|
|
|
651 |
// Sync up the UI for "personality", after the value of the "personality" attribute has changed: |
|
|
652 |
this.after("personalityChange", function(e) { |
|
|
653 |
var personality = e.newVal; |
|
|
654 |
|
|
|
655 |
var personalityEl = this.nameTag.one(".sd-personality"); |
|
|
656 |
personalityEl.set("innerHTML", personality); |
|
|
657 |
|
|
|
658 |
if (personality > 90) { |
|
|
659 |
personalityEl.addClass("sd-max"); |
|
|
660 |
} |
|
|
661 |
}); |
|
|
662 |
|
|
|
663 |
// Sync up the UI for "interests", after the value of the "interests" attribute has changed: |
|
|
664 |
this.after("interestsChange", function(e) { |
|
|
665 |
var interests = (e.newVal.length == 0) ? "absolutely nothing" : this.get("interests").join(", "); |
|
|
666 |
this.nameTag.one(".sd-interests").set("innerHTML", interests); |
|
|
667 |
}); |
|
|
668 |
}; |
|
|
669 |
|
|
|
670 |
// Augment custom class with Attribute |
|
|
671 |
Y.augment(SpeedDater, Y.Attribute); |
|
|
672 |
|
|
|
673 |
var john, jane; |
|
|
674 |
|
|
|
675 |
Y.on("click", function() { |
|
|
676 |
|
|
|
677 |
if (!john) { |
|
|
678 |
|
|
|
679 |
john = new SpeedDater({ |
|
|
680 |
name: "John", |
|
|
681 |
personality: 78 |
|
|
682 |
}); |
|
|
683 |
john.applyNameTag("#john .shirt"); |
|
|
684 |
|
|
|
685 |
Y.one("#jane .hi").set("disabled", false); |
|
|
686 |
} |
|
|
687 |
|
|
|
688 |
}, "#john .hi"); |
|
|
689 |
|
|
|
690 |
Y.on("click", function() { |
|
|
691 |
|
|
|
692 |
if (!jane) { |
|
|
693 |
|
|
|
694 |
jane = new SpeedDater({ |
|
|
695 |
name: "Jane", |
|
|
696 |
personality: 82, |
|
|
697 |
interests: ["Popcorn", "Saving Whales"] |
|
|
698 |
}); |
|
|
699 |
jane.applyNameTag("#jane .shirt"); |
|
|
700 |
|
|
|
701 |
// Update Jane's interests state, after John's interests state changes... |
|
|
702 |
john.after("interestsChange", function(e) { |
|
|
703 |
|
|
|
704 |
var janesInterests = jane.get("interests"), |
|
|
705 |
johnsInterests = e.newVal, |
|
|
706 |
|
|
|
707 |
readingSpecs = "Reading Specifications"; |
|
|
708 |
|
|
|
709 |
// If it turns out that John enjoys reading specs, then Jane can admit it too... |
|
|
710 |
if (Y.Array.indexOf(johnsInterests, readingSpecs) !== -1) { |
|
|
711 |
if(Y.Array.indexOf(janesInterests, readingSpecs) == -1) { |
|
|
712 |
janesInterests.push(readingSpecs); |
|
|
713 |
} |
|
|
714 |
} else { |
|
|
715 |
janesInterests = Y.Array.reject(janesInterests, function(item){return (item == readingSpecs);}); |
|
|
716 |
} |
|
|
717 |
|
|
|
718 |
jane.set("interests", janesInterests); |
|
|
719 |
jane.set("available", true); |
|
|
720 |
|
|
|
721 |
setMessage(""); |
|
|
722 |
}); |
|
|
723 |
|
|
|
724 |
// We can also listen before an attribute changes its value, and decide if we want to |
|
|
725 |
// allow the state change to occur or not. Invoking e.preventDefault() stops the state from |
|
|
726 |
// being updated. |
|
|
727 |
|
|
|
728 |
// In this case, Jane can change her mind about making herself unavailable, if John likes |
|
|
729 |
// saving whales, as long as he doesn't dig knitting too. |
|
|
730 |
|
|
|
731 |
jane.on("availableChange", function(e) { |
|
|
732 |
var johnsInterests = john.get("interests"); |
|
|
733 |
var janeAvailable = e.newVal; |
|
|
734 |
if (janeAvailable === false && Y.Array.indexOf(johnsInterests, "Saving Whales") !== -1 && Y.Array.indexOf(johnsInterests, "Knitting") == -1 ) { |
|
|
735 |
// Reconsider.. |
|
|
736 |
e.preventDefault(); |
|
|
737 |
|
|
|
738 |
setMessage("... which he does"); |
|
|
739 |
}; |
|
|
740 |
}); |
|
|
741 |
|
|
|
742 |
enableExampleUI(); |
|
|
743 |
} |
|
|
744 |
|
|
|
745 |
}, "#jane .hi"); |
|
|
746 |
|
|
|
747 |
Y.on("click", function() { |
|
|
748 |
jane.set("available", false); |
|
|
749 |
}, "#jane .movingOn"); |
|
|
750 |
|
|
|
751 |
// A delegate DOM event listener which will update John's interests, based on the checkbox state, whenever |
|
|
752 |
// a checkbox is clicked. (Using click for IE, due to it's weirdness with requiring a blur before firing change) |
|
|
753 |
Y.delegate("click", function() { |
|
|
754 |
var interests = []; |
|
|
755 |
|
|
|
756 |
Y.Node.all("#john input[type=checkbox].interest").each(function(checkbox) { |
|
|
757 |
if (checkbox.get("checked")) { |
|
|
758 |
interests.push(checkbox.get("value")); |
|
|
759 |
} |
|
|
760 |
}); |
|
|
761 |
john.set("interests", interests); |
|
|
762 |
|
|
|
763 |
}, "#john", "input[type=checkbox].interest"); |
|
|
764 |
|
|
|
765 |
|
|
|
766 |
// Example helpers... |
|
|
767 |
function enableExampleUI() { |
|
|
768 |
Y.all("#jane button").set("disabled", false); |
|
|
769 |
Y.all("#john button").set("disabled", false); |
|
|
770 |
Y.all("#john input").set("disabled", false); |
|
|
771 |
Y.one("#john .interests").removeClass("disabled"); |
|
|
772 |
Y.one("#jane .reconsider").removeClass("disabled"); |
|
|
773 |
} |
|
|
774 |
|
|
|
775 |
function setMessage(msg) { |
|
|
776 |
Y.one("#jane .message").set("innerHTML", msg); |
|
|
777 |
} |
|
|
778 |
|
|
|
779 |
}); |
|
|
780 |
</script></pre> |
|
|
781 |
|
|
|
782 |
</div> |
|
|
783 |
</div> |
|
|
784 |
</div> |
|
|
785 |
|
|
|
786 |
<div class="yui3-u-1-4"> |
|
|
787 |
<div class="sidebar"> |
|
|
788 |
|
|
|
789 |
|
|
|
790 |
|
|
|
791 |
<div class="sidebox"> |
|
|
792 |
<div class="hd"> |
|
|
793 |
<h2 class="no-toc">Examples</h2> |
|
|
794 |
</div> |
|
|
795 |
|
|
|
796 |
<div class="bd"> |
|
|
797 |
<ul class="examples"> |
|
|
798 |
|
|
|
799 |
|
|
|
800 |
<li data-description="Use the Attribute API to define, set and get attribute values."> |
|
|
801 |
<a href="attribute-basic.html">Basic Attribute Configuration</a> |
|
|
802 |
</li> |
|
|
803 |
|
|
|
804 |
|
|
|
805 |
|
|
|
806 |
<li data-description="Configure attributes to be readOnly or writeOnce."> |
|
|
807 |
<a href="attribute-rw.html">Read-Only and Write-Once Attributes</a> |
|
|
808 |
</li> |
|
|
809 |
|
|
|
810 |
|
|
|
811 |
|
|
|
812 |
<li data-description="How to listen for changes in attribute values."> |
|
|
813 |
<a href="attribute-event.html">Attribute Change Events</a> |
|
|
814 |
</li> |
|
|
815 |
|
|
|
816 |
|
|
|
817 |
|
|
|
818 |
<li data-description="Create a basic SpeedDater class, with Attribute support."> |
|
|
819 |
<a href="attribute-basic-speeddate.html">Attribute Based Speed Dating</a> |
|
|
820 |
</li> |
|
|
821 |
|
|
|
822 |
|
|
|
823 |
|
|
|
824 |
<li data-description="Refactors the basic Speed Dating example, to use attribute change events to update rendered elements, and have two instances react to another."> |
|
|
825 |
<a href="attribute-event-speeddate.html">Attribute Event Based Speed Dating</a> |
|
|
826 |
</li> |
|
|
827 |
|
|
|
828 |
|
|
|
829 |
|
|
|
830 |
<li data-description="Add custom methods to get and set attribute values and provide validation support."> |
|
|
831 |
<a href="attribute-getset.html">Attribute Getters, Setters and Validators</a> |
|
|
832 |
</li> |
|
|
833 |
|
|
|
834 |
|
|
|
835 |
</ul> |
|
|
836 |
</div> |
|
|
837 |
</div> |
|
|
838 |
|
|
|
839 |
|
|
|
840 |
|
|
|
841 |
</div> |
|
|
842 |
</div> |
|
|
843 |
</div> |
|
|
844 |
</div> |
|
|
845 |
|
|
|
846 |
<script src="../assets/vendor/prettify/prettify-min.js"></script> |
|
|
847 |
<script>prettyPrint();</script> |
|
|
848 |
|
|
|
849 |
<script> |
|
|
850 |
YUI.Env.Tests = { |
|
|
851 |
examples: [], |
|
|
852 |
project: '../assets', |
|
|
853 |
assets: '../assets/attribute', |
|
|
854 |
name: 'attribute-event-speeddate', |
|
|
855 |
title: 'Attribute Event Based Speed Dating', |
|
|
856 |
newWindow: '', |
|
|
857 |
auto: false |
|
|
858 |
}; |
|
|
859 |
YUI.Env.Tests.examples.push('attribute-basic'); |
|
|
860 |
YUI.Env.Tests.examples.push('attribute-rw'); |
|
|
861 |
YUI.Env.Tests.examples.push('attribute-event'); |
|
|
862 |
YUI.Env.Tests.examples.push('attribute-basic-speeddate'); |
|
|
863 |
YUI.Env.Tests.examples.push('attribute-event-speeddate'); |
|
|
864 |
YUI.Env.Tests.examples.push('attribute-getset'); |
|
|
865 |
|
|
|
866 |
</script> |
|
|
867 |
<script src="../assets/yui/test-runner.js"></script> |
|
|
868 |
|
|
|
869 |
|
|
|
870 |
|
|
|
871 |
</body> |
|
|
872 |
</html> |