c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff<link href="{{componentAssets}}/node.css" rel="stylesheet" type="text/css">
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff<div class="intro">
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff <p>This example demonstrates how to use multiple NodeList features to build a simple game.</p>
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff<div class="example">
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff{{>ducks-source}}
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>The HTML</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff{{>ducks-html}}
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>YUI Instance</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffThe `use` statement doesn't include `node` because it's loaded as a requirement of transition.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffYUI().use('transition', 'button', function(Y){
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // code goes here
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Setting Vars</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffThe variable `ducks` is used for easily manipulating all the ducks at once.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffWe'll display various duck comments from the array `squawkTextArr` on a rotating basis.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var ducks = Y.all('.duck-row li'),
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff ducksRemaining = 10, // value for UI display
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff squawkTextIndex = 0, // index in the squawkTextArr to use next
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff squawkTextArr = [ // duck comments
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff '911 on U!',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff "U fly's down",
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff 'duck pile!',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff 'Ricochets kill!',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff 'how sporting.',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff "shoe's untied"
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Initializing the Ducks</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffRepetitive markup is added with the `.append()` method to all the ducks in the `NodeList`.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffThis keeps the original markup simple and clear.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // append the same content for each duck <li>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff ducks.append('<img src="../assets/node/images/duck.png"/><div class="squawk"><div class="text">#@&~*Q!</div><div class="small-squawk-bubble"></div></div>');
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffAll the ducks in the `NodeList` are given the `set-up` class with the `.addClass()` method.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffThis class is found on any duck that has the state of being set up, as opposed to being knocked down.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // give them all the set-up state class
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffThis state could be a Boolean property, but it's handy as a class,
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniffbecause a `NodeList` can be made containing the squawks of all "set up" ducks in this way,
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff`squawks = Y.all('.duck-row .set-up .squawk');`
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniffas we'll see in the `makeDucksSquawk` function.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Making the Ducks Swim</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffThis uses `transition` to make the ducks swim right to left
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // this makes the ducks move from right to left.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // When the duck on the far left disappears from view,
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // it's added to the far right end of the row.
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var makeDucksSwim = function () {
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var frontDuck;
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // move the duck row to the left one duck space over 2 seconds
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.one('.duck-row').transition({
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff easing: 'linear',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff left: '-119px',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff }, function () { // when the row finishes its right to left transition...
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // remove the first duck on the left
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // which has trasitioned out of view
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff frontDuck = Y.one('.duck-row li').remove();
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // append the removed first duck onto the right end
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.one('.duck-row').appendChild(frontDuck);
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // set the position for the next makeDucksSwim()
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.one('.duck-row').setStyle('left', '10px');
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // if there are ducks remaining, make them swim again
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff if (ducksRemaining > 0) {
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff makeDucksSwim();
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff makeDucksSwim(); // this initializes the ducks swimming
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Click Event Handler</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // handles a click on a duck
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var duckClick = function(e) {
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var squawks;
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // remove the squawk belonging to the duck that was clicked
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff e.currentTarget.one('.squawk').setStyles({'top': '-400px', 'opacity': '1'});
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // makes the ducks appear to lay back when clicked
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff duration: 0.2,
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff height: '3px',
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff width: '133px'
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // the clicked duck will no longer have the 'set-up' class/state
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff makeDucksSquawk(); // makes the ducks squawk
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff updateDucksRemaining(); // update the number of ducks still set up
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Squawking Ducks</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // this makes the duck's squawks show and hide and get various text
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var makeDucksSquawk = function(){
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff squawks = Y.all('.duck-row .set-up .squawk'); // a NodeList of the squawks of set-up ducks
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff if (Y.one('#show-attitude')._node.checked) { // only have ducks squawk if the checkbox is checked
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // fill voice bubbles with next text string
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.all('.duck-row .set-up .squawk .text').setContent(squawkTextArr[squawkTextIndex]);
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // increment the index to get the next squawk text
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff squawkTextIndex = (squawkTextIndex += 1) % (squawkTextArr.length);
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff value: '0px', // drop squawks into position from hidden
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff duration: 0 // instant position change
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff opacity: { // fade out
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff duration: 0.3,
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff }, function(e){
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // after squawks are faded out,
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // move them to hidden position and set opacity to 1 again
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff squawks.setStyles({'top': '-400px', 'opacity': '1'});
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Reset and Ducks Remaining</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // This resets all ducks, "ducks remaining" counters, and row position
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // make the duck images full height
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // start them swimming
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var reset = function() {
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.all('.duck-row li img').setStyle('height', '55px');
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.all('.duck-row li').addClass('set-up');
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff updateDucksRemaining();
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff makeDucksSwim();
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // counts the ducks remaining, and updates the UI counter display
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff var updateDucksRemaining = function() {
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff ducksRemaining = Y.all('.gallery li.set-up').size();
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.one('.ducks-remain').setContent(ducksRemaining);
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff<h2>Prefer `node.delegate()` over `nodelist.on()`</h2>
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff<p>Sometimes you need to create individual subscriptions for each Node in a
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff ConniffNodeList, but usually it's preferable to use
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<a href="node-evt-delegation.html">event delegation</a> as shown in this example.</p>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff<h2>Listeners</h2>
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff // listeners
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.one('.duck-row').delegate('click', duckClick, 'li');
bb82d389f8b12cd4366603113b2fc397561c0b9dJeff Conniff Y.one('#button-reset').on('click', reset);
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff<h2>Complete Ducks Example Source</h2>
c6d4c11c9b36a9645bee58eb43cbf7c674e2028cJeff Conniff{{>ducks-source}}