humanmade/lottie-lite

A lightweight Lottie Animations Extension for WordPress

1.2.7 2024-10-21 10:40 UTC

Requires

• composer/installers: ^1 || ^2

GPL-2.0-or-later

• Human Made Limited

README

Adds support for Lottie animations as an enhancement to the following blocks:

• Core image block
• Core cover block
• Core media & text block

Allows overlaying or replacing the image with an animation.

Installation

1. Download the plugin from the GitHub repository.
2. Upload the plugin to your site's wp-content/plugins directory.
3. Activate the plugin from the WordPress admin.

Advanced Usage

The plugin exposes the DotLottie web player object on the enhanced blocks. This allows you to interact with the player and control the animation.

To access the player object, you can use the following JavaScript code:

function doStuff(player) {
    // Do stuff with the player object
}

// Wait for the player to be ready as they may be loaded asynchronously,
// depending on the block's visibility and whether the image is lazy-loaded.
document.querySelectorAll( '[data-lottie]' ).forEach( ( element ) => {
    if ( element.lottie ) {
        doStuff( element.lottie );
    } else {
        element.addEventListener( 'lottieReady', () => {
            doStuff( element.lottie );
        } );
    }
} );

Full documentation for the DotLottie web player can be found here:

https://developers.lottiefiles.com/docs/dotlottie-player/dotlottie-web/