@bdspark/sparkng-motion

Motion and animation utilities for SparkNG.

This package provides a programmatic way to manage CSS transitions and animations within the SparkNG ecosystem. It offers a robust API for controlling motion lifecycles, handling dynamic dimensions, and ensuring accessibility.

Features

• Programmatic Motion: Create and control motion instances for any DOM element.
• Lifecycle Hooks: Comprehensive hooks for before, start, after, and cancelled stages of both enter and leave phases.
• Auto-Dimensions: Built-in support for smoothly animating to/from auto height and width.
• Accessibility: Respects user's prefers-reduced-motion settings out of the box.
• Configurable: Flexible options for durations, easing types, and custom CSS class names.
• Lightweight: Zero dependencies (other than internal utilities) and optimized for performance.

Installation

npm install @bdspark/sparkng-motion

Core Concepts

createMotion

The primary entry point to create a motion instance for a target element.

import { createMotion } from '@bdspark/sparkng-motion';

const motion = createMotion(element, {
    name: 'my-fade',
    enter: true,
    leave: true
});

// Trigger phases
await motion.enter();
await motion.leave();

Motion Options

Fine-tune the behavior with detailed configuration:

• name: Base prefix for CSS classes (e.g., p- -> p-enter-active).
• duration: Control timing for enter and leave phases independently.
• autoHeight / autoWidth: Enable automatic dimension calculation for smooth transitions to variable content sizes.
• hooks: Attach logic to specific points in the animation timeline.

Lifecycle Hooks

Stay in sync with your animations:

• onBeforeEnter / onBeforeLeave
• onEnter / onLeave
• onAfterEnter / onAfterLeave

Usage in SparkNG

This package is a core dependency of @bdspark/sparkng, powering the animations found in overlays, transitions, and interactive components. It can also be used independently to add standard-compliant motion to custom Angular components.

License

MIT