Add 'show' event when an object is added to a container

agility.js

@@ -194,6 +194,7 @@
         }
         this._container.children[obj._id] = obj; // children is *not* an array; this is for simpler lookups by global object id
         this.trigger(method, [obj, selector]);
+        obj.trigger('show'); // Dispatch show event to object
         // ensures object is removed from container when destroyed:
         obj.bind('destroy', function(event, id){ 
           self._container.remove(id);

docs/_docs.md

@@ -276,6 +276,7 @@ Agility events are fired by the object core, as well as Models and plugins. When
 Presently, the following Agility events are fired:
 
 + `create`: Fired upon object creation.
++ `show`: Fired when the object is added to a container.
 + `destroy`: Fired before object is destroyed.
 + `add`: Fired when a new Agility object is added to the object's container.
 + `remove`: Fired with an Agility object is removed from the object's container.

docs/docs.html

@@ -352,6 +352,7 @@ <h3><a href="#events-agility">Agility events</a></h3>
 <p>Presently, the following Agility events are fired:</p>
 <ul>
 <li><code>create</code>: Fired upon object creation.</li>
+<li><code>show</code>: Fired when the object is added to a container.</li>
 <li><code>destroy</code>: Fired before object is destroyed.</li>
 <li><code>add</code>: Fired when a new Agility object is added to the object's container.</li>
 <li><code>remove</code>: Fired with an Agility object is removed from the object's container.</li>
@@ -947,6 +948,7 @@ <h3><a href="#persist-restful">$$.adapter.restful</a></h3>
 api/resource/123
 </pre></div>
 
+
     </div>
   </div>
 

docs/gallery.html

@@ -100,6 +100,7 @@ <h2><a href="http://thewall.agilityjs.com">The Wall</a></h2>
 <h3>User submissions</h3>
 <p>Have you created an awesome project that showcases Agility's capabilities? <a href="https://github.com/arturadib/agility/tree/gh-pages">Fork this site</a>, add a brief description of your project, and send a pull request. We'd love to see what you can do with Agility!</p>
 
+
     </div>
   </div>
 

index.html

@@ -379,6 +379,7 @@ <h3>The infamous To-Do example</h3>
 
 <p><div class="demo"></div></p>
 
+
     </div>
   </div>
 

test/public/core.js

@@ -1047,6 +1047,20 @@
     ok(o===obj1 && s==='sel', "append() called");
   });
 
+  test("`show` container event", function(){
+    var showCalled = false;
+    var obj1 = $$();
+    var obj2 = $$({
+        controller: {
+            show: function(){
+                showCalled = true;
+            }
+        }
+    });
+    obj1.append(obj2);
+    ok(showCalled, "show() called");
+  });
+
   test("Model events", function(){
     var t = false;
     var obj = $$({}, {}, {