turnero-ember-masonry-grid
v0.4.1
Published
Quickly and easily add masonry layouts to your app.
Downloads
3
Maintainers
Readme
ember-masonry-grid
This ember-cli
addon imports the Masonry library and allows you to quickly and easily build masonry grid views.
Installation
ember install:addon ember-masonry-grid
That's it! The Masonry library will automatically be imported in your app, and the masonry-grid
component will be available to all of your templates.
masonry-grid
The masonry-grid
component accepts all of the options that Masonry
exposes. The naming is the same, and any option not specified will use the Masonry
default.
For example, if we wanted to a basic Masonry
view, we'd included the following in our template.
{{#masonry-grid}}
<div class="item">Item 1</div>
<div class="item">Item 2</div>
<div class="item">Item 3</div>
{{/masonry-grid}}
If we wanted to redefine the item
class for Masonry
, we'd write the following:
{{#masonry-grid itemSelector=".piece"}}
<div class="piece">Item 1</div>
<div class="piece">Item 2</div>
<div class="piece">Item 3</div>
{{/masonry-grid}}
For a full list of options that are exposed, please see the Masonry options.
A small caveat: while Ember allows us to pass most options to components as primitives, it doesn't handle null
well. If you'd like to use null
(as containerStyle
, for example), you'll have to wrap it in quotes ('null'
).
Adding and Removing Items from a Masonry Layout
We can specify an items
attribute that ember-masonry-grid
will observe. When the property changes, Masonry will re-initalize itself and update its layout.
For example, if our controller exposes the enumerable property colors
:
{{#masonry-grid items=colors}}
{{#each colors}}
<div class="item">
Name: {{name}}
</div>
{{/each}}
{{/masonry-grid}}
Every time the length of the colors
property is changed, Masonry will account for it and generate a new layout.
Contributing
If you find an issue or missing functionality, please don't hesistate to open a pull request.
Installation
git clone
this repositorynpm install
bower install
Running
ember server
- Visit your app at http://localhost:4200.
Running Tests
npm test
Building
ember build
For more information on using ember-cli, visit http://www.ember-cli.com/.