Skip to content
/ taos Public

Tailwind CSS Animation on Scroll - A simple and small (600 bytes) library to help animate elements while scrolling using responsive Tailwind CSS JIT utility classes.

License

Notifications You must be signed in to change notification settings

versoly/taos

Repository files navigation

Tailwind CSS Animation on Scroll - A simple and small (600 bytes) library to help animate elements while scrolling using responsive Tailwind CSS utility classes. React & Vue supported.

Discord Licenese brotli bundle size


Versoly - Tailwind page builder


Table of Contents

Demo

To view 20+ examples of TAOS in action go to versoly.com/taos.

Getting started

TAOS can be included as a plugin into an existing Tailwind CSS project and will allow you to add responsive Tailwind CSS utility classes for animation on scroll.

Installation

Install the plugin from npm:

npm install taos --save

Then add to your main style.css file:

@custom-variant taos (&.taos-init:where(:not(.taos-animate)));

html.js :where([class*="taos:"]:not(.taos-init)) {
  visibility: hidden;
}

@source inline('!duration-[0ms] !delay-[0ms]');

If you are still using Tailwind CSS v3, add the plugin and safelist classes to your tailwind.config.js file:

// tailwind.config.js
module.exports = {
  theme: {
    // ...
  },
  plugins: [
    // ...
    require('taos/plugin'),
  ],
  safelist: [
    '!duration-[0ms]',
    '!delay-[0ms]',
    'html.js :where([class*="taos:"]:not(.taos-init))',
  ]
}

Add JavaScript scripts

Add the CDN script or download and paste before the closing </body> tag

  <script src="https://unpkg.com/taos@1.0.5/dist/taos.js"></script>
</body>

Add script in <head>

  <script>document.documentElement.classList.add('js')</script>
</head>

TAOS Frequently Asked Questions

Why do you use MutationObserver instead of IntersectionObserver

MutationObserver is a cleaner solution to check if the element is in view on page load and refresh. With IntersectionObserver it would require more code on top just to handle that part.

JS Frameworks

Inspiration

  • AOS: is a great library and works by using custom classes such as aos-animate to animate elements.
  • Tailwind: created an easy to use utility library that is easily extendable and flexible. Their variant and just in time compiler changed the game for developers.

Community

If you need help or just want to discuss about the library join the community on Github:

Discuss about Versoly on GitHub

For casual chatting with others using the library:

Join the Versoly Discord Server

About

Tailwind CSS Animation on Scroll - A simple and small (600 bytes) library to help animate elements while scrolling using responsive Tailwind CSS JIT utility classes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published