⚠️ This tutorial uses an old version of Ember. Some things might have changed!
Liquid Fire is a library created by Edward Faulkner which makes it easy to add beautiful animations to your Ember app. It fits in very well with Ember's philosophy of adhering to certain conventions in order to gain efficiency.
A simple jQuery-like "slideDown"-animation for the error message that we created in the last chapter
Transitions between our routes
Showing and hiding things
Let's start by installing Liquid Fire. Since it's an Ember Addon, this is very easy as usual:
Don't forget that after installing an addon, you need to restart the server so that Ember can track the changes to the file system. Next, simply open up the index-template we worked on in the previous chapter and change the if-statement into a liquid-if:
Route transitions
Another awesome thing you can do with Liquid Fire is route transitions: animations between pages and subroutes.
In our app, we're going to try this out on the profile page's subroutes. Although, in my opinion, the animation doesn't quite fit this project, so we will remove it afterwards, but at least you will see how to implement it for future projects!
First, we'll change the {{outlet}}
tag near the end of the template-file into a {{liquid-outlet}}
in order to indicate that we want to animate between the routes that reside in this outlet.
The next step is to create a transitions.js-file in the app-folder, and in it we'll define which animations to use between our routes.
You can play around with this by adding transitions to your other routes as well if you want (don't forget to change your outlets into liquid-outlets in that case)! The Liquid Fire website contains a list of all the predefined animations that you can use.
Bonus: exploding transitions!
We saved the best for last. What if you could move an element across the page from one route to another? This would be quite a pain to implement manually in JavaScript and CSS, but once again, Liquid Fire makes this easy!
Since this is an animation between two top-level routes, we need to turn the {{outlet}}
in the application template into a {{liquid-outlet}}
first:
After doing this, you might notice that the whole container on the home page seems to have got some extra margin on the top:
This is because {{liquid-outlet}}
adds some extra elements in order to facilitate the transitions, which can sometimes screw up your layout. Keep this is mind when converting your regular outlets. In this case though, it's easily fixable: just comment out one line of CSS in the file app/styles/layout.scss
:
Now back to the transition! Let's open up the app/transitions.js
-file again and add the following animation right after the previous one:
useAndReverse
simply tells Liquid Fire that we want to use the same animation both from home to profile and from profile to home. What's especially new here is the matchBy
-key. This will search for an HTML-element that has the same value for the attribute data-profile-image
and, if it finds it both on the home page and the profile page, it will apply the fly-to
animation to it during the transition!
Right now, our image elements that we want to match don't contain this attribute, so let's add it! We're going to set the value of the attribute to "me", but it could be anything as long as they both match!
That's it! Now go back to the browser and click away!
Liquid Fire is one of those libraries that really demonstrate what you can do when you adopt a framework that emphasises the importance of conventions. Because routes and templates defined in Ember work in a certain way, it's very easy to augment their functionality with addons like this!
In the next chapter, we will focus more on functionality by creating the chirp modal that allows the user to post new chirps!
Comments
You need a Ludu account in order to ask the instructor a question or post a comment.
After i installed liquid-fire i have this error: Merge error: file app/styles/app.scss exists in /Users/.../my-app/tmp/broccoli_merge_trees-input_base_path-67oIJUtm.tmp/20 and /Users/.../my-app/tmp/broccoli_merge_trees-input_base_path-67oIJUtm.tmp/22<pre>Pass option { overwrite: true } to mergeTrees in order to have the latter file win. Current versions: liquid-fire: 0.21.3, ember: 1.13.12 node: 0.12.7 npm: 2.14.10 os: darwin x64 </pre><pre> </pre>
had to delete "node_modules/liquid-fire-app/styles/app.scss"
Known issue with a merge made today. Likely will be fixed in next release. https://github.com/ef4/liquid-fire/issues/389
Worked beautifully, thanks Gabor. Anyone else getting this warning at this stage? [Deprecated] new this.Funnel(..) is deprecated, please use broccoli-funnel directly instead [addon: liquid-fire]
app/transitions.js is installed with liquid-fire, doesn't need to be created
Since introducing Liquid Fire it has affected some of the layouts. The home page background image is limited to roughly half of the page height and the aside on the home page has been repositioned partially over the top of the chirp stream. Looking in the inspector I have isolated the "problem" to the "liquid-container"class which I presume is created because the route is a liquid transition. If I remove the "liquid-container" style from the DOM then the layout returns to normal.
The predefined animations link seems to have changed to this: http://ember-animation.github.io/liquid-fire/#/transitions/predefined
wasn't able to get this liquid fire animation working - no js errors though