Browse Source

src : add onLayout option

add docs and test
pull/150/head v1.5.10
David DeSandro 13 years ago
parent
commit
cae4ab2db2
  1. 10
      _posts/docs/2010-12-03-options.mdown
  2. 170
      _posts/tests/2012-02-07-onlayout.html
  3. 15
      jquery.isotope.js
  4. 4
      jquery.isotope.min.js

10
_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">

170
_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>

15
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;
};

4
jquery.isotope.min.js vendored

File diff suppressed because one or more lines are too long
Loading…
Cancel
Save