src : add onLayout option

add docs and test

_posts/docs/2010-12-03-options.mdown

@@ -16,6 +16,7 @@ toc:
   - { title: itemPositionDataEnabled, anchor: itempositiondataenabled }
   - { title: itemSelector, anchor: itemselector }
   - { title: layoutMode, anchor: layoutmode }
+  - { title: onLayout, anchor: onlayout }
   - { title: resizable, anchor: resizable }
   - { title: resizesContainer, anchor: resizescontainer }
   - { title: sortAscending, anchor: sortascending }
@@ -210,6 +211,15 @@ See also docs on [Layout modes](layout-modes.html).
 
 [**See Demo: Layout modes**](../demos/layout-modes.html)
 
+## onLayout
+
+<dl class="clearfix">
+  <dt><code>onLayout</code></dt>
+  <dd class="option-type">Function</dd>
+</dl>
+
+Similiar to a callback, `onLayout` is a function that will be triggered after every time an Isotope instance runs through its layout logic.
+
 ## resizable
 
 <dl class="clearfix">

_posts/tests/2012-02-07-onlayout.html

@@ -0,0 +1,170 @@
+---
+title: onLayout
+layout: default
+category: tests
+---
+
+<section id="copy">
+  <p>Tests that onLayout callback is triggering properly, after animation/transition has completed.</p>
+
+</section>
+
+<section id="options" class="clearfix">
+
+  {% include filter-buttons.html %}
+
+  {% include sort-buttons.html %}
+
+  <h3>Etc</h3>
+
+  <ul id="etc" class="clearfix">
+    <li id="toggle-sizes"><a href="#toggle-sizes">Toggle variable sizes</a></li>
+    <li id="insert"><a href="#insert">Insert new elements</a></li>
+    <li id="append"><a href='#append'>Append new elements</a></li>
+    <li id="shuffle"><a href='#shuffle'>Shuffle</a></li>
+  </ul>
+
+</section> <!-- #options -->
+
+<div id="container" class="clickable variable-sizes clearfix">
+  {% for elem_number in site.best_of_order %}
+    {% assign element = site.elements[elem_number] %}
+    {% include element-partial.html %}
+  {% endfor %}
+</div> <!-- #container -->
+
+
+<script src="../{{ site.jquery_js }}"></script>
+<script src="../{{ site.isotope_js }}"></script>
+<script src="../js/fake-element.js"></script>
+<script>
+
+  $(function(){
+    
+    var $container = $('#container');
+    
+    {% include random-sizes.js %}
+    
+    var colors = ['red', 'green', 'blue', 'yellow', 'purple', 'orange', 'white'],
+        colorI = 0;
+
+    function changeBGColor() {
+      var color = colors[ colorI % colors.length ];
+      $container.css({ background: color })
+      colorI++;
+    }
+
+    function lmk() {
+      // console.log('callback still works');
+    }
+
+    $container.isotope({
+      itemSelector : '.element',
+      onLayout: changeBGColor,
+      masonry : {
+        columnWidth : 120
+      },
+      masonryHorizontal : {
+        rowHeight: 120
+      },
+      cellsByRow : {
+        columnWidth : 240,
+        rowHeight : 240
+      },
+      cellsByColumn : {
+        columnWidth : 240,
+        rowHeight : 240
+      },
+      getSortData : {
+        symbol : function( $elem ) {
+          return $elem.attr('data-symbol');
+        },
+        category : function( $elem ) {
+          return $elem.attr('data-category');
+        },
+        number : function( $elem ) {
+          return parseInt( $elem.find('.number').text(), 10 );
+        },
+        weight : function( $elem ) {
+          return parseFloat( $elem.find('.weight').text().replace( /[\(\)]/g, '') );
+        },
+        name : function ( $elem ) {
+          return $elem.find('.name').text();
+        }
+      }
+    }, lmk );
+      
+
+    var $optionSets = $('#options .option-set'),
+        $optionLinks = $optionSets.find('a');
+    
+    $optionLinks.click(function(){
+      var $this = $(this);
+      // don't proceed if already selected
+      if ( $this.hasClass('selected') ) {
+        return false;
+      }
+      var $optionSet = $this.parents('.option-set');
+      $optionSet.find('.selected').removeClass('selected');
+      $this.addClass('selected');
+
+      // make option object dynamically, i.e. { filter: '.my-filter-class' }
+      var options = {},
+          key = $optionSet.attr('data-option-key'),
+          value = $this.attr('data-option-value');
+      // parse 'false' as false boolean
+      value = value === 'false' ? false : value;
+      options[ key ] = value;
+      if ( key === 'layoutMode' && typeof changeLayoutMode === 'function' ) {
+        // changes in layout modes need extra logic
+        changeLayoutMode( $this, options )
+      } else {
+        // otherwise, apply new options
+        $container.isotope( options, lmk );
+      }
+      
+      return false;
+    });
+
+
+
+    $('#insert a').click(function(){
+      var $newEls = $( fakeElement.getGroup() );
+      $container.isotope( 'insert', $newEls, lmk );
+
+      return false;
+    });
+
+    $('#append a').click(function(){
+      var $newEls = $( fakeElement.getGroup() );
+      $container.append( $newEls ).isotope( 'appended', $newEls, lmk );
+
+      return false;
+    });
+
+
+    // change size of clicked element
+    $container.delegate( '.element', 'click', function(){
+      $(this).toggleClass('large');
+      $container.isotope( 'reLayout', lmk );
+    });
+
+    // toggle variable sizes of all elements
+    $('#toggle-sizes').find('a').click(function(){
+      $container
+        .toggleClass('variable-sizes')
+        .isotope( 'reLayout', lmk );
+      return false;
+    });
+
+
+    var $sortBy = $('#sort-by');
+    $('#shuffle a').click(function(){
+      $container.isotope( 'shuffle', lmk );
+      $sortBy.find('.selected').removeClass('selected');
+      $sortBy.find('[data-option-value="random"]').addClass('selected');
+      return false;
+    });
+    
+  });
+</script>

jquery.isotope.js

@@ -1,5 +1,5 @@
 /**
- * Isotope v1.5.09
+ * Isotope v1.5.10
  * An exquisite jQuery plugin for magical layouts
  * http://isotope.metafizzy.co
  *
@@ -624,6 +624,7 @@
             this.isUsingJQueryAnimation ? 'animate' : 'css'
           ),
           animOpts = this.options.animationOptions,
+          onLayout = this.options.onLayout,
           objStyleFn, processor,
           triggerCallbackNow, callbackFn;
 
@@ -640,9 +641,11 @@
           obj.$el[ objStyleFn ]( obj.style, animOpts );
         };
         
-      } else if ( callback ) {
+      } else if ( callback || onLayout || animOpts.complete ) {
         // has callback
         var isCallbackTriggered = false,
+            // array of possible callbacks to trigger
+            callbacks = [ callback, onLayout, animOpts.complete ],
             instance = this;
         triggerCallbackNow = true;
         // trigger callback only once
@@ -650,7 +653,13 @@
           if ( isCallbackTriggered ) {
             return;
           }
-          callback.call( instance.element, $elems );
+          var hollaback;
+          for (var i=0, len = callbacks.length; i < len; i++) {
+            hollaback = callbacks[i];
+            if ( typeof hollaback === 'function' ) {
+              hollaback.call( instance.element, $elems );
+            }
+          }
           isCallbackTriggered = true;
         };