liquid-fire

    0.31.0 • Public • Published

    Liquid Fire

    Comprehensive animation support for ambitious Ember applications. Interactive Documentation is here.

    Features

    • Animated transitions between routes that work seamlessly with the Ember router.

    • A DSL for laying out your spatial route relationships, cleanly separated from view-layer implementation details.

    • Animated transitions between models within a single route.

    • Animated transitions between individual scalar values within a template.

    • Promise-driven API to control your animation flow.

    • Backed by velocity.js, but easy to extend to other animation drivers if there's interest.

    Ember Compatibility Table

    The latest version of Liquid Fire works with Ember versions back to 2.12.

    For older versions, you can pick one of these older Liquid Fire releases:

    Ember Version Liquid Fire Release
    2.12 and newer latest
    1.13 through 2.11 0.29.x
    1.11 through 1.12 0.19.x
    1.8 through 1.10 0.17.x

    This is an ember-cli addon, so all you need is an npm install. For Ember 1.13 or newer, use:

    ember install liquid-fire
    

    For older ember versions, consult the compatibility table above to pick the right liquid-fire version and then install with one of these:

    ember install liquid-fire@^0.17.0
    ember install liquid-fire@^0.19.0
    

    Documentation

    Liquid Fire website is an ember-cli application that contains an interactive demo & documentation. It runs from Liquid Fire's test dummy app.

    You can also see some examples in my Ember Animation Demo repo, and this video presentation from the Boston Ember Meetup.

    Development

    Source Organization

    This repo contains both the liquid-fire library and a demo application that presents interactive documentation. It follows standard ember-cli addon format.

    • app: is code that's loaded directly into the user's application
    • addon: is code that can be imported by the user from the liquid-fire namespace
    • tests/dummy: is the testing, demo, and documentation application

    Testing

    When running tests you'll want to set your transition speeds to 0 so they don't slow down your tests. This can be accomplished by using an Environment variable.

    // Import the Environment
    import ENV from "your-application-name/config/environment";
     
    // If Testing Environment
    if (ENV.environment === "test") {
      var customDuration = 0; // set to 0 seconds
    } else {
      var customDuration = 200; // set to 200 miliseconds
    }
     
    this.transition(
      this.toRoute("foo"),
      this.use("toLeft", { duration: customDuration }) // Use customDuration
    );

    Keywords

    Install

    npm i liquid-fire

    DownloadsWeekly Downloads

    35,516

    Version

    0.31.0

    License

    MIT

    Unpacked Size

    110 kB

    Total Files

    102

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar