https://github.com/char2sgu/layout-projection

Beautify the Web with awesome layout animations
https://github.com/char2sgu/layout-projection

angular animation framer-motion javascript layout-projection react typescript web

Last synced: 17 days ago
JSON representation

Beautify the Web with awesome layout animations

• Host: GitHub
• URL: https://github.com/char2sgu/layout-projection
• Owner: Char2sGu
• License: apache-2.0
• Created: 2023-03-17T18:05:31.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-06-03T03:34:31.000Z (6 months ago)
• Last Synced: 2024-10-22T01:01:50.113Z (27 days ago)
• Topics: angular, animation, framer-motion, javascript, layout-projection, react, typescript, web
• Language: TypeScript
• Homepage: https://char2sgu.github.io/layout-projection/
• Size: 3.12 MB
• Stars: 9
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Layout Projection

**_Beautify the Web with awesome layout animations_**

Framework-agnostic **Layout Projection** and **Layout-Projection-powered** layout animation implementations with exquisite adapters for various frameworks.

# Getting Started

- [Getting started](https://char2sgu.github.io/layout-projection/)

- [Getting started with Angular](./packages/angular/README.md)

# What is it?

Layout animations have always been a challenge for web developers, especially when it comes to implementing advanced layout animations like shared-element transitions.

To address this issue, [Matt Perry](https://github.com/mattgperry) invented Layout Projection, which is a Web animation technique making it possible to implement GPU-accelerated layout animations in the Web platform by calculating and applying appropriate CSS `transform` styles on elements in each animation frame.

> Checkout [Inside Framer Motion's Layout Animations - Matt Perry](https://www.youtube.com/watch?v=5-JIu0u42Jc) for more details.

Matt Perry heavily applied the Layout Projection technique in [Framer Motion](https://www.framer.com/motion/), a well-known React animation library. Unfortunately, this left out web developers who don't use React.

Therefore, here we offer a **framework-agnostic** implementation of Layout Projection with a variety of framework adapters to enable all web developers to enhance their applications with layout animations!

# Why not FLIP?

[FLIP (First Last Invert Play)](https://aerotwist.com/blog/flip-your-animations/) is also a technique for performing layout animations using CSS `transform`s, where the elements are also `transform`ed to pretend that they are in their previous layout and then animated back to their new layouts.

However, instead of calculating `transform`s for both the element and its children and update the `transform` styles in each animation frame, FLIP simply apply a `transition` for the `transform` property and removes the entire `transform` style to animate the element, which would cause severe distortion on the child elements if the aspect ratio of the element is changed.

Layout Projection, in the other hand, perfectly prevented the distortion by animating the element frame by frame and applying a distortion-cancelling `transform` to all the child elements in each animation frame, enabling more advanced layout animations like container transforms.

# Special Thanks

Big thank to [@taowen](https://github.com/taowen) for providing [the GitHub Gist copy](https://gist.github.com/taowen/e102cf5731e527cb9ac02574783c4119) of the missing original blog by Matt Perry about the tech details of Layout Projection.