Snapshot of Rich-Harris/ramjet: 5.4k★, JavaScript, UI / UX. Morph DOM elements from one state to another with smooth animations and transitions
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
<div id='a' style='background-color: red; font-size: 4em; padding: 1em;'>a</div>
<div id='b' style='background-color: blue; font-size: 4em; padding: 1em;'>b</div>
<script src='ramjet.js'></script>
<script>
var element1 = document.getElementById('a'),
element2 = document.getElementById('b');
// to repeat, run this from the console!
ramjet.transform( element1, element2 );
</script>
Okay, so... what does this do?
Ramjet makes it look like your DOM elements are capable of transforming into one another. It does this by cloning the elements (and all their children), transforming the second element (the one we're transforming to) so that it completely overlaps with the first, then animating the two elements together until the first element (the one we're transitioning from) has exactly the same position and dimensions as the second element originally did.
It's basically the same technique used in iOS 8 to make it appear as though each app lives inside its icon.
In modern browsers, it uses CSS animations, so everything happens off the main thread. The result is buttery-smooth performance, even on mobile devices.
API
ramjet.transform( a, b[, options] )
a is the DOM node we're transitioning from
b is the DOM node we're transitioning to
options can include the following properties:
done - a function that gets called once the transition completes
duration - the length of the transition, in milliseconds (default 400)
easing - a function used to control the animation. Should take a number between 0 and 1, and return something similar (though it can return a number outside those bounds, if you're doing e.g. an elastic easing function). I highly recommend eases by Matt DesLauriers, which is a handy collection of these functions
easingScale - if defined it will use a different easing function for scaling. It can be used to create cartoonish effects.
useTimer - by default, ramjet will use CSS animations. Sometimes (when transitioning to or from SVG elements, or in very old browsers) it will fall back to timer-based animations (i.e. with requestAnimationFrame or setTimeout). If you want to always use timers, make this option true - but I don't recommend it (it's much more juddery on mobile)
overrideClone (advanced) - look at the section Advanced options
appendToBody (advanced) - look at the section Advanced options
ramjet.hide( ...nodes )
Convenience function that sets the opacity of each node to 0 (temporarily disabling any transition that might otherwise interfere).
A handful of easing functions, included for convenience.
Browser support
Successfully tested in IE9+, Chrome (desktop and Android), Firefox, Safari 6+ and mobile Safari - please raise an issue if your experience differs!
Developing and testing
Once you've cloned this repo and installed all the development dependencies (npm install), you can start a development server by running npm start and navigating to localhost:4567. Any changes to the source code (in the src directory) will be immediately reflected, courtesy of gobble.
To build, do npm run build.
Reliable automated tests of a library like ramjet are all but impossible. Instead npm test will start the development server and navigate you to localhost:4567/test.html, where you can visually check that the library behaves as expected.
Advanced options
The option overrideClone (function) overrides the function used to clone nodes (the default implementation uses a simple node.cloneNode()). It takes as a parameters the current node and the depth of this node compared to the original element (it is called recursively on the node subtree). It can be useful for removing annoying attributes or children from the cloned node. For example if a node contains a video element with autoplay, this can be excluded because it may be heavy to animate and you can heard the audio of it. Examples:
// cloning only the root node
ramjet.transform( element1, element2, {
overrideClone: function (node, depth){
if (depth == 0){
return node.cloneNode(); // copy only the root node
}
}
});
// cloning everything but the id attribute
ramjet.transform( element1, element2, {
overrideClone: function (node, depth){
var clone = node.cloneNode();
clone.removeAttr('id');
}
});
// not cloning the video element
ramjet.transform( element1, element2, {
overrideClone: function (node, depth){
if (node.nodeType === 1 && node.tagName === "VIDEO"){
return;
}
return node.cloneNode();
}
});
By default the cloned nodes are appended to the parent to the original node. Inheriting the positioning and css inherited rules, they can behave in an unexpected way. For this reason you can use the flag appendToBody to append these nodes to the body instead. I invite everyone to set this to true and open an issue if it doesn't work, it may become the default in one of the next releases.
Yes — Rich-Harris/ramjet ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/Rich-Harris/ramjet.
What else is in the UI / UX space?
Rich-Harris/ramjet is tracked by TopGit under the UI / UX category, alongside 6 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is Rich-Harris/ramjet?
Rich-Harris/ramjet (Rich-Harris/ramjet) is a JavaScript project on GitHub. From the project's own README: Morph DOM elements from one state to another with smooth animations and transitions
What license does Rich-Harris/ramjet use?
Rich-Harris/ramjet is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where can I see Rich-Harris/ramjet in action?
The project maintains a homepage at http://www.rich-harris.co.uk/ramjet/. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about Rich-Harris/ramjet?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/Rich-Harris/ramjet is the definitive source.
Why is Rich-Harris/ramjet categorized under UI / UX?
TopGit places Rich-Harris/ramjet in the UI / UX category based on its GitHub topics and description (tagged: "animation", "css", "dom"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Still deciding about ramjet?
One click hands the question to an AI along with this page — see what it says about ramjet.