ember-css-transitions

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:

• IE 10
• IE 11
• Microsoft Edge
• Chrome
• Firefox
• Safari
• Android
• iPhone

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

Linting

• npm run lint:js
• npm run lint:js -- --fix

Running tests

• ember test – Runs the test suite on the current Ember version
• ember test --server – Runs the test suite in "watch mode"
• ember try:each – Runs the test suite against multiple Ember versions

Running the dummy application

• ember serve
• Visit the dummy application at http://localhost:4200.

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

License

This project is licensed under the MIT License.