Ember CSS Transitions

This addon provides a nice way of defining CSS Transitions for Ember Components. Which means, only css based animations for performance - and no animation library needed.

Ember CSS Transitions is heavily inspired (and CSS compatible) with:

React's CSS Transitions (the implementation is mostly based on React)
Angular's CSS Transitions

Animations are completely based on CSS classes. As long as you have a CSS class attached to a HTML element, you can apply animations to it.

Documentation

http://peec.github.io/ember-css-transitions/

How it works

Utimately you define your animations and transitions with ONLY CSS.

.example-enter {
  opacity: 0.01;
}

.example-enter.example-enter-active {
  opacity: 1;
  transition: opacity .5s ease-in;
}
.example-leave {
  opacity: 1;
}

.example-leave.example-leave-active {
  opacity: 0.01;
  transition: opacity .5s ease-in;
}

Animating insert and destroy

There are two ways of defining enter/leave transitions, If you use the {{transition-group}} component you can then do something like this ( there is also a mixin you can use for custom components):

{{#if shouldShowThis}}
  {{#transition-group transitionName="example"}}
    This is animated in.
  {{/transition-group}}
{{/if}}

ember-css-transitions will automatically manage the lifecycle of the css classes applied so that it makes the animation on didInsertElement and willDestroyElement. It adds yourclass-enter suffix and yourclass-enter-active when didInsertElement is applied. The same happens in willDestroyElement using yourclass-leave and yourclass-leave-active.

Animating class add/removal

Apart from the insert/destroy hooks for transitions, there is also an optional transitionClassNameBindings array that has the same syntax as classNameBindings, but also adds *-add, *-add-active, *-remove and *-remove-active to the classes that you specify based on their transition time.

transitionClassNameBindings: ['isOpen', 'pinned:is-pinned']

The above example will add the other classes for the two base classes, i.e. .is-open and .is-pinned.

For more examples and docs, see: http://peec.github.io/ember-css-transitions/

Install

Run:

ember install ember-css-transitions

Note Installing ember-cli-autoprefixer is suggested for CSS transitions:

ember install ember-cli-autoprefixer

Tested in the following browsers / platforms:

Note: IE9 does not support CSS3 transitions / animations. They must live with no animations / transitions.

Contribute

git clone <repository-url> this repository
cd my-addon
npm install

Running

ember serve
Visit your app at http://localhost:4200.

Running Tests

npm test (Runs ember try:each to test your addon against multiple Ember versions)
ember test
ember test --server

Building

ember build

For more information on using ember-cli, visit https://ember-cli.com/.

billpull / ember-css-transitions Goto Github PK