Freezeframe.js is a library that pauses animated .gifs and enables them to animate on mouse hover / mouse click / touch event, or triggered manually.
Version 4+ is built with modern javascript in mind. It's transpiled with webpack/babel, so it should work in most environments, but we are no longer supporting the jquery plugin.
If you want to use freezeframe as a jquery plugin, check out freezeframe v3.0.10.
This is a lerna.js monorepo, containing the following packages:
To get started with freezeframe, head over to the core freezeframe package.
To use freezeframe with Vue.js, check out vue-freezeframe.
For the curious, we are able to pause animated gifs by writing their data to a canvas element. Only the first frame of the animation can be written to the canvas, so we now have a frozen version of the gif.
- Fork or clone the repository.
- Install lerna
npm install -g lerna- Install the monorepo dependencies
npm install- Install the sub-package dependencies
lerna bootstrap --hoist- Run tests for all sub-packages
npm test- If you are part of the ctrl-freakz organization, you can publish directly to npm:
lerna publishOtherwise, submit your PR for review.
freezeframe.js is released under the terms of the MIT License.